API referenceWeibo
Weibo search
Keyword post-search over Weibo (微博).
Hits the desktop search-all API (weibo.com/ajax/statuses/search) with an
anonymous visitor an authenticated session, NO login, NO request signing (unlike the
requires an authenticated session mobile getIndex). Page forward with the 1-indexed page. NOTE:
engagement counts (like/comment/repost/view) are withheld by Weibo's search
surface and returned as null, use /weibo-details for exact per-post counts.
Weibo's search surface withholds engagement counts. Those fields come back null on search results and are flagged, rather than being filled with zeros. Read a post through the details endpoint to get its counts.
The example response below is real output from this endpoint, not an illustration. Long lists and long strings are shortened to keep the page readable, and each place that happens is marked. This example took 5.7s.
Authorization
ApiKeyAuth X-API-Key<token>
Your API key. Sent on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scrapers/weibo-search" \ -H "Content-Type: application/json" \ -d '{ "keyword": "美食", "page": 1 }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "data": { "has_more": true, "keyword": "美食", "note": "Engagement counts (like/comment/repost/view) are withheld by Weibo's search surface and returned as null — use /weibo-details for exact per-post counts.", "page": 1, "posts": [ { "author": { "avatar": "https://tvax4.sinaimg.cn/crop.0.0.512.512.1024/006Cc5Yily8fqsgzw83c2j30e80e8t9h.jpg?KID=imgbed,tva&Expires=1787497359&ssig=ttLSgeug8v", "cover_image": "https://wx2.sinaimg.cn/crop.0.0.640.640.640/006Cc5Yigy1fkzeyd2wbuj30yi0yh44a.jpg;https://wx2.sinaimg.cn/crop.0.0.640.640.640/006Cc5Yigy1fkzef9tdylj30yi0yi43m.jpg;https://wx2.sinaimg.cn/crop.0.0.640.640.640/006Cc5Yigy1fkzed6rruaj30yi0yijwc.jpg;https://wx2.sinaimg.cn/crop.0.0.640.640.640/006Cc5Yigy1fkze1d8j9tj30yi0ygdl1.… (+3 chars)", "custom_domain": null, "description": "一个地道的云南妹子，分享一切云南美好 商务合作联系：dianxi008 注明【滇西小哥合作】", "followers_count": 8535153, "followers_count_display": "853.5万", "following_count": 176, "gender": "female", "is_svip": true, "location": "云南 保山", "membership_level": 2, "membership_type": 12, "post_count": 1182, "profile_url": "https://weibo.com/u/6061180654", "screen_name": "滇西小哥", "total_comment_count": 2587051, "total_engagement_count": 17567198, "total_engagement_display": "1756.7万", "total_like_count": 12843962, "total_repost_count": 2136185, "user_id": "6061180654", "verified": true, "verified_reason": "美食博主 超话粉丝大咖（滇西小哥超话） 美食视频自媒体", "verified_type": 0 }, "can_edit": false, "comment_count": null, "created_at": "2026-07-04T00:50:15+08:00", "created_at_raw": "Sat Jul 04 00:50:15 +0800 2026", "edit_count": null, "engagement_counts_withheld": true, "favorited": false, "images": [], "is_ad": false, "is_edited": false, "is_long_text": true, "is_repost": false, "like_count": null, "links": [ { "short_url": "http://t.cn/AXV0tInE", "title": "滇西小哥的微博视频", "url": "https://video.weibo.com/show?fid=1034:5275331980886060" }, { "short_url": "http://t.cn/A6VaElrs", "title": "网页链接", "url": "https://weibo.com/ttarticle/p/show?id=2309404641947297120553" }, "… 12 more items in the full response" ], "media_type": "video", "mid": "5316758270644809", "mixed_media": [], "post_id": "R71Xt2HK9", "post_url": "https://weibo.com/6061180654/R71Xt2HK9", "reads_count": null, "region": "江苏", "repost_count": null, "source": "微博视频号", "tags": [], "text": "#河南美食#云南十八怪牛奶做成片片卖。 #吃尽天下美食# \nhttp://t.cn/AXV0tInE \nhttp://t.cn/A6VaElrs \nhttp://t.cn/AXSuaO7Z \nhttp://t.cn/A6Yrprfb \nhttp://t.cn/A6jaQxVV \nhttp://t.cn/A6VLIPa2 \nhttp://t.cn/A6W8RMGm \nhttp://t.cn/A6aZHGzA \nhttp://t.cn/A6YHBUrV \nhttp://t.cn/A6IDOBGn \n ", "text_html": "<a href=\"//s.weibo.com/weibo?q=%23%E6%B2%B3%E5%8D%97%E7%BE%8E%E9%A3%9F%23\" target=\"_blank\">#河南<span style=\"color: red;\">美食</span>#</a>云南十八怪牛奶做成片片卖。 <a href=\"//s.weibo.com/weibo?q=%23%E5%90%83%E5%B0%BD%E5%A4%A9%E4%B8%8B%E7%BE%8E%E9%A3%9F%23\" target=\"_blank\">#吃尽天下<span style=\"color: red;\">美食</span>#</a> <br /><a target=\"… (+2461 chars)", "text_length": 1197, "topics": [ "河南美食", "吃尽天下美食" ], "video": { "cover_url": "https://wx3.sinaimg.cn/orj1080/006Cc5Yigy1ib34nc14c4j31hc0u0aji.jpg", "duration_seconds": 1996, "h5_url": "https://video.weibo.com/show?fid=1034:5275331980886060", "hd_url": "http://f.video.weibocdn.com/u0/4BXun7BAgx08vZ4d5M5i0104120cS3qQ0E050.mp4?label=mp4_hd&template=852x480.25.0&ori=0&ps=1CwnkDw1GXwCQx&Expires=1787490158&ssig=bizzBcJS4U&KID=unistore,video", "height": 2160, "media_id": "5275331980886060", "orientation": "horizontal", "qualities": [ { "bitrate": 8748283, "fps": 25, "height": 2160, "label": "mp4_2160p", "size_bytes": 2183089263, "url": "https://f.video.weibocdn.com/u0/K5ZdZWRYgx08vZ4gGf6E0104122nK1f90E0R0.mp4?label=mp4_2160p&template=3840x2160.25.0&media_id=5275331980886060&tp=8x8A3El:YTkl0eM8&us=0&ori=1&bf=2&ot=h&lp=000034evwP&ps=mZ6WB&uid=i1UPvNM&ab=,15568-g4,3601-g43,3601-g42,8013-g0,3601-g38&Expires=1787490159&ssig=8GLu615rw%2F&KID=unistore,video", "width": 3840 }, { "bitrate": 3996232, "fps": 25, "height": 1440, "label": "mp4_1440p", "size_bytes": 997239294, "url": "https://f.video.weibocdn.com/u0/HPmoqcsbgx08vZ4i31AY01041215ujuK0E0o0.mp4?label=mp4_1440p&template=2560x1440.25.0&media_id=5275331980886060&tp=8x8A3El:YTkl0eM8&us=0&ori=1&bf=2&ot=h&lp=000034evwP&ps=mZ6WB&uid=i1UPvNM&ab=,15568-g4,3601-g43,3601-g42,8013-g0,3601-g38&Expires=1787490159&ssig=6jHCJM%2B3vg&KID=unistore,video", "width": 2560 }, "… 4 more items in the full response" ], "title": "滇西小哥的微博视频", "upload_time": "2026-03-11T09:32:15+00:00", "upload_timestamp": 1773221535, "url": "https://f.video.weibocdn.com/u0/K5ZdZWRYgx08vZ4gGf6E0104122nK1f90E0R0.mp4?label=mp4_2160p&template=3840x2160.25.0&media_id=5275331980886060&tp=8x8A3El:YTkl0eM8&us=0&ori=1&bf=2&ot=h&lp=000034evwP&ps=mZ6WB&uid=i1UPvNM&ab=,15568-g4,3601-g43,3601-g42,8013-g0,3601-g38&Expires=1787490159&ssig=8GLu615rw%2F&KID=unistore,video", "view_count": 363360, "view_count_display": "36.3万次观看", "width": 3840 }, "view_count": null, "view_count_display": null, "visibility": null }, { "author": { "avatar": "https://tvax4.sinaimg.cn/crop.0.0.512.512.1024/006Cc5Yily8fqsgzw83c2j30e80e8t9h.jpg?KID=imgbed,tva&Expires=1787497359&ssig=ttLSgeug8v", "cover_image": "https://wx2.sinaimg.cn/crop.0.0.640.640.640/006Cc5Yigy1fkzeyd2wbuj30yi0yh44a.jpg;https://wx2.sinaimg.cn/crop.0.0.640.640.640/006Cc5Yigy1fkzef9tdylj30yi0yi43m.jpg;https://wx2.sinaimg.cn/crop.0.0.640.640.640/006Cc5Yigy1fkzed6rruaj30yi0yijwc.jpg;https://wx2.sinaimg.cn/crop.0.0.640.640.640/006Cc5Yigy1fkze1d8j9tj30yi0ygdl1.… (+3 chars)", "custom_domain": null, "description": "一个地道的云南妹子，分享一切云南美好 商务合作联系：dianxi008 注明【滇西小哥合作】", "followers_count": 8535153, "followers_count_display": "853.5万", "following_count": 176, "gender": "female", "is_svip": true, "location": "云南 保山", "membership_level": 2, "membership_type": 12, "post_count": 1182, "profile_url": "https://weibo.com/u/6061180654", "screen_name": "滇西小哥", "total_comment_count": 2587051, "total_engagement_count": 17567198, "total_engagement_display": "1756.7万", "total_like_count": 12843962, "total_repost_count": 2136185, "user_id": "6061180654", "verified": true, "verified_reason": "美食博主 超话粉丝大咖（滇西小哥超话） 美食视频自媒体", "verified_type": 0 }, "can_edit": false, "comment_count": null, "created_at": "2026-07-04T00:08:54+08:00", "created_at_raw": "Sat Jul 04 00:08:54 +0800 2026", "edit_count": null, "engagement_counts_withheld": true, "favorited": false, "images": [], "is_ad": false, "is_edited": false, "is_long_text": true, "is_repost": false, "like_count": null, "links": [ { "short_url": "http://t.cn/AXV0tInE", "title": "滇西小哥的微博视频", "url": "https://video.weibo.com/show?fid=1034:5275331980886060" }, { "short_url": "http://t.cn/A6VaElrs", "title": "网页链接", "url": "https://weibo.com/ttarticle/p/show?id=2309404641947297120553" }, "… 12 more items in the full response" ], "media_type": "video", "mid": "5316747869290791", "mixed_media": [], "post_id": "R71GGCYXt", "post_url": "https://weibo.com/6061180654/R71GGCYXt", "reads_count": null, "region": "江苏", "repost_count": null, "source": "微博视频号", "tags": [], "text": "#河南美食#云南十八怪牛奶做成片片卖。 #吃尽天下美食# \nhttp://t.cn/AXV0tInE \nhttp://t.cn/A6VaElrs \nhttp://t.cn/AXSuaO7Z \nhttp://t.cn/A6Yrprfb \nhttp://t.cn/A6jaQxVV \nhttp://t.cn/A6VLIPa2 \nhttp://t.cn/A6W8RMGm \nhttp://t.cn/A6aZHGzA \nhttp://t.cn/A6YHBUrV \nhttp://t.cn/A6IDOBGn \n ", "text_html": "<a href=\"//s.weibo.com/weibo?q=%23%E6%B2%B3%E5%8D%97%E7%BE%8E%E9%A3%9F%23\" target=\"_blank\">#河南<span style=\"color: red;\">美食</span>#</a>云南十八怪牛奶做成片片卖。 <a href=\"//s.weibo.com/weibo?q=%23%E5%90%83%E5%B0%BD%E5%A4%A9%E4%B8%8B%E7%BE%8E%E9%A3%9F%23\" target=\"_blank\">#吃尽天下<span style=\"color: red;\">美食</span>#</a> <br /><a target=\"… (+2461 chars)", "text_length": 1197, "topics": [ "河南美食", "吃尽天下美食" ], "video": { "cover_url": "https://wx3.sinaimg.cn/orj1080/006Cc5Yigy1ib34nc14c4j31hc0u0aji.jpg", "duration_seconds": 1996, "h5_url": "https://video.weibo.com/show?fid=1034:5275331980886060", "hd_url": "http://f.video.weibocdn.com/u0/4BXun7BAgx08vZ4d5M5i0104120cS3qQ0E050.mp4?label=mp4_hd&template=852x480.25.0&ori=0&ps=1CwnkDw1GXwCQx&Expires=1787490158&ssig=bizzBcJS4U&KID=unistore,video", "height": 2160, "media_id": "5275331980886060", "orientation": "horizontal", "qualities": [ { "bitrate": 8748283, "fps": 25, "height": 2160, "label": "mp4_2160p", "size_bytes": 2183089263, "url": "https://f.video.weibocdn.com/u0/K5ZdZWRYgx08vZ4gGf6E0104122nK1f90E0R0.mp4?label=mp4_2160p&template=3840x2160.25.0&media_id=5275331980886060&tp=8x8A3El:YTkl0eM8&us=0&ori=1&bf=2&ot=h&lp=000034evwP&ps=mZ6WB&uid=i1UPvNM&ab=,15568-g4,3601-g43,3601-g42,8013-g0,3601-g38&Expires=1787490159&ssig=8GLu615rw%2F&KID=unistore,video", "width": 3840 }, { "bitrate": 3996232, "fps": 25, "height": 1440, "label": "mp4_1440p", "size_bytes": 997239294, "url": "https://f.video.weibocdn.com/u0/HPmoqcsbgx08vZ4i31AY01041215ujuK0E0o0.mp4?label=mp4_1440p&template=2560x1440.25.0&media_id=5275331980886060&tp=8x8A3El:YTkl0eM8&us=0&ori=1&bf=2&ot=h&lp=000034evwP&ps=mZ6WB&uid=i1UPvNM&ab=,15568-g4,3601-g43,3601-g42,8013-g0,3601-g38&Expires=1787490159&ssig=6jHCJM%2B3vg&KID=unistore,video", "width": 2560 }, "… 4 more items in the full response" ], "title": "滇西小哥的微博视频", "upload_time": "2026-03-11T09:32:15+00:00", "upload_timestamp": 1773221535, "url": "https://f.video.weibocdn.com/u0/K5ZdZWRYgx08vZ4gGf6E0104122nK1f90E0R0.mp4?label=mp4_2160p&template=3840x2160.25.0&media_id=5275331980886060&tp=8x8A3El:YTkl0eM8&us=0&ori=1&bf=2&ot=h&lp=000034evwP&ps=mZ6WB&uid=i1UPvNM&ab=,15568-g4,3601-g43,3601-g42,8013-g0,3601-g38&Expires=1787490159&ssig=8GLu615rw%2F&KID=unistore,video", "view_count": 363360, "view_count_display": "36.3万次观看", "width": 3840 }, "view_count": null, "view_count_display": null, "visibility": null }, "… 37 more items in the full response" ], "result_count": 39, "total": 148120443 } }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "weibo-search", "billable": true, "duration_ms": 4461 }}