# Social Fetch API - Weibo endpoints # Base URL: https://api.socialfetch.dev # Auth: x-api-key header (sfk_...) # Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json # Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json 8 documented Weibo operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported. ## GET /v1/weibo/profiles/{profileId} Get Weibo profile Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are charged, except a screen name no account has, which is free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/weibo/profiles/profileid/get.mdx SDK: client.weibo.getProfile({ profileId: "1195230310" }) Parameters: - profileId (required, string) - The account's id (the digits in a profile link such as weibo.com/u/1195230310), a whole profile link, or its screen name (handle) such as `何炅`, with or without `@`. A screen name is looked up first; an unknown one answers `not_found` free of charge. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/weibo/profiles/1195230310" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/weibo/profiles/{profileId}/posts List Weibo profile posts Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are charged, except a screen name no account has, which is free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/weibo/profiles/profileid/posts/get.mdx SDK: client.weibo.listProfilePosts({ profileId: "1195230310" }) Parameters: - profileId (required, string) - The account's id (the digits in a profile link such as weibo.com/u/1195230310), a whole profile link, or its screen name (handle) such as `何炅`, with or without `@`. A screen name is looked up first; an unknown one answers `not_found` free of charge. Outcome field: `data.lookupStatus` in `found`, `empty`, `not_found` curl "https://api.socialfetch.dev/v1/weibo/profiles/1195230310/posts" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/weibo/posts/{postId} Get Weibo post Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/weibo/posts/postid/get.mdx SDK: client.weibo.getPost({ postId: "5365286204084354" }) Parameters: - postId (required, string) - The post's id: its 16 digits (as in m.weibo.cn/detail/5365286204084354), its short code (the last part of weibo.com/1195230310/Rrookh8wG) or a whole post link. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/weibo/posts/5365286204084354" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/weibo/posts/{postId}/comments List Weibo post comments Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/weibo/posts/postid/comments/get.mdx SDK: client.weibo.listPostComments({ postId: "5365286204084354" }) Parameters: - postId (required, string) - The post's id: its 16 digits (as in m.weibo.cn/detail/5365286204084354), its short code (the last part of weibo.com/1195230310/Rrookh8wG) or a whole post link. Outcome field: `data.lookupStatus` in `found`, `empty` curl "https://api.socialfetch.dev/v1/weibo/posts/5365286204084354/comments" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/weibo/comments/{commentId}/replies List Weibo comment replies Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/weibo/comments/commentid/replies/get.mdx SDK: client.weibo.listCommentReplies({ commentId: "5365287278876193" }) Parameters: - commentId (required, string) - The comment's id, as the comments endpoint returns it in `comments[].id`. Outcome field: `data.lookupStatus` in `found`, `empty` curl "https://api.socialfetch.dev/v1/weibo/comments/5365287278876193/replies" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/weibo/search/posts Search Weibo posts Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/weibo/search/posts/get.mdx SDK: client.weibo.searchPosts({ query: "苹果", sort: "top" }) Parameters: - query (required, string) - What to search for, in any language. Chinese text works as typed, for example `苹果`. - sort (optional, string, enum: top | recent) - `top` (the default) is Weibo's own mix, popular posts first; `recent` is the real-time feed, newest first. Outcome field: `data.lookupStatus` in `found`, `empty` curl "https://api.socialfetch.dev/v1/weibo/search/posts?query=苹果" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/weibo/search/profiles Search Weibo profiles Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/weibo/search/profiles/get.mdx SDK: client.weibo.searchProfiles({ query: "NASA" }) Parameters: - query (required, string) - What to search for, in any language. Chinese text works as typed, for example `苹果`. Outcome field: `data.lookupStatus` in `found`, `empty` curl "https://api.socialfetch.dev/v1/weibo/search/profiles?query=NASA" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/weibo/trending List Weibo trending topics Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/weibo/trending/get.mdx SDK: client.weibo.listTrending() curl "https://api.socialfetch.dev/v1/weibo/trending" \ -H "x-api-key: YOUR_API_KEY"