Weibo Search API

Q: How do I count only original posts?

Filter on is_repost: true means the row is a repost, so drop those when counting original mentions. repost_count is how many times a post was reposted, a measure of how far it spread.

Q: How do I tell whether a poster is a big account?

Check author_verified, then read author_verified_reason, which states what the verification covers, such as a company role. Combine it with author_follower_count to judge how far that account's posts can reach.

POST

API health

24h health: Normal
24h average time: —

Healthy / normal
Available
Limited
Mostly down

Normal

Last 24 hours

Last 30 days

Find Weibo posts mentioning a keyword, up to 50 per call, with text, posting device, repost, comment and like counts, and the author's followers and verification. Use is_repost to separate reposts from original posts; full coverage of a time period is not guaranteed.

Weibo Search finds public posts by keyword and returns each post's text, publish time, posting device, repost, comment and like counts, and whether it is a repost, plus the author's nickname, bio, follower count, verification status and verification note, with image and video links. Use it to see who is talking about a topic on Weibo, what they say and how far it spreads: public opinion monitoring, brand mention counts and finding key opinion leaders.

Tell verified big accounts apart by author_verified_reason, which states what the verification is for, and gauge reach with author_follower_count. Drop reposts with is_repost when you count original mentions. The trending list needs no keyword; read it with the Weibo Trending capability.

Price $0.56 per 1,000 requests ($0.000556 per call). Failed calls and empty results are not charged. Synchronous. For slow jobs add "mode": "async" to the body, take the job_id and poll.

AI prompt

Paste this into your AI assistant. It already holds this endpoint's parameters, response fields and an example request, so the assistant can ask what you need and then write the scraper.

Please help me write a data collection script with the EveryInfra Weibo Search endpoint (weibo/search).

Endpoint contract:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to weibo and action to search, and put the parameters inside params.
- Required parameters:
  - keyword: Specifies the search term for public posts in the search action. The trending action does not use a keyword parameter and returns current hot search topics rather than user posts.
- Optional parameters:
  - limit: The most rows to return in this call, an integer from 1 to 50. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. (default: 20)
- Returns a list of records. Main fields of each record: id, url, text, posted_at, device (Client the post was published from (suc…), repost_count, comment_count, like_count, is_repost (Whether the post is a repost), author_id, author_name, author_bio (Author bio); 19 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=weibo.
- Example request body:
{
  "platform": "weibo",
  "action": "search",
  "params": {
    "keyword": "城市骑行"
  }
}
- Price: $0.56 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.

Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.

Request parameters

Name	In	Type	Required	Default	Description
`Authorization`	header	`string`	Yes	-	Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
`platform`	body	`string`	Yes	`weibo`	Platform identifier, fixed value.
`action`	body	`string`	Yes	`search`	Capability identifier, fixed value.
`keyword`	body.params	Not declared	Yes	-	Specifies the search term for public posts in the search action. The trending action does not use a keyword parameter and returns current hot search topics rather than user posts.
`limit`	body.params	`integer (1–50)`	No	`20`	The most rows to return in this call, an integer from 1 to 50. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge.

Code samples

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "weibo",
  "action": "search",
  "params": {
    "keyword": "城市骑行"
  }
}'

[OpenAPI definition (JSON)]Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.

Response example

Real response

Captured September 26, 2026 at 08:56 (UTC) by calling this API with the parameters in the code sample above. results and count are that call's real response with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2. id, billing and quota differ on every call, so only their shape is shown.

json

