X-insights

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "comment_id",
    "post_id"
  ],
  "properties": {
    "post_id": {
      "type": "string",
      "description": "X 帖子 ID；用户已提供时直接使用，否则请原样复制获取一级评论时使用的 post_id，或评论列表 items[*].post_id；必须是数字字符串；不要传评论 ID、帖子链接、用户名或分享文案。"
    },
    "comment_id": {
      "type": "string",
      "description": "X 一级评论 ID；用户已提供时直接使用，否则请原样复制 x_get_post_comments_by_post_id 或 x_get_post_comments_by_post_url 返回的 items[*].comment_id；不要传帖子 ID、评论回复结果里的 items[*].comment_id、评论链接、用户主页链接或分享文案。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "X 评论回复列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一帖子下同一条一级评论的回复列表；切换 post_id 或 comment_id 时请清空 page_token 后从第一页重新获取。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "post_id"
  ],
  "properties": {
    "post_id": {
      "type": "string",
      "description": "X 帖子 ID；用户已提供时原样使用，否则可从搜索结果、详情结果、quoted_post、reposted_post 或用户帖子列表结果复制 post_id；必须是数字字符串；不要传帖子链接、用户名、评论 ID 或分享文案。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "X 帖子评论列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一帖子评论列表；切换到其他帖子时请清空 page_token 后从第一页重新获取。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "post_url"
  ],
  "properties": {
    "post_url": {
      "type": "string",
      "description": "X 帖子链接；仅在没有 post_id 时，请传搜索结果、详情结果、quoted_post 或 reposted_post 返回的非空 post_url，或用户帖子列表结果返回的非空 post_url，或形如 https://x.com/{username}/status/{post_id} 的 x.com 或 twitter.com 帖子页面链接；不要传用户主页链接、评论链接、帖子正文里的链接、搜索关键词或接口地址。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "X 帖子评论列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一帖子评论列表；切换到其他帖子时请清空 page_token 后从第一页重新获取。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "post_id"
  ],
  "properties": {
    "post_id": {
      "type": "string",
      "description": "X 帖子 ID；用户已提供时原样使用，否则可从搜索结果、详情结果、quoted_post、reposted_post 或用户帖子列表结果复制 post_id；必须是数字字符串；不要传帖子链接、用户名或分享文案。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "post_url"
  ],
  "properties": {
    "post_url": {
      "type": "string",
      "description": "X 帖子链接；仅在没有 post_id 时，请传搜索结果、详情结果、quoted_post 或 reposted_post 返回的非空 post_url，或用户帖子列表结果返回的非空 post_url，或形如 https://x.com/{username}/status/{post_id} 的 x.com 或 twitter.com 帖子页面链接；不要传用户主页链接、帖子正文里的链接、搜索关键词或接口地址。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "profile_url"
  ],
  "properties": {
    "profile_url": {
      "type": "string",
      "description": "X 用户主页链接；从搜索、详情、评论或评论回复结果的非空 author.profile_url，或用户帖子列表结果的非空 author.profile_url，或用户信息结果的非空 profile_url 原样复制；也可传用户提供的 x.com 或 twitter.com 用户主页链接；不要传帖子链接、评论链接、帖子正文里的链接、搜索关键词或接口地址。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "user_id"
  ],
  "properties": {
    "user_id": {
      "type": "string",
      "description": "X 用户稳定数字 ID；用户已提供时原样使用，否则可从搜索、详情、评论或评论回复结果的非空 author.user_id、用户帖子列表结果的非空 author.user_id，或用户信息结果的非空 user_id 原样复制；必须是数字字符串；不要传用户名、用户主页链接、帖子链接或分享文案。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "username": {
      "type": "string",
      "description": "X 用户名；推荐从搜索、详情、评论或评论回复结果的非空 author.username，或用户帖子列表结果的非空 author.username，或用户信息结果的非空 username 原样复制，该值不带 @；如果用户给的是 @username 也可以传；不要传用户主页链接、帖子链接或分享文案。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "profile_url"
  ],
  "properties": {
    "page_token": {
      "type": "string",
      "default": "",
      "description": "X 用户帖子列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户帖子列表；切换 user_id、username 或 profile_url 时请清空 page_token 后从第一页重新获取。"
    },
    "profile_url": {
      "type": "string",
      "description": "X 用户主页链接；从搜索、详情、评论或评论回复结果的非空 author.profile_url，或用户帖子列表结果的非空 author.profile_url，或用户信息结果的非空 profile_url 原样复制；也可传用户提供的 x.com 或 twitter.com 用户主页链接；不要传帖子链接、评论链接、帖子正文里的链接、搜索关键词或接口地址。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "user_id"
  ],
  "properties": {
    "user_id": {
      "type": "string",
      "description": "X 用户稳定数字 ID；用户已提供时原样使用，否则可从搜索、详情、评论或评论回复结果的非空 author.user_id、用户帖子列表结果的非空 author.user_id，或用户信息结果的非空 user_id 原样复制；必须是数字字符串；不要传用户名、用户主页链接、帖子链接或分享文案。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "X 用户帖子列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户帖子列表；切换 user_id、username 或 profile_url 时请清空 page_token 后从第一页重新获取。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "username": {
      "type": "string",
      "description": "X 用户名；推荐从搜索、详情、评论或评论回复结果的非空 author.username，或用户帖子列表结果的非空 author.username，或用户信息结果的非空 username 原样复制，该值不带 @；如果用户给的是 @username 也可以传；不要传用户主页链接、帖子链接或分享文案。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "X 用户帖子列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户帖子列表；切换 user_id、username 或 profile_url 时请清空 page_token 后从第一页重新获取。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "job_id"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "description": "口播转文字任务 ID；用户已提供时直接使用，否则使用 x_submit_video_speech_text_by_post_url 或 x_submit_video_speech_text_by_post_id 返回的 job_id；任务未完成时继续原样传入同一个 job_id，不要重复提交。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "keyword"
  ],
  "properties": {
    "keyword": {
      "type": "string",
      "description": "X / Twitter 帖子搜索词，可传关键词或短语，例如品牌名、话题、人物名或内容需求；不要传帖子链接、用户主页链接、接口地址、post_id、user_id、username 或 page_token。"
    },
    "sort_type": {
      "enum": [
        "hot",
        "time_descending"
      ],
      "type": "string",
      "default": "hot",
      "description": "搜索排序：hot=热门，time_descending=最新；需要 latest/newest sorting 时也传 time_descending。如无明确排序需求，保持 hot。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "X 搜索分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一关键词和同一搜索排序链路；更换关键词或 sort_type 时，请清空 page_token 后从第一页重新搜索。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "post_id"
  ],
  "properties": {
    "post_id": {
      "type": "string",
      "description": "X 帖子 ID；用户已提供时原样使用，否则可从搜索结果、详情结果、quoted_post、reposted_post 或用户帖子列表结果复制 post_id；必须是数字字符串；不要传帖子链接、用户名或分享文案。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "post_url"
  ],
  "properties": {
    "post_url": {
      "type": "string",
      "description": "X 帖子链接；仅在没有 post_id 时，请传搜索结果、详情结果、quoted_post 或 reposted_post 返回的非空 post_url，或用户帖子列表结果返回的非空 post_url，或形如 https://x.com/{username}/status/{post_id} 的 x.com 或 twitter.com 帖子页面链接；不要传用户主页链接、帖子正文里的链接、搜索关键词或接口地址。"
    }
  },
  "additionalProperties": false
}