SocialDataX 今日头条 MCP

读取今日头条热搜榜，返回头条当前热门关键词及上游热度信息。

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

{
  "type": "object",
  "properties": {
    "items": {
      "description": "普通热搜条目。",
      "items": {
        "properties": {
          "rank": {
            "description": "热搜排名，按头条返回顺序生成。",
            "type": "integer"
          },
          "hot_id": {
            "description": "热点 ID。",
            "type": "string"
          },
          "title": {
            "description": "热点标题。",
            "type": "string"
          },
          "keyword": {
            "description": "热点关键词。",
            "type": "string"
          },
          "hot_value": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "热度值；未提供时为 null。"
          },
          "url": {
            "description": "热点链接。",
            "type": "string"
          },
          "cover_image_url": {
            "description": "热点封面图；没有时为空字符串。",
            "type": "string"
          },
          "tag": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "热点标签；没有时省略。"
          },
          "category": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "热点分类；没有时省略。"
          }
        },
        "required": [
          "rank",
          "hot_id",
          "title",
          "keyword",
          "hot_value",
          "url",
          "cover_image_url"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "pinned_items": {
      "description": "平台置顶内容。",
      "items": {
        "properties": {
          "title": {
            "description": "置顶内容标题。",
            "type": "string"
          },
          "url": {
            "description": "置顶内容链接。",
            "type": "string"
          }
        },
        "required": [
          "title",
          "url"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "points": {
      "type": "object",
      "description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
      "properties": {
        "cost": {
          "type": "integer",
          "description": "本次请求最终确认消耗的积分。",
          "minimum": 0
        },
        "balance": {
          "type": "integer",
          "description": "本次接口完成时看到的当前积分余额。",
          "minimum": 0
        }
      },
      "required": [
        "cost",
        "balance"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "items",
    "pinned_items",
    "points"
  ]
}

获取今日头条搜索输入框的联想词；不返回用户或内容详情，不支持分页。

{
  "type": "object",
  "properties": {
    "keyword": {
      "description": "搜索关键词或短语，例如美食、旅行；不要传链接、用户 ID 或 page_token。",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "keyword"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "items": {
      "description": "搜索建议列表；无匹配建议时为空数组。",
      "items": {
        "properties": {
          "text": {
            "description": "搜索输入框联想词。",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "text"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "points": {
      "type": "object",
      "description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
      "properties": {
        "cost": {
          "type": "integer",
          "description": "本次请求最终确认消耗的积分。",
          "minimum": 0
        },
        "balance": {
          "type": "integer",
          "description": "本次接口完成时看到的当前积分余额。",
          "minimum": 0
        }
      },
      "required": [
        "cost",
        "balance"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "items",
    "points"
  ]
}

按关键词查找今日头条用户，返回用户 ID、名称、简介、粉丝数和认证说明，支持分页；已有用户 ID 或主页链接时直接查询用户资料。

{
  "type": "object",
  "properties": {
    "keyword": {
      "description": "用户名称或关键词，例如 NBA、美食；不要传内容链接或用户主页链接。",
      "minLength": 1,
      "type": "string"
    },
    "page_token": {
      "default": "",
      "description": "首次留空；续页原样传入同一用户搜索上一页的 next_page_token，并保持 keyword 不变；不能使用内容搜索令牌。",
      "type": "string"
    }
  },
  "required": [
    "keyword"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "items": {
      "description": "当前页用户列表。",
      "items": {
        "properties": {
          "user_id": {
            "description": "头条数字用户 ID，可用于查询用户资料和作品。",
            "type": "string"
          },
          "name": {
            "description": "用户显示名称。",
            "type": "string"
          },
          "avatar_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "头像链接；未提供时为 null。"
          },
          "profile_url": {
            "description": "头条用户主页链接。",
            "type": "string"
          },
          "bio": {
            "description": "用户简介；未填写时为空字符串。",
            "type": "string"
          },
          "follower_count": {
            "description": "粉丝数。",
            "type": "integer"
          },
          "verification_label": {
            "description": "搜索结果展示的认证或身份说明；本次搜索未提供时为空字符串，不代表账号未认证。",
            "type": "string"
          }
        },
        "required": [
          "user_id",
          "name",
          "avatar_url",
          "profile_url",
          "bio",
          "follower_count",
          "verification_label"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "next_page_token": {
      "description": "下一页完整分页令牌；为空表示结束。",
      "type": "string"
    },
    "points": {
      "type": "object",
      "description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
      "properties": {
        "cost": {
          "type": "integer",
          "description": "本次请求最终确认消耗的积分。",
          "minimum": 0
        },
        "balance": {
          "type": "integer",
          "description": "本次接口完成时看到的当前积分余额。",
          "minimum": 0
        }
      },
      "required": [
        "cost",
        "balance"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "items",
    "next_page_token",
    "points"
  ]
}

读取头条用户资料和主页统计，缩略统计为近似值；已有数字用户 ID 时优先使用本工具，只有主页链接时使用 toutiao_get_user_info_by_profile_url。

{
  "type": "object",
  "properties": {
    "user_id": {
      "description": "头条数字用户 ID，可取搜索或详情的 author.user_id；不要传内容 ID、主页链接或主页标识。",
      "pattern": "^[0-9]+$",
      "type": "string"
    }
  },
  "required": [
    "user_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "user_id": {
      "description": "数字用户 ID，可用于查询用户资料。",
      "type": "string"
    },
    "name": {
      "description": "用户显示名称。",
      "type": "string"
    },
    "avatar_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "用户头像链接；未提供时为 null。"
    },
    "profile_url": {
      "description": "用户主页链接，可用于再次查询用户资料。",
      "type": "string"
    },
    "bio": {
      "description": "用户简介；未填写时为空字符串。",
      "type": "string"
    },
    "verified": {
      "description": "用户是否已认证。",
      "type": "boolean"
    },
    "verification_label": {
      "description": "认证说明；无认证说明时为空字符串。",
      "type": "string"
    },
    "ip_location": {
      "description": "主页显示的 IP 属地；未提供时为空字符串。",
      "type": "string"
    },
    "follower_count": {
      "description": "粉丝数；头条使用万等缩略显示时为换算的近似值。",
      "type": "integer"
    },
    "following_count": {
      "description": "关注数；头条使用万等缩略显示时为换算的近似值。",
      "type": "integer"
    },
    "received_like_count": {
      "description": "累计获赞数；头条使用万等缩略显示时为换算的近似值。",
      "type": "integer"
    },
    "points": {
      "type": "object",
      "description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
      "properties": {
        "cost": {
          "type": "integer",
          "description": "本次请求最终确认消耗的积分。",
          "minimum": 0
        },
        "balance": {
          "type": "integer",
          "description": "本次接口完成时看到的当前积分余额。",
          "minimum": 0
        }
      },
      "required": [
        "cost",
        "balance"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "user_id",
    "name",
    "avatar_url",
    "profile_url",
    "bio",
    "verified",
    "verification_label",
    "ip_location",
    "follower_count",
    "following_count",
    "received_like_count",
    "points"
  ]
}

通过用户主页链接或分享文案读取头条用户资料和主页统计，缩略统计为近似值；同时有数字用户 ID 时优先使用 toutiao_get_user_info_by_user_id。

{
  "type": "object",
  "properties": {
    "profile_url": {
      "description": "头条用户主页链接或包含主页链接的分享文案，可取详情 author.profile_url；不要传内容链接或纯 ID。",
      "pattern": "https?://",
      "type": "string"
    }
  },
  "required": [
    "profile_url"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "user_id": {
      "description": "数字用户 ID，可用于查询用户资料。",
      "type": "string"
    },
    "name": {
      "description": "用户显示名称。",
      "type": "string"
    },
    "avatar_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "用户头像链接；未提供时为 null。"
    },
    "profile_url": {
      "description": "用户主页链接，可用于再次查询用户资料。",
      "type": "string"
    },
    "bio": {
      "description": "用户简介；未填写时为空字符串。",
      "type": "string"
    },
    "verified": {
      "description": "用户是否已认证。",
      "type": "boolean"
    },
    "verification_label": {
      "description": "认证说明；无认证说明时为空字符串。",
      "type": "string"
    },
    "ip_location": {
      "description": "主页显示的 IP 属地；未提供时为空字符串。",
      "type": "string"
    },
    "follower_count": {
      "description": "粉丝数；头条使用万等缩略显示时为换算的近似值。",
      "type": "integer"
    },
    "following_count": {
      "description": "关注数；头条使用万等缩略显示时为换算的近似值。",
      "type": "integer"
    },
    "received_like_count": {
      "description": "累计获赞数；头条使用万等缩略显示时为换算的近似值。",
      "type": "integer"
    },
    "points": {
      "type": "object",
      "description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
      "properties": {
        "cost": {
          "type": "integer",
          "description": "本次请求最终确认消耗的积分。",
          "minimum": 0
        },
        "balance": {
          "type": "integer",
          "description": "本次接口完成时看到的当前积分余额。",
          "minimum": 0
        }
      },
      "required": [
        "cost",
        "balance"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "user_id",
    "name",
    "avatar_url",
    "profile_url",
    "bio",
    "verified",
    "verification_label",
    "ip_location",
    "follower_count",
    "following_count",
    "received_like_count",
    "points"
  ]
}

读取头条用户发布的作品；已有数字用户 ID 时使用本工具，有主页链接时使用按主页链接查询的工具。

{
  "type": "object",
  "properties": {
    "user_id": {
      "description": "头条数字用户 ID，可取用户信息或内容作者的 author.user_id；有主页链接时使用 toutiao_get_user_posts_by_profile_url。",
      "pattern": "^[0-9]+$",
      "type": "string"
    },
    "content_type": {
      "default": "all",
      "description": "作品筛选：all、article、video、micro_post。",
      "enum": [
        "all",
        "article",
        "video",
        "micro_post"
      ],
      "type": "string"
    },
    "page_token": {
      "default": "",
      "description": "上一页返回的分页令牌；首次留空，不能跨用户或作品类型复用。",
      "type": "string"
    }
  },
  "required": [
    "user_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "items": {
      "description": "用户发布的作品列表。",
      "items": {
        "properties": {
          "post_id": {
            "description": "作品 ID。",
            "type": "string"
          },
          "content_type": {
            "description": "作品类型：article、video 或 micro_post。",
            "enum": [
              "article",
              "video",
              "micro_post"
            ],
            "type": "string"
          },
          "title": {
            "description": "作品标题；微头条没有独立标题时为空字符串。",
            "type": "string"
          },
          "content": {
            "description": "文章为列表摘要，微头条为正文，视频通常为空字符串；完整内容请查询作品详情。",
            "type": "string"
          },
          "post_url": {
            "description": "作品链接。",
            "type": "string"
          },
          "publish_time": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "发布时间，秒级 Unix 时间戳；未提供时为 null。"
          },
          "cover_image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "封面图片链接；未提供时为 null。"
          },
          "images": {
            "description": "作品图片；无图片时为空数组。",
            "items": {
              "properties": {
                "url": {
                  "description": "图片链接。",
                  "type": "string"
                },
                "width": {
                  "anyOf": [
                    {
                      "type": "integer"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "图片宽度，像素；未提供时为 null。"
                },
                "height": {
                  "anyOf": [
                    {
                      "type": "integer"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "图片高度，像素；未提供时为 null。"
                }
              },
              "required": [
                "url",
                "width",
                "height"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "video": {
            "anyOf": [
              {
                "properties": {
                  "video_url": {
                    "description": "视频播放链接，有效期有限，建议获取后及时使用。",
                    "type": "string"
                  },
                  "duration_ms": {
                    "description": "视频时长，单位毫秒。",
                    "type": "integer"
                  },
                  "width": {
                    "description": "视频宽度，像素。",
                    "type": "integer"
                  },
                  "height": {
                    "description": "视频高度，像素。",
                    "type": "integer"
                  }
                },
                "required": [
                  "video_url",
                  "duration_ms",
                  "width",
                  "height"
                ],
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "视频播放信息；非视频作品省略。"
          },
          "like_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "点赞数；未提供时为 null。"
          },
          "comment_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "评论数；未提供时为 null。"
          },
          "read_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "阅读数；未提供时为 null。"
          },
          "author": {
            "properties": {
              "user_id": {
                "description": "作者数字用户 ID，可用于查询用户资料或作品。",
                "type": "string"
              },
              "name": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "作者显示名称；未提供时为 null。"
              },
              "avatar_url": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "作者头像链接；未提供时为 null。"
              },
              "profile_url": {
                "description": "作者头条主页链接。",
                "type": "string"
              }
            },
            "required": [
              "user_id",
              "name",
              "avatar_url",
              "profile_url"
            ],
            "type": "object",
            "description": "作品作者。"
          }
        },
        "required": [
          "post_id",
          "content_type",
          "title",
          "content",
          "post_url",
          "publish_time",
          "cover_image_url",
          "images",
          "like_count",
          "comment_count",
          "read_count",
          "author"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "next_page_token": {
      "description": "下一页分页令牌；为空表示结束。",
      "type": "string"
    },
    "points": {
      "type": "object",
      "description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
      "properties": {
        "cost": {
          "type": "integer",
          "description": "本次请求最终确认消耗的积分。",
          "minimum": 0
        },
        "balance": {
          "type": "integer",
          "description": "本次接口完成时看到的当前积分余额。",
          "minimum": 0
        }
      },
      "required": [
        "cost",
        "balance"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "items",
    "next_page_token",
    "points"
  ]
}

通过头条用户主页链接读取其发布的作品；支持文章、视频和微头条及分页。

{
  "type": "object",
  "properties": {
    "profile_url": {
      "description": "头条用户主页链接或包含主页链接的分享文案；只有数字用户 ID 时使用 toutiao_get_user_posts_by_user_id。",
      "pattern": "https?://",
      "type": "string"
    },
    "content_type": {
      "default": "all",
      "description": "作品筛选：all、article、video、micro_post。",
      "enum": [
        "all",
        "article",
        "video",
        "micro_post"
      ],
      "type": "string"
    },
    "page_token": {
      "default": "",
      "description": "上一页返回的分页令牌；首次留空，不能跨用户或作品类型复用。",
      "type": "string"
    }
  },
  "required": [
    "profile_url"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "items": {
      "description": "用户发布的作品列表。",
      "items": {
        "properties": {
          "post_id": {
            "description": "作品 ID。",
            "type": "string"
          },
          "content_type": {
            "description": "作品类型：article、video 或 micro_post。",
            "enum": [
              "article",
              "video",
              "micro_post"
            ],
            "type": "string"
          },
          "title": {
            "description": "作品标题；微头条没有独立标题时为空字符串。",
            "type": "string"
          },
          "content": {
            "description": "文章为列表摘要，微头条为正文，视频通常为空字符串；完整内容请查询作品详情。",
            "type": "string"
          },
          "post_url": {
            "description": "作品链接。",
            "type": "string"
          },
          "publish_time": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "发布时间，秒级 Unix 时间戳；未提供时为 null。"
          },
          "cover_image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "封面图片链接；未提供时为 null。"
          },
          "images": {
            "description": "作品图片；无图片时为空数组。",
            "items": {
              "properties": {
                "url": {
                  "description": "图片链接。",
                  "type": "string"
                },
                "width": {
                  "anyOf": [
                    {
                      "type": "integer"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "图片宽度，像素；未提供时为 null。"
                },
                "height": {
                  "anyOf": [
                    {
                      "type": "integer"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "图片高度，像素；未提供时为 null。"
                }
              },
              "required": [
                "url",
                "width",
                "height"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "video": {
            "anyOf": [
              {
                "properties": {
                  "video_url": {
                    "description": "视频播放链接，有效期有限，建议获取后及时使用。",
                    "type": "string"
                  },
                  "duration_ms": {
                    "description": "视频时长，单位毫秒。",
                    "type": "integer"
                  },
                  "width": {
                    "description": "视频宽度，像素。",
                    "type": "integer"
                  },
                  "height": {
                    "description": "视频高度，像素。",
                    "type": "integer"
                  }
                },
                "required": [
                  "video_url",
                  "duration_ms",
                  "width",
                  "height"
                ],
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "视频播放信息；非视频作品省略。"
          },
          "like_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "点赞数；未提供时为 null。"
          },
          "comment_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "评论数；未提供时为 null。"
          },
          "read_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "阅读数；未提供时为 null。"
          },
          "author": {
            "properties": {
              "user_id": {
                "description": "作者数字用户 ID，可用于查询用户资料或作品。",
                "type": "string"
              },
              "name": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "作者显示名称；未提供时为 null。"
              },
              "avatar_url": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "作者头像链接；未提供时为 null。"
              },
              "profile_url": {
                "description": "作者头条主页链接。",
                "type": "string"
              }
            },
            "required": [
              "user_id",
              "name",
              "avatar_url",
              "profile_url"
            ],
            "type": "object",
            "description": "作品作者。"
          }
        },
        "required": [
          "post_id",
          "content_type",
          "title",
          "content",
          "post_url",
          "publish_time",
          "cover_image_url",
          "images",
          "like_count",
          "comment_count",
          "read_count",
          "author"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "next_page_token": {
      "description": "下一页分页令牌；为空表示结束。",
      "type": "string"
    },
    "points": {
      "type": "object",
      "description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
      "properties": {
        "cost": {
          "type": "integer",
          "description": "本次请求最终确认消耗的积分。",
          "minimum": 0
        },
        "balance": {
          "type": "integer",
          "description": "本次接口完成时看到的当前积分余额。",
          "minimum": 0
        }
      },
      "required": [
        "cost",
        "balance"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "items",
    "next_page_token",
    "points"
  ]
}

读取指定一级评论下的回复，按头条默认顺序分页；comment_id 取一级评论结果，续页保持该 ID，不要改用回复项自身的 ID。

{
  "type": "object",
  "properties": {
    "comment_id": {
      "description": "一级评论 ID，取一级评论结果的 comment_id；不要传内容 ID、链接或回复项自身的 comment_id。",
      "pattern": "^[0-9]+$",
      "type": "string"
    },
    "page_token": {
      "default": "",
      "description": "首次留空；续页原样传入同一一级评论上一页回复结果的 next_page_token，并保持 comment_id 不变；不要使用一级评论或搜索的分页令牌。",
      "type": "string"
    }
  },
  "required": [
    "comment_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "items": {
      "description": "当前页评论回复列表。",
      "items": {
        "properties": {
          "comment_id": {
            "description": "回复项自身的评论 ID；不要作为回复列表的入口 ID。",
            "type": "string"
          },
          "parent_comment_id": {
            "description": "所属一级评论 ID，用于继续查询该评论的回复。",
            "type": "string"
          },
          "reply_to_comment_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "被回复的评论 ID；上游未提供时省略。"
          },
          "content": {
            "description": "回复正文。",
            "type": "string"
          },
          "image_urls": {
            "description": "回复图片的大图链接列表；无图片时为空数组。",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "publish_time": {
            "description": "回复发布时间，秒级 Unix 时间戳。",
            "type": "integer"
          },
          "like_count": {
            "description": "回复点赞数。",
            "type": "integer"
          },
          "ip_location": {
            "description": "回复 IP 属地；未提供时为空字符串。",
            "type": "string"
          },
          "author": {
            "properties": {
              "profile_url": {
                "description": "评论作者头条主页链接。",
                "type": "string"
              },
              "user_id": {
                "description": "评论作者用户 ID。",
                "type": "string"
              },
              "name": {
                "description": "评论作者显示名称。",
                "type": "string"
              },
              "avatar_url": {
                "description": "评论作者头像链接。",
                "type": "string"
              }
            },
            "required": [
              "profile_url",
              "user_id",
              "name",
              "avatar_url"
            ],
            "type": "object",
            "description": "回复作者。"
          }
        },
        "required": [
          "comment_id",
          "parent_comment_id",
          "content",
          "image_urls",
          "publish_time",
          "like_count",
          "ip_location",
          "author"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "next_page_token": {
      "description": "下一页完整分页令牌；为空表示结束。",
      "type": "string"
    },
    "points": {
      "type": "object",
      "description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
      "properties": {
        "cost": {
          "type": "integer",
          "description": "本次请求最终确认消耗的积分。",
          "minimum": 0
        },
        "balance": {
          "type": "integer",
          "description": "本次接口完成时看到的当前积分余额。",
          "minimum": 0
        }
      },
      "required": [
        "cost",
        "balance"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "items",
    "next_page_token",
    "points"
  ]
}

按关键词或短语查找今日头条公开内容，支持分页。不用于读取指定链接的详情或查找用户；不返回导航、百科、用户及视频聚合面板。

{
  "type": "object",
  "properties": {
    "keyword": {
      "description": "搜索词或关键词短语，例如 NBA、旅行攻略；不要传作品链接、用户主页链接或内容 ID。",
      "minLength": 1,
      "type": "string"
    },
    "page_token": {
      "default": "",
      "description": "首次留空；续页原样传入上一页的 next_page_token，并保持 keyword 不变。",
      "type": "string"
    }
  },
  "required": [
    "keyword"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "items": {
      "description": "当前页内容列表，不包含聚合面板。",
      "items": {
        "properties": {
          "post_id": {
            "description": "内容 ID，以字符串表示。",
            "type": "string"
          },
          "title": {
            "description": "内容标题。",
            "type": "string"
          },
          "summary": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "搜索摘要，不是完整正文；未提供时为 null。"
          },
          "post_url": {
            "description": "头条内容页面链接。",
            "type": "string"
          },
          "publish_time": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "发布时间，秒级 Unix 时间戳；未提供时为 null。"
          },
          "has_video": {
            "description": "内容是否包含视频。",
            "type": "boolean"
          },
          "cover_image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "封面图片链接；未提供时为 null。"
          },
          "like_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "点赞数；未提供时为 null。"
          },
          "comment_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "评论数；未提供时为 null。"
          },
          "read_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "阅读数；未提供时为 null。"
          },
          "author": {
            "properties": {
              "profile_url": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "description": "作者头条主页链接；没有可用用户 ID 时省略。"
              },
              "user_id": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "作者用户 ID；未提供时为 null。"
              },
              "name": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "作者显示名称；未提供时为 null。"
              },
              "avatar_url": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "作者头像链接；未提供时为 null。"
              }
            },
            "required": [
              "user_id",
              "name",
              "avatar_url"
            ],
            "type": "object",
            "description": "内容作者。"
          }
        },
        "required": [
          "post_id",
          "title",
          "summary",
          "post_url",
          "publish_time",
          "has_video",
          "cover_image_url",
          "like_count",
          "comment_count",
          "read_count",
          "author"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "next_page_token": {
      "description": "下一页完整分页令牌；为空表示结束。",
      "type": "string"
    },
    "points": {
      "type": "object",
      "description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
      "properties": {
        "cost": {
          "type": "integer",
          "description": "本次请求最终确认消耗的积分。",
          "minimum": 0
        },
        "balance": {
          "type": "integer",
          "description": "本次接口完成时看到的当前积分余额。",
          "minimum": 0
        }
      },
      "required": [
        "cost",
        "balance"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "items",
    "next_page_token",
    "points"
  ]
}

读取头条文章、视频或微头条详情，包含正文、图片、作者和互动数据，视频含播放信息；输入内容数字 ID，可接续搜索结果。有链接时使用 toutiao_get_post_detail_by_url。视频说明不是语音转写。

{
  "type": "object",
  "properties": {
    "post_id": {
      "description": "头条内容数字 ID，可取搜索结果 post_id；不要传链接。",
      "pattern": "^[0-9]+$",
      "type": "string"
    }
  },
  "required": [
    "post_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "post_id": {
      "description": "内容 ID，以字符串表示。",
      "type": "string"
    },
    "title": {
      "description": "内容标题；无独立标题的微头条可为空，请阅读 content。",
      "type": "string"
    },
    "content": {
      "description": "正文纯文本；纯图片内容或视频可能为空，请结合 images 和 video 阅读。视频说明不是语音转写。",
      "type": "string"
    },
    "post_url": {
      "description": "头条内容页面链接。",
      "type": "string"
    },
    "publish_time": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "发布时间，秒级 Unix 时间戳；未提供时为 null。"
    },
    "images": {
      "description": "按正文顺序返回的图片，包含链接和像素宽高；无图片时为空数组。",
      "items": {
        "properties": {
          "url": {
            "description": "图片链接。",
            "type": "string"
          },
          "width": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "图片宽度，像素；未提供时为 null。"
          },
          "height": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "图片高度，像素；未提供时为 null。"
          }
        },
        "required": [
          "url",
          "width",
          "height"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "cover_image_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "封面图片链接；未提供时为 null。"
    },
    "author": {
      "properties": {
        "profile_url": {
          "description": "作者头条主页链接。",
          "type": "string"
        },
        "user_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "作者用户 ID；未提供时为 null。"
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "作者显示名称；未提供时为 null。"
        },
        "avatar_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "作者头像链接；未提供时为 null。"
        }
      },
      "required": [
        "profile_url",
        "user_id",
        "name",
        "avatar_url"
      ],
      "type": "object",
      "description": "内容作者，包含作者主页链接。"
    },
    "like_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "点赞数；未提供时为 null。"
    },
    "comment_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "评论数；未提供时为 null。"
    },
    "read_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "阅读数；未提供时为 null。"
    },
    "share_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "分享数；未提供时为 null。"
    },
    "collect_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "收藏数；未提供时为 null。"
    },
    "video": {
      "anyOf": [
        {
          "properties": {
            "video_url": {
              "description": "视频播放链接，有效期有限，建议获取后及时使用。",
              "type": "string"
            },
            "duration_ms": {
              "description": "视频时长，单位毫秒。",
              "type": "integer"
            },
            "width": {
              "description": "视频宽度，像素。",
              "type": "integer"
            },
            "height": {
              "description": "视频高度，像素。",
              "type": "integer"
            }
          },
          "required": [
            "video_url",
            "duration_ms",
            "width",
            "height"
          ],
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "视频播放信息；当前返回无视频信息时省略。"
    },
    "points": {
      "type": "object",
      "description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
      "properties": {
        "cost": {
          "type": "integer",
          "description": "本次请求最终确认消耗的积分。",
          "minimum": 0
        },
        "balance": {
          "type": "integer",
          "description": "本次接口完成时看到的当前积分余额。",
          "minimum": 0
        }
      },
      "required": [
        "cost",
        "balance"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "post_id",
    "title",
    "content",
    "post_url",
    "publish_time",
    "images",
    "cover_image_url",
    "author",
    "like_count",
    "comment_count",
    "read_count",
    "share_count",
    "collect_count",
    "points"
  ]
}

通过头条内容链接或分享文案读取文章、视频或微头条详情；只有内容 ID 时使用 toutiao_get_post_detail_by_post_id。视频说明不是语音转写。

{
  "type": "object",
  "properties": {
    "url": {
      "description": "头条内容链接或包含该链接的分享文案，支持 /article/ID/、/aID/、/video/ID/ 和 /w/ID/，可取搜索结果 post_url；不要传纯 ID。",
      "pattern": "https?://",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "post_id": {
      "description": "内容 ID，以字符串表示。",
      "type": "string"
    },
    "title": {
      "description": "内容标题；无独立标题的微头条可为空，请阅读 content。",
      "type": "string"
    },
    "content": {
      "description": "正文纯文本；纯图片内容或视频可能为空，请结合 images 和 video 阅读。视频说明不是语音转写。",
      "type": "string"
    },
    "post_url": {
      "description": "头条内容页面链接。",
      "type": "string"
    },
    "publish_time": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "发布时间，秒级 Unix 时间戳；未提供时为 null。"
    },
    "images": {
      "description": "按正文顺序返回的图片，包含链接和像素宽高；无图片时为空数组。",
      "items": {
        "properties": {
          "url": {
            "description": "图片链接。",
            "type": "string"
          },
          "width": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "图片宽度，像素；未提供时为 null。"
          },
          "height": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "图片高度，像素；未提供时为 null。"
          }
        },
        "required": [
          "url",
          "width",
          "height"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "cover_image_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "封面图片链接；未提供时为 null。"
    },
    "author": {
      "properties": {
        "profile_url": {
          "description": "作者头条主页链接。",
          "type": "string"
        },
        "user_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "作者用户 ID；未提供时为 null。"
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "作者显示名称；未提供时为 null。"
        },
        "avatar_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "作者头像链接；未提供时为 null。"
        }
      },
      "required": [
        "profile_url",
        "user_id",
        "name",
        "avatar_url"
      ],
      "type": "object",
      "description": "内容作者，包含作者主页链接。"
    },
    "like_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "点赞数；未提供时为 null。"
    },
    "comment_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "评论数；未提供时为 null。"
    },
    "read_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "阅读数；未提供时为 null。"
    },
    "share_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "分享数；未提供时为 null。"
    },
    "collect_count": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "收藏数；未提供时为 null。"
    },
    "video": {
      "anyOf": [
        {
          "properties": {
            "video_url": {
              "description": "视频播放链接，有效期有限，建议获取后及时使用。",
              "type": "string"
            },
            "duration_ms": {
              "description": "视频时长，单位毫秒。",
              "type": "integer"
            },
            "width": {
              "description": "视频宽度，像素。",
              "type": "integer"
            },
            "height": {
              "description": "视频高度，像素。",
              "type": "integer"
            }
          },
          "required": [
            "video_url",
            "duration_ms",
            "width",
            "height"
          ],
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "视频播放信息；当前返回无视频信息时省略。"
    },
    "points": {
      "type": "object",
      "description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
      "properties": {
        "cost": {
          "type": "integer",
          "description": "本次请求最终确认消耗的积分。",
          "minimum": 0
        },
        "balance": {
          "type": "integer",
          "description": "本次接口完成时看到的当前积分余额。",
          "minimum": 0
        }
      },
      "required": [
        "cost",
        "balance"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "post_id",
    "title",
    "content",
    "post_url",
    "publish_time",
    "images",
    "cover_image_url",
    "author",
    "like_count",
    "comment_count",
    "read_count",
    "share_count",
    "collect_count",
    "points"
  ]
}

读取头条文章、视频或微头条的一级评论，按头条默认顺序返回，支持分页，不包含评论回复；输入内容数字 ID，支持接续搜索结果；有链接时使用 toutiao_get_post_comments_by_url。

{
  "type": "object",
  "properties": {
    "post_id": {
      "description": "头条内容数字 ID，可取搜索结果 post_id；不要传链接。",
      "pattern": "^[0-9]+$",
      "type": "string"
    },
    "page_token": {
      "default": "",
      "description": "首次留空；续页原样传入同一内容上一页评论结果的 next_page_token；不要使用搜索结果的分页令牌。",
      "type": "string"
    }
  },
  "required": [
    "post_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "items": {
      "description": "当前页一级评论列表。",
      "items": {
        "properties": {
          "comment_id": {
            "description": "一级评论 ID，以字符串表示。",
            "type": "string"
          },
          "content": {
            "description": "评论正文。",
            "type": "string"
          },
          "image_urls": {
            "description": "评论图片的大图链接列表；无图片时为空数组。",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "publish_time": {
            "description": "评论发布时间，秒级 Unix 时间戳。",
            "type": "integer"
          },
          "like_count": {
            "description": "评论点赞数。",
            "type": "integer"
          },
          "has_replies": {
            "description": "评论是否有回复。",
            "type": "boolean"
          },
          "ip_location": {
            "description": "评论 IP 属地；未提供时为空字符串。",
            "type": "string"
          },
          "author": {
            "properties": {
              "profile_url": {
                "description": "评论作者头条主页链接。",
                "type": "string"
              },
              "user_id": {
                "description": "评论作者用户 ID。",
                "type": "string"
              },
              "name": {
                "description": "评论作者显示名称。",
                "type": "string"
              },
              "avatar_url": {
                "description": "评论作者头像链接。",
                "type": "string"
              }
            },
            "required": [
              "profile_url",
              "user_id",
              "name",
              "avatar_url"
            ],
            "type": "object",
            "description": "评论作者。"
          }
        },
        "required": [
          "comment_id",
          "content",
          "image_urls",
          "publish_time",
          "like_count",
          "has_replies",
          "ip_location",
          "author"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "next_page_token": {
      "description": "下一页完整分页令牌；为空表示结束。",
      "type": "string"
    },
    "points": {
      "type": "object",
      "description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
      "properties": {
        "cost": {
          "type": "integer",
          "description": "本次请求最终确认消耗的积分。",
          "minimum": 0
        },
        "balance": {
          "type": "integer",
          "description": "本次接口完成时看到的当前积分余额。",
          "minimum": 0
        }
      },
      "required": [
        "cost",
        "balance"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "items",
    "next_page_token",
    "points"
  ]
}

通过头条内容链接或分享文案读取一级评论，按头条默认顺序返回，支持分页，不包含评论回复；只有内容 ID 时使用 toutiao_get_post_comments_by_post_id。

{
  "type": "object",
  "properties": {
    "url": {
      "description": "头条内容链接或包含该链接的分享文案，支持 /article/ID/、/aID/、/video/ID/ 和 /w/ID/，可取搜索结果 post_url；不要传纯 ID。",
      "pattern": "https?://",
      "type": "string"
    },
    "page_token": {
      "default": "",
      "description": "首次留空；续页原样传入同一内容上一页评论结果的 next_page_token；不要使用搜索结果的分页令牌。",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "items": {
      "description": "当前页一级评论列表。",
      "items": {
        "properties": {
          "comment_id": {
            "description": "一级评论 ID，以字符串表示。",
            "type": "string"
          },
          "content": {
            "description": "评论正文。",
            "type": "string"
          },
          "image_urls": {
            "description": "评论图片的大图链接列表；无图片时为空数组。",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "publish_time": {
            "description": "评论发布时间，秒级 Unix 时间戳。",
            "type": "integer"
          },
          "like_count": {
            "description": "评论点赞数。",
            "type": "integer"
          },
          "has_replies": {
            "description": "评论是否有回复。",
            "type": "boolean"
          },
          "ip_location": {
            "description": "评论 IP 属地；未提供时为空字符串。",
            "type": "string"
          },
          "author": {
            "properties": {
              "profile_url": {
                "description": "评论作者头条主页链接。",
                "type": "string"
              },
              "user_id": {
                "description": "评论作者用户 ID。",
                "type": "string"
              },
              "name": {
                "description": "评论作者显示名称。",
                "type": "string"
              },
              "avatar_url": {
                "description": "评论作者头像链接。",
                "type": "string"
              }
            },
            "required": [
              "profile_url",
              "user_id",
              "name",
              "avatar_url"
            ],
            "type": "object",
            "description": "评论作者。"
          }
        },
        "required": [
          "comment_id",
          "content",
          "image_urls",
          "publish_time",
          "like_count",
          "has_replies",
          "ip_location",
          "author"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "next_page_token": {
      "description": "下一页完整分页令牌；为空表示结束。",
      "type": "string"
    },
    "points": {
      "type": "object",
      "description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
      "properties": {
        "cost": {
          "type": "integer",
          "description": "本次请求最终确认消耗的积分。",
          "minimum": 0
        },
        "balance": {
          "type": "integer",
          "description": "本次接口完成时看到的当前积分余额。",
          "minimum": 0
        }
      },
      "required": [
        "cost",
        "balance"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "items",
    "next_page_token",
    "points"
  ]
}

查询当前 API Key 账户的 SocialDataX 积分余额、剩余积分或点数 / remaining points balance。需要充值时请访问 https://socialdatax.com/dashboard/billing。

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

{
  "type": "object",
  "additionalProperties": {
    "type": "integer"
  }
}