{
  "id": "req_…",
  "platform": "weibo",
  "action": "search",
  "results": [
    {
      "id": "（已隐去）",
      "url": "https://weibo.com/2590508284/5347470118748545",
      "text": "【层林逐风  赛道如画｜2026环北京·门头沟国际公路自行车赛第二日激战正酣】9月26日，为期三天的2026环北京·门头沟国际公路自行车赛进入第二个比赛日。本届赛事为国际自行车联盟（UCI）认证的2.2级亚洲巡回赛事，共吸引来自11个国家和地区的21支队伍的百余名职业车手及约3000名自行车爱好者参与，职业组总赛程超过340公里。赛事历时三日，设斋堂耐力、京西山地、城市绕圈三大特色赛段；当日举行的第二赛段——京西山地赛段，是爬坡难度最高、参与人群覆盖面最广的赛段，设职业组、大众骑游39公里组与大众骑游9公里组三个组别。本届赛事是2026京西国际山地户外季…",
      "posted_at": "Sat Sep 26 18:48:09 +0800 2026",
      "device": "HUAWEI Mate 60 Pro",
      "repost_count": 0,
      "comment_count": 0,
      "like_count": 1,
      "is_repost": false,
      "author_id": "（已隐去）",
      "author_name": "（已隐去）",
      "author_verified": true,
      "author_avatar_url": "https://tvax3.sinaimg.cn/（已隐去）",
      "image_urls": [
        "https://wx2.sinaimg.cn/orj1080/9a6804fcly1ihh9kjk3d5j20zk0npk68.jpg",
        "https://wx2.sinaimg.cn/orj1080/9a6804fcly1ihh9kjj04hj20nl0fq7b6.jpg",
        "https://wx3.sinaimg.cn/orj1080/9a6804fcly1ihh9kjp5dwj20tw13wqis.jpg"
      ],
      "platform": "weibo"
    },
    {
      "id": "（已隐去）",
      "url": "https://weibo.com/3075210951/5347460012838223",
      "text": "#九九骑行节# #九号城市主理人#",
      "posted_at": "Sat Sep 26 18:08:01 +0800 2026",
      "device": "iPhone客户端",
      "repost_count": 0,
      "comment_count": 0,
      "like_count": 0,
      "is_repost": true,
      "author_id": "（已隐去）",
      "author_name": "（已隐去）",
      "author_verified": false,
      "author_avatar_url": "https://tvax1.sinaimg.cn/（已隐去）",
      "video_url": "http://f.video.weibocdn.com/o0/gFJZA5WElx08AYxj2Opi01041201pS5N0E010.mp4?label=mp4_720p&template=1280x720.25.0&ori=0&ps=1CwnkDw1GXwCQx&Expires=1790423648&ssig=S036CI1rO4&KID=unistore,video",
      "platform": "weibo"
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Response fields

Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.

Field	Meaning
`id`	The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms.
`url`	Link to the record on the platform.
`text`	Body text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so).
`posted_at`	Publish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it.
`device`	Client the post was published from (such as an iPhone client).
`repost_count`	Reposts (as distinct from quote posts). null means not disclosed.
`comment_count`	Comments. null means not disclosed, not 0.
`like_count`	Likes. null means the platform or this capability does not disclose it; it is not 0.
`is_repost`	Whether the post is a repost.
`author_id`	Author's unique ID on the platform.
`author_name`	Author's display name.
`author_bio`	Author bio.
`author_follower_count`	Author's follower count. null means not disclosed.
`author_following_count`	Number of accounts the author follows.
`author_verified`	Whether the author carries Weibo verification (the V badge).
`author_verified_reason`	Verification description (such as a company role); use it to tell what a verified account represents.
`author_avatar_url`	Author avatar URL.
`image_urls`	Array of image links in the platform's display order; absent when there are no images.
`video_url`	Video link of the post.
`platform`	Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).

FAQ

How do I count only original posts?

Filter on is_repost: true means the row is a repost, so drop those when counting original mentions. repost_count is how many times a post was reposted, a measure of how far it spread.

How do I tell whether a poster is a big account?

Check author_verified, then read author_verified_reason, which states what the verification covers, such as a company role. Combine it with author_follower_count to judge how far that account's posts can reach.

Can I get the trending list?

Search returns posts that contain your keyword. The trending list needs no keyword: read it with the Weibo Trending capability, which returns trending entries rather than posts.

Errors and billing

401: Missing or invalid key. Authentication runs before parameter checks, so unauthenticated requests never see the parameter schema.
422: Wrong parameter name or value. The error lists the parameters and allowed values this capability accepts and the closest match; it happens before any charge.
402: Insufficient balance. Top up first.
429: The account's per-minute request limit was reached (all of its API keys count together; a key's own lower limit applies first). Wait for Retry-After and try again; a rate package in the console raises the limit.
503: Could not complete right now. Any charge for the call goes back to your balance automatically, and the billing receipt in the response states the actual outcome, including when it is not yet known. Do not resend blindly.
200 empty: The request completed without data and is not charged (billing.reason = empty_result_refunded).