Brand monitoring on Chinese social media
Start with one cross-platform search to see where the brand is mentioned and which mentions are negative, then go platform by platform: Weibo by date range, Xiaohongshu by newest notes, Douyin by the comments under a video. Every step below is a real endpoint with real parameters.
A new account gets 50 trial calls; after that, successful calls are billed from a prepaid balance. See pricing.
Monitor a brand in four calls
Replace 品牌名 (the brand name) in the examples with your own brand; dates are Beijing time. You need an API key, and a new account has 50 trial calls.
Search several sources at once
POST /v1/search looks across several kinds of public sources in one call. Put the brand in query, pick sources with platforms, and keep only negative mentions with sentiment. You get the results in one format, the total hit count and the count per platform. Dates default to the last 7 days (Beijing time) and reach back at most 90 days with since and until.
Cross-domain search
POST /v1/searchcurl https://api.qovia.ai/v1/search \ -H "Authorization: Bearer $QOVIA_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"品牌名","platforms":["weibo","douyin","xiaohongshu"],"sentiment":["negative"],"limit":10}'
import os import requests resp = requests.post( "https://api.qovia.ai/v1/search", json={ "query": "品牌名", "platforms": ["weibo", "douyin", "xiaohongshu"], "sentiment": ["negative"], "limit": 10, }, headers={"Authorization": f"Bearer {os.environ['QOVIA_KEY']}"}, timeout=30, ) resp.raise_for_status() body = resp.json() print(body["meta"]["charged_usd"], body["data"])
The data in the response. The sample comes from the endpoint catalog, not live data; lists are cut to their first two entries and picture links are left out:
{ "data": { "items": [ { "id": "soc_wei_e32e9c5a0c8f", "platform": "weibo", "site": "微博", "title": "“‘念PPT’其背后折射出的更多是教学态度、教学效果和课堂互动方面的问题。”中国教育发展战略学会人工智能与机器人...", "original_title": null, "text": "“‘念PPT’其背后折射出的更多是教学态度、教学效果和课堂互动方面的问题。”中国教育发展战略学会人工智能与机器人教育专业…", "summary": null, "url": "http://weibo.com/1700648435/RnISydWJo", "published_at": "2026-10-21T19:31:06+08:00", "type": "original", "sentiment": "neutral", "author": { "name": "成都商报", "followers": 25329072, "following": 947, "description": "《成都商报》是西部地区发行量和影响力最大的主流媒体。互联网新闻信息服务许可证：51120180004。" }, "ip_location": null, "location": "四川", "media": { "images": [], "videos": [ "http://weibo.com/1700648435/RnISydWJo" ] }, "repost_of": null, "metrics": { "likes": null, "comments": null, "shares": null, "views": 324, "saves": null } }, { "id": "web_new_bf22c963ec0e", "platform": "news", "site": "懂车帝", "title": "*ST易录：2026年第三季度净利润亏损1.54亿元", "original_title": null, "text": "同花顺各类信息服务基于人工智能算法，如有出入请以证监会指定上市公司信息披露平台为准。如有投资者据此操作，风险自担，同花顺…", "summary": null, "url": "https://www.dongchedi.com/article/7699080505556107818/", "published_at": "2026-10-21T19:24:45+08:00", "type": "original", "sentiment": "negative", "author": { "name": "同花顺财经", "followers": 1334032, "following": 22, "description": "股票金融信息资讯专家" }, "ip_location": "北京", "location": null, "media": { "images": [], "videos": [] }, "repost_of": null, "metrics": null } ], "total": 1966273, "by_platform": { "weibo": 119048, "douyin": 380189, "toutiao": 364539, "xiaohongshu": 52024, "short_video": 16111, "wechat": 234572, "news": 589995, "forum": 26994, "long_video": 9314, "app": 173500 }, "page": 1, "limit": 20, "has_more": true, "prov": { "hash": "0xb0ecb783f9c747ec", "ts": "2026-10-21T19:35:00+08:00", "source": "live" } } }Weibo: a date range
To read what was posted on Weibo on certain days, use Weibo search: pass start_date and end_date together, and choose type from all, hot, original, verified, media or viewpoint. Page with page, up to 50.
Weibo search
GET /v1/raw/weibo/searchcurl 'https://api.qovia.ai/v1/raw/weibo/search?keyword=%E5%93%81%E7%89%8C%E5%90%8D&start_date=2026-10-20&end_date=2026-10-21&type=original' \ -H "Authorization: Bearer $QOVIA_KEY"
Xiaohongshu: this week's newest notes
Xiaohongshu note search sorts by newest, most liked, most commented or most saved, and filters by note type and publish time (a day, a week, a month, a year). Each note has its title, an excerpt, the author and like, comment, save and share counts.
Xiaohongshu (RedNote) note search
GET /v1/raw/xiaohongshu/searchcurl 'https://api.qovia.ai/v1/raw/xiaohongshu/search?keyword=%E5%93%81%E7%89%8C%E5%90%8D&sort=latest¬e_time=week' \ -H "Authorization: Bearer $QOVIA_KEY"
Douyin: read a video's comments
Once you have a video (Douyin search, raw.douyin.search, returns them), read its comments with the video ID. Page with cursor, up to 50 a page; Douyin can reorder between pages, so adjacent pages can overlap and you should deduplicate by comment ID.
Douyin video comments
GET /v1/raw/douyin/commentscurl 'https://api.qovia.ai/v1/raw/douyin/comments?item_id=7681194457378688292' \ -H "Authorization: Bearer $QOVIA_KEY"
More endpoints for this
FAQ
Which sources does the cross-platform search cover?
Ten kinds of public sources in China: Weibo, Douyin, Toutiao, Xiaohongshu, Kuaishou and other short-video apps, WeChat official accounts, news sites and newspapers, forums, Tieba and Q&A sites, Bilibili and other long-video sites, and news apps. Choose some with platforms; all are searched by default.
How far back can I search?
The cross-platform search counts whole days in Beijing time: the last 7 days by default, and at most 90 days from since to until. Weibo search takes a date range in start_date and end_date.
Can I see only negative mentions?
Yes. The sentiment parameter of the cross-platform search takes any mix of negative, neutral and positive (all by default), and each result carries its sentiment.
How do I monitor continuously?
These endpoints answer the calls you make. For ongoing monitoring, run the same search on a schedule from your own job and compare it with the previous run.
How is it billed?
A new account gets 50 trial calls; after that, calls are billed from a prepaid balance, and only successful calls that return data are charged. Empty results and errors are not, and meta.charged_usd in each response says what the call cost. Each endpoint's price is in the API reference, and the plans are on the pricing page.
Your agent only knows what you give it
Give it Douyin, Xiaohongshu (RedNote), WeChat and product reviews: structured, per call, nothing charged for failures.