# Qovia — full documentation

> Qovia is a public web data API for AI agents and developers: 137 live HTTP endpoints across 21 platforms, one API key, one JSON envelope, and you only pay for successful calls that return data. This file is the complete public documentation as plain text; https://qovia.ai/llms.txt is the short index.

- Base URL: https://api.qovia.ai
- OpenAPI 3.1 spec: https://qovia.ai/openapi.json
- MCP server: https://api.qovia.ai/mcp (Streamable HTTP)
- Pricing: https://qovia.ai/pricing/
- Docs: https://qovia.ai/docs/ (Chinese: https://qovia.ai/zh/docs/)

## Authentication

Send `Authorization: Bearer <API key>` (or `x-api-key: <API key>`). Keys start with `sk-qovia-`; create them at https://qovia.ai/console/?tab=keys. A key can be limited to scopes:

- *: Every endpoint
- search: Cross-domain search
- raw:*: Every raw endpoint
- raw:douyin: Every Douyin raw endpoint
- raw:kuaishou: Every Kuaishou raw endpoint
- raw:bilibili: Every Bilibili raw endpoint
- raw:xingtu: Every Douyin Xingtu raw endpoint
- raw:tieba: Every Tieba raw endpoint
- raw:zhihu: Every Zhihu raw endpoint
- raw:wechat: Every WeChat Official Accounts & Channels raw endpoint
- raw:xiaohongshu: Every Xiaohongshu (RedNote) raw endpoint
- raw:pgy: Every Xiaohongshu Pugongying raw endpoint
- raw:tiktok: Every TikTok raw endpoint
- raw:youtube: Every YouTube raw endpoint
- raw:instagram: Every Instagram raw endpoint
- raw:x: Every X (Twitter) raw endpoint
- raw:reddit: Every Reddit raw endpoint
- raw:weibo: Every Weibo raw endpoint
- raw:toutiao: Every Toutiao raw endpoint
- raw:taobao: Every Taobao & Tmall raw endpoint
- raw:jd: Every JD.com raw endpoint
- raw:shopee: Every Shopee raw endpoint
- raw:amazon: Every Amazon raw endpoint
- raw:fliggy: Every Fliggy raw endpoint
- raw:news: Every News raw endpoint
- raw:cljx: Every Cili Juxing raw endpoint
- raw:huahuo: Every Huahuo raw endpoint

## Requests and responses

GET endpoints take query parameters; POST endpoints take a JSON object body. Unknown parameters are rejected with 400 invalid_params. A success is HTTP 200 with these fields:

- request_id (string): The call's ID (its usage record), also in the `X-Request-Id` header and in the console usage log.
- data (object | array | null): The endpoint's data; see each endpoint's response example. An empty result may be an empty structure (e.g. empty `items`) or `null`; check `meta.empty`.
- meta.billed (boolean): Whether this call was charged to the balance; `false` for empty results.
- meta.charged_usd (string): Amount charged in USD, 6 decimals; `"0.000000"` when nothing was charged.
- meta.balance_usd (string): Balance after settlement, USD, 6 decimals.
- meta.empty (boolean): The result is empty: not charged.

An error is `{"error": {...}}` with these fields, and is never charged unless stated below:

- error.code (string): The error code; see the error table. Branch on `code`.
- error.message (string): A short English explanation. One code can have several messages (the error table lists them all), so do not branch on it. Never contains the data source's own error text.
- error.request_id (string): Same as the `X-Request-Id` header (see below).
- error.support (string): Where to get help (Telegram); include the `request_id` so we can find the call.

## Billing

Currency: USD. A new account gets 50 trial calls on any endpoint (meta.trial_calls_remaining counts down); after that, a prepaid balance. Only successful calls that return data are charged; empty results (meta.empty: true) and errors are not. Each endpoint below states its price per successful call; https://qovia.ai/pricing/ has the plans.

## Rate limits

- 60 requests per 60 seconds per account, 600 after the first top-up.
- Honour the Retry-After header on 429 responses.

## Errors

- invalid_api_key (HTTP 401; not charged): The API key is missing, malformed, unknown, revoked or expired.
- too_many_auth_failures (HTTP 429; not charged): 30 failed authentications from this IP within a minute; try again in 60 seconds.
- account_disabled (HTTP 403; not charged): The account is disabled.
- payload_too_large (HTTP 413; not charged): The request body is over 64 KiB; nothing ran.
- endpoint_not_found (HTTP 404; not charged): No such endpoint; check the method and path.
- method_not_allowed (HTTP 405; not charged): The path exists but takes another method; the `Allow` header names it.
- endpoint_disabled (HTTP 410; not charged): The endpoint has been retired.
- scope_denied (HTTP 403; not charged): This API key lacks the scope the endpoint requires.
- endpoint_unavailable (HTTP 503; not charged): The endpoint is not available right now (no data source connected yet, or no price configured); nothing ran.
- invalid_params (HTTP 400; not charged): The parameters failed validation: a required one is missing, a type or format is wrong, an array has more items than allowed, an unknown one was sent, or the POST body is not a JSON object. An error in one parameter starts with its name (`item_id: …`); a missing or unknown parameter starts with `params: …`.
- rate_limited (HTTP 429; not charged): Over the account's per-minute limit (sliding 60-second window); wait for `Retry-After`.
- too_many_unbilled (HTTP 429; not charged): In the last 10 minutes at least 50 of your calls to data sources, and over 80% of them, came back empty, not found or rejected; slow down.
- endpoint_busy (HTTP 429; not charged): The endpoint's per-second capacity across all users is full; retry in 1 second. This does not count toward your per-minute limit.
- insufficient_balance (HTTP 402; not charged): The balance cannot pay for this call; top up first.
- upstream_busy (HTTP 503; refunded): The data source is busy or cooling down; refunded. Retry after `Retry-After`.
- upstream_timeout (HTTP 504; refunded): The data source timed out; refunded.
- upstream_error (HTTP 502 / 503; refunded): The data source failed; refunded.
- upstream_rejected (HTTP 400; refunded): The data source rejected these parameters (well-formed, but not accepted); refunded.
- not_found (HTTP 404; refunded): The data source has no such item (deleted, or the ID does not exist); refunded.
- reservation_expired (HTTP 504; refunded): The call took too long and was refunded automatically; no data is returned.

## MCP

Add the server to Claude Code with `claude mcp add --transport http qovia https://api.qovia.ai/mcp`. Finding and reading endpoints needs no key; calling them needs your API key as `Authorization: Bearer <API key>`. Tools: search_endpoints, get_endpoint, call_endpoint, get_account. Calls are billed exactly like the HTTP API. Setup for Cursor, VS Code and others: https://qovia.ai/docs/mcp/.

## Platform pages

- Douyin API: https://qovia.ai/douyin-api/
- Douyin MCP server: https://qovia.ai/mcp/douyin/
- Xiaohongshu (RedNote) API: https://qovia.ai/xiaohongshu-api/
- Xiaohongshu (RedNote) MCP server: https://qovia.ai/mcp/xiaohongshu/
- Weibo API: https://qovia.ai/weibo-api/
- Weibo MCP server: https://qovia.ai/mcp/weibo/
- Kuaishou API: https://qovia.ai/kuaishou-api/
- Kuaishou MCP server: https://qovia.ai/mcp/kuaishou/
- Bilibili API: https://qovia.ai/bilibili-api/
- Bilibili MCP server: https://qovia.ai/mcp/bilibili/
- WeChat Official Accounts & Channels API: https://qovia.ai/wechat-api/
- WeChat Official Accounts & Channels MCP server: https://qovia.ai/mcp/wechat/
- Zhihu API: https://qovia.ai/zhihu-api/
- Zhihu MCP server: https://qovia.ai/mcp/zhihu/

## Use cases

Each page walks through real calls to the endpoints named here (and in Chinese under /zh/):

- Brand monitoring: https://qovia.ai/use-cases/brand-monitoring/ — Track mentions of a brand on Weibo, Douyin and Xiaohongshu with cross-platform search, platform search and comment endpoints. Endpoints: search, raw.weibo.search, raw.xiaohongshu.search, raw.douyin.comments.
- Creator research: https://qovia.ai/use-cases/creator-research/ — Find creators by keyword, then read their profile, recent posts and audience to shortlist KOLs. Endpoints: raw.douyin.user_search, raw.douyin.creator, raw.douyin.creator_videos, raw.xiaohongshu.user_notes, raw.xingtu.author_audience.
- Hot lists and trends: https://qovia.ai/use-cases/china-trends/ — Read Douyin hot search, Weibo hot search and the Zhihu hot list, then dig into one topic with search. Endpoints: raw.douyin.hot_search, raw.weibo.hot_search, raw.zhihu.hot_list, search.
- AI agents: https://qovia.ai/use-cases/ai-agents/ — Give AI agents such as Claude Code and Cursor Chinese social media data through MCP, or wrap the HTTP endpoints as tools. Endpoints: raw.weibo.hot_search.
- All use cases: https://qovia.ai/use-cases/

## Endpoints

## Search

### POST /v1/search — Cross-domain search

ID: search. Docs: https://qovia.ai/docs/api-reference/search/
One search across 10 kinds of public sources in China (Weibo, Douyin, Toutiao, Xiaohongshu, Kuaishou and other short-video apps, WeChat official accounts, news sites and newspapers, forums and Tieba, Bilibili and other long-video sites, news apps), filtered by date, platform, content type and sentiment. Returns the results in one format, with the total hit count and the count per platform. Dates are whole days in Beijing time: the last 7 days by default, at most 90. 10 or 20 results per page, up to page 50. A search usually takes a few seconds. No results answers empty and is not charged.
Price: $0.005000 per successful call. Status: live.
Parameters:
- query (required; string; min length 1; max length 200): What to search for. Separate terms with spaces to require all of them, as in 人工智能 教育; put words to leave out in exclude_words
- platforms (optional; array; default ["weibo","douyin","toutiao","xiaohongshu","short_video","wechat","news","forum","long_video","app"]): Only these platforms, all by default: weibo, douyin, toutiao, xiaohongshu, short_video (Kuaishou and other short-video apps), wechat (official accounts), news (news sites and newspapers), forum (forums, Tieba and Q&A sites), long_video (Bilibili and other long-video sites), app (news apps)
- since (optional; string): First day, YYYY-MM-DD (Beijing time, included); defaults to 6 days before until
- until (optional; string): Last day, YYYY-MM-DD (Beijing time, included); defaults to today and cannot be later. since to until spans at most 90 days
- types (optional; array; default ["original","repost","comment"]): Content types, all by default: original, repost, comment
- sentiment (optional; array; default ["negative","neutral","positive"]): Sentiment, all by default: negative, neutral, positive
- match (optional; array; default ["title","content","author"]): Where the search terms must match, title, content and author by default: title, content, author (author name), media_text (images and video frames), audio
- exclude_words (optional; string; max length 100): Filter words; results that contain them are left out
- author (optional; string; max length 50): Only content published by this author (account name)
- page (optional; integer; default 1; min 1; max 50): Page number, from 1, at most 50
- limit (optional; integer; one of 10, 20; default 20): Results per page: 10 or 20
Example request: curl -X POST https://api.qovia.ai/v1/search -H "Authorization: Bearer $QOVIA_KEY" -H "Content-Type: application/json" -d '{"query":"人工智能"}'
Example response (the "data" field): {"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。","avatar":"https://tvax3.sinaimg.cn/crop.0.0.1000.1000.50/001R5Kltly8h8vghc7zenj60rs0rsjsz02.jpg?KID=imgbed,tva&Expires=1792593090&ssig=E8HZxs%2Frbc"},"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":"股票金融信息资讯专家","avatar":"https://sf3-cdn-tos.toutiaostatic.com/img/user-avatar/2x_16286e5ac29b80d8e23428a6d5b72b9e~1080x1080.image"},"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"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

## Douyin

### GET /v1/raw/douyin/video — Douyin video detail

ID: raw.douyin.video. Docs: https://qovia.ai/docs/api-reference/raw.douyin.video/
Metadata and engagement metrics for one video.
Price: $0.000500 per successful call. Status: live.
Parameters:
- item_id (required; string): Video ID (aweme_id)
Example request: curl -G "https://api.qovia.ai/v1/raw/douyin/video?item_id=7681194457378688292" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_dou_3f9a1c27b0e4","src":"social","platform":"douyin","lang":"zh-CN","text":"新能源车续航实测，冬天打几折…","author":{"uid_hash":"a19c04e7d2b3","followers":482100,"nickname":"车评老王","uid":"108800000001","sec_uid":"MS4wLjABAAAAexampleCreatorSecUid0000000000000001","unique_id":"chepinglaowang"},"metrics":{"likes":120384,"comments":8217,"shares":5093,"saves":14022,"plays":2310000},"extra":{"video_dur_s":47,"topic":"#新能源","source_id":"7681000000000000001","published_at":"2026-10-18T19:30:55+08:00","topics":["新能源","冬季续航"],"content_type":"video","cover_url":"https://p3-sign.douyinpic.com/tos-cn-i-0813/example~tplv-dy-resize-origshort-autoq-75:330.jpeg","url":"https://www.douyin.com/video/7681000000000000001"},"prov":{"hash":"0x527bcbac1d09e4f6","ts":"2026-10-20T09:12:41+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/douyin/comments — Douyin video comments

ID: raw.douyin.comments. Docs: https://qovia.ai/docs/api-reference/raw.douyin.comments/
Comment tree for a video, cursor-paginated, up to 50 per page.
Price: $0.000500 per successful call. Status: live.
Parameters:
- item_id (required; string): Video ID (aweme_id)
- cursor (optional; integer; default 0; min 0): The cursor from the previous page's response. Douyin may reorder between pages, so adjacent pages can overlap; deduplicate by cid
- count (optional; integer; default 20; min 1; max 50): Items per page
Example request: curl -G "https://api.qovia.ai/v1/raw/douyin/comments?item_id=7681194457378688292" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"cid":"7688288247533732657","text":"电池衰减才是关键","likes":932,"ip_location":"北京","reply_count":41,"created_at":"2026-10-18T21:04:17+08:00","is_hot":true,"images":[],"author":{"uid_hash":"5be1f0a9c3d7","nickname":"夜跑的阿杰","uid":"93100000001","sec_uid":"MS4wLjABAAAAexampleCommenterSecUid00000000001","unique_id":"yepao_ajie"}},{"cid":"7688301125409981234","text":"北方实测来了…","likes":517,"ip_location":"黑龙江","reply_count":12,"created_at":"2026-10-18T22:41:09+08:00","is_hot":false,"images":[],"author":{"uid_hash":"0c7d2e94b1fa","nickname":"哈尔滨老司机","uid":"93100000002","sec_uid":"MS4wLjABAAAAexampleCommenterSecUid00000000002","unique_id":null}}],"cursor":20,"has_more":true,"total":2513,"prov":{"hash":"0x9e2b47c01a6f3d58","ts":"2026-10-20T12:11:16+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/douyin/creator — Douyin creator profile

ID: raw.douyin.creator. Docs: https://qovia.ai/docs/api-reference/raw.douyin.creator/
Creator profile with followers, likes, post count and verification.
Price: $0.000500 per successful call. Status: live.
Parameters:
- user_id (required; string): The user's sec_uid (starts with MS4wLjABAAAA; Douyin rejects numeric uids)
Example request: curl -G "https://api.qovia.ai/v1/raw/douyin/creator?user_id=MS4wLjABAAAAAKgMNYSx2pL3ARundki9oB8pmdvX9hVgujii5bnZUXs" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"uid_hash":"a19c04e7d2b3","nickname":"车评老王","followers":482100,"total_likes":9820311,"posts":612,"verified":true,"platform":"douyin","uid":"108800000001","sec_uid":"MS4wLjABAAAAexampleCreatorSecUid0000000000000001","unique_id":"chepinglaowang","following":357,"signature":"十年汽车媒体人，只说真话。","ip_location":"北京","verify_reason":"汽车自媒体","avatar_url":"https://p3-pc.douyinpic.com/aweme/1080x1080/aweme-avatar/example.jpeg","url":"https://www.douyin.com/user/MS4wLjABAAAAexampleCreatorSecUid0000000000000001","prov":{"hash":"0x0d6c51e3a8b2f497","ts":"2026-10-20T12:11:38+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/douyin/comment_replies — Douyin comment replies

ID: raw.douyin.comment_replies. Docs: https://qovia.ai/docs/api-reference/raw.douyin.comment_replies/
Replies under one comment, cursor-paginated, up to 50 per page, with reply target, IP region and likes.
Price: $0.000500 per successful call. Status: live.
Parameters:
- item_id (required; string): Video ID (aweme_id)
- comment_id (required; string): Parent comment cid (from the video comments endpoint)
- cursor (optional; integer; default 0; min 0): The cursor from the previous page's response
- count (optional; integer; default 20; min 1; max 50): Items per page
Example request: curl -G "https://api.qovia.ai/v1/raw/douyin/comment_replies?item_id=7681194457378688292&comment_id=7682268648353825585" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"cid":"7683888192056476475","text":"同意，三年后的残值更关键","likes":214,"ip_location":"江苏","reply_count":null,"created_at":"2026-10-12T08:15:40+08:00","is_hot":false,"images":[],"author":{"uid_hash":"7a40c2e18d5b","nickname":"南京车友小周","uid":"93100000003","sec_uid":"MS4wLjABAAAAexampleCommenterSecUid00000000003","unique_id":null},"parent_cid":"7682268648353825585","reply_to_cid":null}],"cursor":10,"has_more":true,"total":323,"prov":{"hash":"0x41d8a0e6b72c95f3","ts":"2026-10-20T12:11:31+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/douyin/search — Douyin search

ID: raw.douyin.search. Docs: https://qovia.ai/docs/api-reference/raw.douyin.search/
Keyword search over videos and image posts as unified records (same ids as video detail); pass the previous cursor and search_id to page.
Price: $0.000500 per successful call. Status: live.
Parameters:
- keyword (required; string; min length 1; max length 100): Search keyword
- cursor (optional; integer; default 0; min 0; max 1000): The cursor from the previous page's response
- search_id (optional; string): The search_id from the previous page's response; required when cursor is above 0
- count (optional; integer; default 10; min 1; max 50): Items per page
Example request: curl -G "https://api.qovia.ai/v1/raw/douyin/search?keyword=%E6%96%B0%E8%83%BD%E6%BA%90%E6%B1%BD%E8%BD%A6" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_dou_3f9a1c27b0e4","src":"social","platform":"douyin","lang":"zh-CN","text":"新能源车续航实测，冬天打几折…","author":{"uid_hash":"a19c04e7d2b3","followers":null,"nickname":"车评老王","uid":"108800000001","sec_uid":"MS4wLjABAAAAexampleCreatorSecUid0000000000000001","unique_id":null},"metrics":{"likes":120384,"comments":8217,"shares":5093,"saves":14022},"extra":{"source_id":"7681000000000000001","published_at":"2026-10-18T19:30:55+08:00","video_dur_s":47,"topic":"#新能源","topics":["新能源"],"content_type":"video","cover_url":"https://p3-sign.douyinpic.com/tos-cn-i-0813/example~tplv-dy-resize-origshort-autoq-75:330.jpeg","url":"https://www.douyin.com/video/7681000000000000001"},"prov":{"hash":"0x527bcbac1d09e4f6","ts":"2026-10-20T12:10:24+08:00","source":"live"}}],"cursor":10,"has_more":true,"search_id":"20261020121024A1B2C3D4E5F60718293A","prov":{"hash":"0x8f03b6d2e471ac95","ts":"2026-10-20T12:10:24+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/douyin/user_search — Douyin user search

ID: raw.douyin.user_search. Docs: https://qovia.ai/docs/api-reference/raw.douyin.user_search/
Keyword search for creators with nickname, sec_uid, followers, likes and verification, about 12 per page.
Price: $0.000500 per successful call. Status: live.
Parameters:
- keyword (required; string; min length 1; max length 100): Search keyword
- cursor (optional; integer; default 0; min 0; max 1000): The cursor from the previous page's response
Example request: curl -G "https://api.qovia.ai/v1/raw/douyin/user_search?keyword=%E6%B1%BD%E8%BD%A6%E8%AF%84%E6%B5%8B" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"uid_hash":"a19c04e7d2b3","nickname":"车评老王","uid":"108800000001","sec_uid":"MS4wLjABAAAAexampleCreatorSecUid0000000000000001","unique_id":"chepinglaowang","followers":482100,"total_likes":9820311,"verified":true,"verify_reason":"汽车自媒体","signature":"十年汽车媒体人，只说真话。","avatar_url":"https://p3-pc.douyinpic.com/aweme/100x100/aweme-avatar/example.jpeg","url":"https://www.douyin.com/user/MS4wLjABAAAAexampleCreatorSecUid0000000000000001"}],"cursor":12,"has_more":true,"prov":{"hash":"0x6a1e9c03b5d7f284","ts":"2026-10-20T12:12:09+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/douyin/live_search — Douyin live search

ID: raw.douyin.live_search. Docs: https://qovia.ai/docs/api-reference/raw.douyin.live_search/
Keyword search for live rooms with title, current and total viewers, likes and host, about 15 per page.
Price: $0.000500 per successful call. Status: live.
Parameters:
- keyword (required; string; min length 1; max length 100): Search keyword
- cursor (optional; integer; default 0; min 0; max 1000): The cursor from the previous page's response
Example request: curl -G "https://api.qovia.ai/v1/raw/douyin/live_search?keyword=%E6%B1%BD%E8%BD%A6" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"room_id":"7698502048890760000","title":"新车到店，限时权益讲解","is_live":true,"viewers":295,"total_viewers":30837,"likes":106783,"started_at":"2026-10-20T06:00:02+08:00","cover_url":"https://p3-webcast-sign.douyinpic.com/webcast-cover/example.image","url":"https://live.douyin.com/151100000000","author":{"uid_hash":"2be95d07c4a1","nickname":"某汽车品牌官方","uid":"2992200000000001","sec_uid":"MS4wLjABAAAAexampleLiveHostSecUid000000000001","followers":329600,"verified":true,"verify_reason":"商家认证账号"}}],"cursor":15,"has_more":true,"prov":{"hash":"0x3c58e1f0a92b6d47","ts":"2026-10-20T12:12:31+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/douyin/goods_comments — Douyin product reviews

ID: raw.douyin.goods_comments. Docs: https://qovia.ai/docs/api-reference/raw.douyin.goods_comments/
Buyer reviews of a Douyin shop product with rating, text, SKU, tags and seller reply, 20 per page.
Price: $0.000500 per successful call. Status: live.
Parameters:
- goods_id (required; string): Douyin shop product ID (product_id)
- cursor (optional; integer; default 0; min 0; max 500): Page number, from 0; the cursor from the previous page's response
Example request: curl -G "https://api.qovia.ai/v1/raw/douyin/goods_comments?goods_id=3827812353530004447" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"cid":"2575695783160660259","text":"质地很温和，宝宝用着没有不舒服","rating":5,"ratings":{"product":5,"logistics":null,"shop":null},"likes":3,"created_at":"2026-10-20T09:08:16+08:00","sku":"默认","user_name":"西**r","anonymous":false,"shop_reply":"感谢您的支持，期待再次光临！","tags":["粉丝团"],"keywords":["物美价廉"]}],"cursor":1,"has_more":true,"total":24,"prov":{"hash":"0x75b0d3e9a14c2f68","ts":"2026-10-20T12:11:38+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/douyin/creator_videos — Douyin creator videos

ID: raw.douyin.creator_videos. Docs: https://qovia.ai/docs/api-reference/raw.douyin.creator_videos/
Posts a creator published, pinned ones first and then newest first (or most popular first), about 20 a page, as the same records as video detail (same ids). Pass the previous page's cursor back to continue; stop when has_more is false. A creator without posts, or one that does not exist, answers empty and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- user_id (required; string): The user's sec_uid (starts with MS4wLjABAAAA; Douyin rejects numeric uids)
- cursor (optional; integer; default 0; min 0): The cursor from the previous page's response; 0 for the first page
- sort (optional; string; one of "latest", "popular"; default "latest"): Order: latest (the default) or popular
Example request: curl -G "https://api.qovia.ai/v1/raw/douyin/creator_videos?user_id=MS4wLjABAAAAAKgMNYSx2pL3ARundki9oB8pmdvX9hVgujii5bnZUXs" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_dou_e15ee224d064","src":"social","platform":"douyin","lang":"zh-CN","text":"小马长成了小马哥 静态体验奔腾小马五门版 曾经让鲍师傅爱不释手的奔腾小马，竟然推出了加长的五座版，不仅是尺寸的升级，更是把使用痛点进行了全面的消除，小马终于长成了小马哥。#奔腾小马…","author":{"uid_hash":"d6f636c1d58b","followers":null,"nickname":"爱车的BAO师傅","uid":"108882376804","sec_uid":"MS4wLjABAAAAAKgMNYSx2pL3ARundki9oB8pmdvX9hVgujii5bnZUXs","unique_id":"dydyttmfh8s2"},"metrics":{"likes":10,"comments":5,"shares":6,"saves":3},"extra":{"source_id":"7698963081988181257","published_at":"2026-10-21T11:48:54+08:00","video_dur_s":425,"topic":"#奔腾小马","topics":["奔腾小马","奔腾小马五门版","小马哥","小车"],"content_type":"video","cover_url":"https://p3-sign.douyinpic.com/tos-cn-i-dy/da35ff97007541d0a3d61badb24d451f~tplv-dy-resize-walign-adapt-aq:540:q75.heic?lk3s=138a59ce&x-expires=1793804400&x-signature=4JgHOHab8Ibp8B24hkrPRKernM4%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=false&sc=cover&biz_tag=aweme_video&l=20261021235008414FF27B970EAEBE0909","url":"https://www.douyin.com/video/7698963081988181257"},"prov":{"hash":"0x91eadd340b12fce9","ts":"2026-10-21T23:50:08+08:00","source":"live"}},{"id":"soc_dou_5d11adb275ac","src":"social","platform":"douyin","lang":"zh-CN","text":"不要被外表欺骗这可是个狠角色 体验星钽5X 通常高颜值不意味着高性能，但星钽5X是个例外，特别是开上非铺装路面，这辆车才展现出它的真实实力。#北汽星钽5X #星钽5X #越野 #方…","author":{"uid_hash":"d6f636c1d58b","followers":null,"nickname":"爱车的BAO师傅","uid":"108882376804","sec_uid":"MS4wLjABAAAAAKgMNYSx2pL3ARundki9oB8pmdvX9hVgujii5bnZUXs","unique_id":"dydyttmfh8s2"},"metrics":{"likes":13,"comments":2,"shares":0,"saves":1},"extra":{"source_id":"7698752037126802723","published_at":"2026-10-20T22:10:09+08:00","video_dur_s":678,"topic":"#北汽星钽5X","topics":["北汽星钽5X","星钽5X","越野","方盒子"],"content_type":"video","cover_url":"https://p3-sign.douyinpic.com/tos-cn-i-dy/5c2e9d385b1646f9b459007b94ad63d7~tplv-dy-resize-walign-adapt-aq:540:q75.heic?lk3s=138a59ce&x-expires=1793804400&x-signature=UZNm9x9JOTe1MNWDNA9zlRfW24M%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=false&sc=cover&biz_tag=aweme_video&l=20261021235008414FF27B970EAEBE0909","url":"https://www.douyin.com/video/7698752037126802723"},"prov":{"hash":"0x755e43a674c7d2c1","ts":"2026-10-21T23:50:08+08:00","source":"live"}}],"cursor":1790514095000,"has_more":true,"prov":{"hash":"0xe81616f943e8d846","ts":"2026-10-21T23:50:08+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/douyin/hot_search — Douyin hot search board

ID: raw.douyin.hot_search. Docs: https://qovia.ai/docs/api-reference/raw.douyin.hot_search/
Douyin's hot search board: its pinned entry and about 50 ranked words, with rank, heat, views, related video count, label (new, hot, first, exclusive, challenge, debunk), time it entered and cover. The whole board in one answer, not paginated.
Price: $0.001000 per successful call. Status: live.
Parameters: none.
Example request: curl -G "https://api.qovia.ai/v1/raw/douyin/hot_search" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"rank":null,"word":"我们的长征路","hot_value":null,"views":null,"video_count":null,"label":null,"pinned":true,"event_at":null,"cover_url":null,"sentence_id":"2706469","url":"https://www.douyin.com/hot/2706469"},{"rank":1,"word":"国台办回应张凌赫赴台交流被拒","hot_value":11171737,"views":61886247,"video_count":5,"label":"hot","pinned":false,"event_at":"2026-10-21T10:34:53+08:00","cover_url":"https://p26-sign.douyinpic.com/tos-cn-p-0015/o0fBZ0GFLB3VsIYAe7PkACIBuvwggaKeAVEhuI~noop.jpeg?lk3s=bfd515bb&x-expires=1792616400&x-signature=%2FhMJAg9hJ%2BS4WvIxEcPl2HofYvg%3D&from=3218412987","sentence_id":"2705737","url":"https://www.douyin.com/hot/2705737"},{"rank":2,"word":"台风蔷琵正向我国方向靠近","hot_value":10909673,"views":64390592,"video_count":6,"label":"hot","pinned":false,"event_at":"2026-10-21T14:36:53+08:00","cover_url":"https://p9-sign.douyinpic.com/tos-cn-p-0015c000-ce/ok2EeyqMBX9bEwOAFFALxEIDYwKo2ggBpFfZLv~noop.jpeg?lk3s=bfd515bb&x-expires=1792616400&x-signature=7X4CIk7Y7m5fGAXSCkfsAl5XMRQ%3D&from=3218412987","sentence_id":"2706231","url":"https://www.douyin.com/hot/2706231"}],"cursor":null,"has_more":false,"updated_at":"2026-10-21T23:47:40+08:00","prov":{"hash":"0x27537f2e5ddc2017","ts":"2026-10-21T23:51:06+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/douyin/challenge_videos — Douyin hashtag videos

ID: raw.douyin.challenge_videos. Docs: https://qovia.ai/docs/api-reference/raw.douyin.challenge_videos/
Posts under one hashtag, as the same records as video detail (same ids), about 10 a page; sort by relevance, most liked or latest. Pass the previous page's cursor back to continue; stop when has_more is false. A hashtag that does not exist answers 404 and one without posts answers empty, neither charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- challenge_id (required; string): Hashtag ID (the number in douyin.com/hashtag/<ID>)
- cursor (optional; integer; default 0; min 0; max 10000): The cursor from the previous page's response; 0 for the first page
- sort (optional; string; one of "general", "most_liked", "latest"; default "general"): Order: general (relevance, the default), most_liked or latest
Example request: curl -G "https://api.qovia.ai/v1/raw/douyin/challenge_videos?challenge_id=1600076256429059" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_dou_812df8b3c827","src":"social","platform":"douyin","lang":"zh-CN","text":"最新！小鹏汽车官方回应苏州车祸事故… 小鹏汽车对此事件官方回应:对于该事故造成的人员及车辆损伤感到非常痛心。在后台接到碰撞告警后，小鹏汽车第一时间进行外呼并协调当地区域人员赶赴事故…","author":{"uid_hash":"0dab4fe0480b","followers":null,"nickname":"杭州日报","uid":"1151906078000839","sec_uid":"MS4wLjABAAAA9W4qYBkRHeKu4l-acUw0l8nmdHGbOO5FBsIDPDbg3cPFwo6u7NzDstlh9b6n3NrZ","unique_id":"hangzhouribao"},"metrics":{"likes":1281304,"comments":298837,"shares":1765034,"saves":74741},"extra":{"source_id":"7340931711024254248","published_at":"2024-02-29T16:04:31+08:00","video_dur_s":16,"topic":"#江苏","topics":["江苏","新能源汽车"],"content_type":"video","cover_url":"https://p3-sign.douyinpic.com/tos-cn-i-0813c001/oMfBGH5wyIPsc6AAUcAA2bHfLAQx76fBGARHdE~tplv-dy-resize-walign-adapt-aq:360:q75.heic?lk3s=138a59ce&x-expires=1793804400&x-signature=80Nq1e9C6FtPwUKmCyLx8E1YGJY%3D&from=327834062&s=PackSourceEnum_CHALLENGE_AWEME&se=false&sc=cover&biz_tag=aweme_video&l=20261021235148CFA6034E28E05CB94920","url":"https://www.douyin.com/video/7340931711024254248"},"prov":{"hash":"0x88a74c6881d13ed6","ts":"2026-10-21T23:51:50+08:00","source":"live"}},{"id":"soc_dou_f6deba33309f","src":"social","platform":"douyin","lang":"zh-CN","text":"历史性的时刻！宁德时代引爆能源革命，石油霸权真要熄火了？#科普#财经 #新能源汽车 ","author":{"uid_hash":"13e5c0bd986d","followers":null,"nickname":"直男财经","uid":"2260189412334318","sec_uid":"MS4wLjABAAAADUObyc_aoKXnXnV01JEcZMdvU0_ZFvFnVQAU-weztOgHubCQont1aDrDASxWu8B6","unique_id":"zhinancaijing"},"metrics":{"likes":1153888,"comments":43647,"shares":40343,"saves":10263},"extra":{"source_id":"6993383574028258574","published_at":"2021-08-07T07:00:00+08:00","video_dur_s":278,"topic":"#科普","topics":["科普","财经","新能源汽车"],"content_type":"video","cover_url":"https://p3-sign.douyinpic.com/tos-cn-p-0015/0d72e408b6954a7fbdddddea86b6c36b~tplv-dy-resize-walign-adapt-aq:360:q75.heic?lk3s=138a59ce&x-expires=1793804400&x-signature=MewF7Su3aMWTbVu7TKDdrrc8gao%3D&from=327834062&s=PackSourceEnum_CHALLENGE_AWEME&se=false&sc=cover&biz_tag=aweme_video&l=20261021235148CFA6034E28E05CB94920","url":"https://www.douyin.com/video/6993383574028258574"},"prov":{"hash":"0x6b1b575d8bb95ec9","ts":"2026-10-21T23:51:50+08:00","source":"live"}}],"cursor":10,"has_more":true,"prov":{"hash":"0x23d8f85b9c639bc2","ts":"2026-10-21T23:51:50+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

## Kuaishou

### GET /v1/raw/kuaishou/video — Kuaishou video detail

ID: raw.kuaishou.video. Docs: https://qovia.ai/docs/api-reference/raw.kuaishou.video/
One Kuaishou post: caption, author (numeric uid, eid and Kuaishou ID), play / like / comment / share / save counts, hashtags, publish time (Beijing time), duration, cover and link. Pass the post's eid (the part of its link, such as 3xry7mhn2ywjyqg); the numeric photo_id is not accepted. A post that does not exist or was deleted answers 404 and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- video_id (required; string): The post's eid (from www.kuaishou.com/short-video/<eid>; a post record's extra.eid)
Example request: curl -G "https://api.qovia.ai/v1/raw/kuaishou/video?video_id=3xry7mhn2ywjyqg" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_kua_892e0d923045","src":"social","platform":"kuaishou","lang":"zh-CN","text":"绝 望 鸭 脖","author":{"uid_hash":"ec1f004e8813","followers":null,"nickname":"权少爱吃小汉堡🍔","uid":"228905802","eid":"3xz63mn6fngqtiq","unique_id":"quanshaogmod"},"metrics":{"likes":536223,"comments":33273,"shares":203274,"saves":141600,"plays":9258156},"extra":{"source_id":"5220235068916084263","eid":"3xry7mhn2ywjyqg","published_at":"2024-12-13T17:17:22+08:00","video_dur_s":23,"topic":null,"topics":[],"content_type":"video","cover_url":"https://ws2.a.kwimgs.com/upic/2024/12/13/17/BMjAyNDEyMTMxNzE2NDFfMjI4OTA1ODAyXzE1MTA0ODI0NzI0N18yXzM=_hd_Be0f7de6d81e02b08996d9b43b1a8bb62.kvif?tag=1-1792597682-sp-0-knz0inf6a6-d3a11a040b0c8138&type=hot&clientCacheKey=3xry7mhn2ywjyqg_hd.kvif&di=4c9d6c8d&bp=10321","ip_location":null,"url":"https://www.kuaishou.com/short-video/3xry7mhn2ywjyqg"},"prov":{"hash":"0xae1f5e598aff2701","ts":"2026-10-21T23:50:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/kuaishou/comments — Kuaishou video comments

ID: raw.kuaishou.comments. Docs: https://qovia.ai/docs/api-reference/raw.kuaishou.comments/
First-level comments of a post, cursor-paginated (about 30 on the first page, then about 20): text, likes, reply count, IP location, time (Beijing time), whether it is a hot comment, whether the creator liked it, comment images and the commenter. Pass the previous page's cursor back to continue; stop when has_more is false. Replies come from raw.kuaishou.comment_replies. A post without comments, or one that does not exist, answers empty and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- video_id (required; string): The post's eid (a post record's extra.eid)
- cursor (optional; string): The cursor from the previous page's response; leave out for the first page
Example request: curl -G "https://api.qovia.ai/v1/raw/kuaishou/comments?video_id=3xry7mhn2ywjyqg" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"cid":"930503828225","text":"知道为什么他在中间吗？","likes":8029,"ip_location":"浙江","reply_count":315,"created_at":"2024-12-13T19:44:09+08:00","is_hot":true,"liked_by_author":false,"images":["https://p23-plat.wsukwai.com/kimg/EL7M1y8qHQoFaW1hZ2USB2NvbW1lbnQaCzh5TnNfelRPVUFz.heif"],"author":{"uid_hash":"7f5649c75ecd","nickname":"绝***丑","uid":"1000000001","eid":null,"unique_id":null}},{"cid":"1182321872417","text":"你终于来了","likes":73,"ip_location":"新疆","reply_count":30,"created_at":"2026-10-02T22:56:30+08:00","is_hot":true,"liked_by_author":false,"images":["https://p23-plat.wsukwai.com/kimg/EL7M1y8qIQoFaW1hZ2USB2NvbW1lbnQaD3pFekRqNUl4TElVLmpwZw.heif"],"author":{"uid_hash":"cf94093b6381","nickname":"l***k","uid":"1000000002","eid":null,"unique_id":null}}],"cursor":"V2#afffa92b-e09a-4398-b60e-728051c274a4#dph#30#1074226454740_30","has_more":true,"total":33273,"prov":{"hash":"0xbd89c98343292ae8","ts":"2026-10-21T23:50:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/kuaishou/comment_replies — Kuaishou comment replies

ID: raw.kuaishou.comment_replies. Docs: https://qovia.ai/docs/api-reference/raw.kuaishou.comment_replies/
Replies under one first-level comment, cursor-paginated, about 12 a page: text, likes, IP location, time (Beijing time), the user replied to, and the replier. Pass the previous page's cursor back to continue; stop when has_more is false. Kuaishou reports no reply total. A comment without replies answers empty and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- video_id (required; string): The post's eid (a post record's extra.eid)
- comment_id (required; string): The first-level comment's cid (from the video comments endpoint)
- cursor (optional; string): The cursor from the previous page's response; leave out for the first page
Example request: curl -G "https://api.qovia.ai/v1/raw/kuaishou/comment_replies?video_id=3xry7mhn2ywjyqg&comment_id=930503828225" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"cid":"930503985009","text":"对了，还有一个","likes":5487,"ip_location":"浙江","reply_count":null,"created_at":"2024-12-13T19:44:25+08:00","is_hot":false,"liked_by_author":false,"images":["https://p23-plat.wsukwai.com/kimg/EL7M1y8qHQoFaW1hZ2USB2NvbW1lbnQaC3dPR3FMdEJBTksw.heif"],"author":{"uid_hash":"7f5649c75ecd","nickname":"绝***丑","uid":"1000000001","eid":null,"unique_id":null},"parent_cid":"930503828225","reply_to":{"uid_hash":"7f5649c75ecd","nickname":"绝***丑","uid":"1000000001"}},{"cid":"930704238063","text":"[柴犬]","likes":0,"ip_location":"四川","reply_count":null,"created_at":"2024-12-14T08:32:21+08:00","is_hot":false,"liked_by_author":false,"images":[],"author":{"uid_hash":"eef9d45fc700","nickname":"用***机","uid":"1000000003","eid":null,"unique_id":null},"parent_cid":"930503828225","reply_to":{"uid_hash":"b29983256aaa","nickname":"H***9","uid":"1000000004"}}],"cursor":"930909643517","has_more":true,"total":null,"prov":{"hash":"0x1ed3ead45b4c1395","ts":"2026-10-21T23:50:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/kuaishou/creator_hot_videos — Kuaishou creator hot videos

ID: raw.kuaishou.creator_hot_videos. Docs: https://qovia.ai/docs/api-reference/raw.kuaishou.creator_hot_videos/
A creator's hot posts, most liked first, 20 a page, as the same records as video detail (same ids). Pass the numeric uid (the author.uid of a post or comment record). Pass the previous page's cursor back to continue; stop when has_more is false. A creator without posts, or a user that does not exist, answers empty and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- uid (required; string): The user's numeric uid (the author.uid of a post or comment record), not the eid
- cursor (optional; string): The cursor from the previous page's response; leave out for the first page
Example request: curl -G "https://api.qovia.ai/v1/raw/kuaishou/creator_hot_videos?uid=228905802" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_kua_892e0d923045","src":"social","platform":"kuaishou","lang":"zh-CN","text":"绝 望 鸭 脖","author":{"uid_hash":"ec1f004e8813","followers":null,"nickname":"权少爱吃小汉堡🍔","uid":"228905802","eid":"3xz63mn6fngqtiq","unique_id":"quanshaogmod"},"metrics":{"likes":536223,"comments":33273,"shares":203274,"saves":141600,"plays":9258156},"extra":{"source_id":"5220235068916084263","eid":"3xry7mhn2ywjyqg","published_at":"2024-12-13T17:17:22+08:00","video_dur_s":23,"topic":null,"topics":[],"content_type":"video","cover_url":"https://tx2.a.yximgs.com/upic/2024/12/13/17/BMjAyNDEyMTMxNzE2NDFfMjI4OTA1ODAyXzE1MTA0ODI0NzI0N18yXzM=_480p_B4efb6ba5cc46a45b5c0a0aaa01501c37.kvif?tag=1-1792597593-p-0-5967be10b83044ab-3d4b358efb604372&type=hot&clientCacheKey=3xry7mhn2ywjyqg_480p.kvif&di=71f51c4b&bp=10001","ip_location":"辽宁","url":"https://www.kuaishou.com/short-video/3xry7mhn2ywjyqg"},"prov":{"hash":"0x5a084be3780470c7","ts":"2026-10-21T23:50:00+08:00","source":"live"}},{"id":"soc_kua_1a62daa69faa","src":"social","platform":"kuaishou","lang":"zh-CN","text":"跳 舞 鸭 脖 2 #gmod #老鼠舞","author":{"uid_hash":"ec1f004e8813","followers":null,"nickname":"权少爱吃小汉堡🍔","uid":"228905802","eid":"3xz63mn6fngqtiq","unique_id":"quanshaogmod"},"metrics":{"likes":402005,"comments":21750,"shares":94677,"saves":115752,"plays":7817114},"extra":{"source_id":"5206442799671854712","eid":"3xj2cyw5d3sd68y","published_at":"2025-02-06T17:21:20+08:00","video_dur_s":16,"topic":"#gmod","topics":["gmod","老鼠舞"],"content_type":"video","cover_url":"https://tx2.a.yximgs.com/upic/2025/02/06/17/BMjAyNTAyMDYxNzIwNTlfMjI4OTA1ODAyXzE1NjE0MzA1Mzg0MV8yXzM=_480p_Bb51a689a854580934fcbf3a41070de92.kvif?tag=1-1792597593-p-0-5967be10b83044ab-3d4b358efb604372&type=hot&clientCacheKey=3xj2cyw5d3sd68y_480p.kvif&di=71f51c4b&bp=10001","ip_location":"辽宁","url":"https://www.kuaishou.com/short-video/3xj2cyw5d3sd68y"},"prov":{"hash":"0x4696d7b36a56eff5","ts":"2026-10-21T23:50:00+08:00","source":"live"}}],"cursor":"20","has_more":true,"prov":{"hash":"0x2fb7e994bc49c079","ts":"2026-10-21T23:50:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/kuaishou/hot_board — Kuaishou hot board

ID: raw.kuaishou.hot_board. Docs: https://qovia.ai/docs/api-reference/raw.kuaishou.hot_board/
Kuaishou's hot board (the main board) as it stands, about 50 words: rank, word, heat value, views, the board's tag (such as 霸榜中 "holding the top" or 18:20登顶 "reached #1 at 18:20") and a search link; pinned words come first (pinned true, no rank). One whole board per call, no paging, no params. An empty board answers empty and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters: none.
Example request: curl -G "https://api.qovia.ai/v1/raw/kuaishou/hot_board" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"rank":5,"keyword":"钟意长生拥抱","hot_value":11672034,"views":12229119,"label":"1.7万点赞","pinned":false,"word_id":"6394393","url":"https://www.kuaishou.com/search/video?searchKey=%E9%92%9F%E6%84%8F%E9%95%BF%E7%94%9F%E6%8B%A5%E6%8A%B1"},{"rank":6,"keyword":"AG年总止步突围赛","hot_value":11461345,"views":12162235,"label":"1.3万点赞","pinned":false,"word_id":"6394299","url":"https://www.kuaishou.com/search/video?searchKey=AG%E5%B9%B4%E6%80%BB%E6%AD%A2%E6%AD%A5%E7%AA%81%E5%9B%B4%E8%B5%9B"}],"prov":{"hash":"0xce3b4c4dd72abfec","ts":"2026-10-21T23:50:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

## Bilibili

### GET /v1/raw/bilibili/video — Bilibili video detail

ID: raw.bilibili.video. Docs: https://qovia.ai/docs/api-reference/raw.bilibili.video/
Title, description, uploader, category, tags and engagement (plays, likes, coins, saves, comments, shares, danmaku) for one video. BV ids only; follower counts are not available.
Price: $0.000500 per successful call. Status: live.
Parameters:
- bvid (required; string): Video BV ID, e.g. BV1naKB64Evm
Example request: curl -G "https://api.qovia.ai/v1/raw/bilibili/video?bvid=BV1naKB64Evm" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_bil_9b89815a7ce3","src":"social","platform":"bilibili","lang":"zh-CN","text":"一口气看懂先进封装：H100、B200、CoWoS与HBM如何连接？\nAI芯片为什么离不开先进封装？…","author":{"uid_hash":"8fb5730b2ca6","mid":"1517478075","name":"坤元Research","avatar":"https://i0.hdslb.com/bfs/face/8036b7133d5ba1fdc4286353885fdde55f0095dd.jpg"},"metrics":{"plays":220502,"likes":5640,"coins":3550,"saves":7982,"comments":404,"shares":1558,"danmaku":242},"extra":{"source_id":"BV1naKB64Evm","url":"https://www.bilibili.com/video/BV1naKB64Evm","title":"一口气看懂先进封装：H100、B200、CoWoS与HBM如何连接？","aid":"116944493613065","cid":"40089160246","duration_s":1697,"published_at":"2026-07-19T11:23:00+08:00","category":{"id":2103,"name":null},"tags":["先进封装","CoWoS","台积电","HBM","财经科普"],"keywords":["先进封装","台积电","HBM"],"cover":"https://i1.hdslb.com/bfs/archive/bca0873add82bb7e6c8d7cf2b2e71cea9d18e798.jpg"},"prov":{"hash":"0xb5092dfcfd4fa826","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/bilibili/search — Bilibili video search

ID: raw.bilibili.search. Docs: https://qovia.ai/docs/api-reference/raw.bilibili.search/
Keyword video search, up to 20 results per page and 50 pages, sortable by plays, publish time, danmaku, saves or comments. Bilibili returns fuzzy matches for any keyword; stop paging when has_more is false (past the last page Bilibili repeats page 1). Results carry no coin or share counts.
Price: $0.000500 per successful call. Status: live.
Parameters:
- keyword (required; string; min length 1; max length 100): Search keyword
- page (optional; integer; default 1; min 1; max 50): Page number; use the cursor returned by the previous page
- page_size (optional; integer; default 20; min 1; max 20): Items per page
- order (optional; string; one of "totalrank", "click", "pubdate", "dm", "stow", "scores"): Sort: totalrank relevance (default), click most played, pubdate newest, dm most danmaku, stow most favorited, scores most comments
Example request: curl -G "https://api.qovia.ai/v1/raw/bilibili/search?keyword=%E5%8F%B0%E7%A7%AF%E7%94%B5" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_bil_2913ac9c522a","src":"social","platform":"bilibili","lang":"zh-CN","text":"「小白」全球芯片代工王！万字台积电发展史","author":{"uid_hash":"ca5fa000e345","mid":"8969156","name":"小白测评"},"metrics":{"plays":689248,"likes":20365,"saves":7230,"comments":1348,"danmaku":2676},"extra":{"source_id":"BV1DkoeYhExZ","url":"https://www.bilibili.com/video/BV1DkoeYhExZ","title":"「小白」全球芯片代工王！万字台积电发展史","published_at":"2025-03-26T18:30:00+08:00","category":{"id":95,"name":"数码"},"tags":["芯片","数码","台积电","手机芯片"],"cover":"https://i0.hdslb.com/bfs/archive/8f62d780e4e308bafa8c9f6c4d14ce5a28b2ce0b.jpg"},"prov":{"hash":"0xc16f694e973143c1","ts":"2026-10-20T12:00:00+08:00","source":"live"}}],"cursor":2,"has_more":true}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/bilibili/comments — Bilibili video comments

ID: raw.bilibili.comments. Docs: https://qovia.ai/docs/api-reference/raw.bilibili.comments/
Top-level comments of a video, hottest first, 20 per page; pass the previous page's cursor back unchanged to continue. Use cid to fetch nested replies. IP location is not available.
Price: $0.000500 per successful call. Status: live.
Parameters:
- bvid (required; string): Video BV ID
- cursor (optional; string; default ""; max length 1024): The cursor returned by the previous page; omit it for the first page
Example request: curl -G "https://api.qovia.ai/v1/raw/bilibili/comments?bvid=BV1naKB64Evm" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"cid":"307039443665","text":"视频做的形象又专业，大赞。我一个半导体从业人员都得向您学习","likes":74,"reply_count":9,"created_at":"2026-07-21T21:59:05+08:00","author":{"uid_hash":"38935505d064","mid":"1025763470","name":"Xiaobai585"}},{"cid":"307069093249","text":"下一代的封装基板应该是玻璃了吧","likes":8,"reply_count":8,"created_at":"2026-07-22T03:47:08+08:00","author":{"uid_hash":"2e504fc25f56","mid":"351478085","name":"青叶竹啊啊啊"}}],"cursor":"CAESEDE4MzU0ODg3MzI2MzAyNjgiAggB","has_more":true}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/bilibili/replies — Bilibili comment replies

ID: raw.bilibili.replies. Docs: https://qovia.ai/docs/api-reference/raw.bilibili.replies/
Every nested reply under one top-level comment, in one call (not paginated). Threads with more than about 100 replies may time out, which is not charged.
Price: $0.000500 per successful call. Status: live.
Parameters:
- bvid (required; string): Video BV ID
- root_id (required; integer; min 1): Top-level comment ID (the cid from raw.bilibili.comments)
Example request: curl -G "https://api.qovia.ai/v1/raw/bilibili/replies?bvid=BV1dgJS67ETL&root_id=317243572785" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"cid":"320997789072","root_cid":"317243572785","parent_cid":"317243572785","text":"三星記憶體的淨利是台積電的三倍，只是很難預期三寡頭可以長期維持高獲利…","likes":0,"created_at":"2026-10-17T17:40:59+08:00","author":{"uid_hash":"9a3f92c72f4e","mid":"320586001","name":"jay886123"}},{"cid":"321112269648","root_cid":"317243572785","parent_cid":"320997789072","text":"回复 @jay886123 :你的資訊是不是錯了？","likes":0,"created_at":"2026-10-18T17:07:06+08:00","author":{"uid_hash":"2f280e9c9adb","mid":"1238965214","name":"貓界香奈兒"}}],"cursor":null,"has_more":false,"total":7}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/bilibili/danmaku — Bilibili danmaku

ID: raw.bilibili.danmaku. Docs: https://qovia.ai/docs/api-reference/raw.bilibili.danmaku/
Current and historical danmaku of a video's first part, de-duplicated and cut at limit (has_more true means it was cut; raise limit). complete=false means some segments could not be fetched. Older popular videos may time out, which is not charged.
Price: $0.000500 per successful call. Status: live.
Parameters:
- bvid (required; string): Video BV ID
- limit (optional; integer; default 200; min 1; max 1000): Maximum number of danmaku (bullet comments) to return
Example request: curl -G "https://api.qovia.ai/v1/raw/bilibili/danmaku?bvid=BV1naKB64Evm" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"dmid":"2159472694570373376","text":"大家快来接盘。","offset_ms":40230,"sent_at":"2026-07-20T12:06:45+08:00","source":"current","history_date":null},{"dmid":"2160787288715117312","text":"这图都错了","offset_ms":93908,"sent_at":"2026-07-22T07:38:37+08:00","source":"current","history_date":null}],"cursor":null,"has_more":true,"complete":false}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/bilibili/creator — Bilibili creator profile

ID: raw.bilibili.creator. Docs: https://qovia.ai/docs/api-reference/raw.bilibili.creator/
A creator's profile with followers, following, likes (videos, articles and posts together), video count, verification, level, bio and avatar. A user that does not exist answers 404 and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- mid (required; string): The creator's mid (the number in space.bilibili.com/<mid>; a video record's author.mid)
Example request: curl -G "https://api.qovia.ai/v1/raw/bilibili/creator?mid=1517478075" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"uid_hash":"851c5e9d2289","name":"坤元Research","followers":22562,"total_likes":15015,"posts":9,"verified":false,"platform":"bilibili","mid":"1517478075","following":8,"signature":"坤元研究院｜看懂产业的价值流向","verify_reason":null,"level":4,"avatar":"https://i0.hdslb.com/bfs/face/8036b7133d5ba1fdc4286353885fdde55f0095dd.jpg","url":"https://space.bilibili.com/1517478075","prov":{"hash":"0x1d93aa619b0866ba","ts":"2026-10-22T00:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/bilibili/creator_videos — Bilibili creator videos

ID: raw.bilibili.creator_videos. Docs: https://qovia.ai/docs/api-reference/raw.bilibili.creator_videos/
Videos a creator uploaded, newest, most played or most saved first, up to 50 a page and 100 pages; same ids as video detail, with play, comment and danmaku counts (no likes, coins, saves or shares). Use the previous page's cursor as page to continue; stop when has_more is false. A creator without videos, or one that does not exist, answers empty and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- mid (required; string): The creator's mid
- page (optional; integer; default 1; min 1; max 100): Page number; use the cursor returned by the previous page
- page_size (optional; integer; default 25; min 1; max 50): Items per page
- order (optional; string; one of "pubdate", "click", "stow"; default "pubdate"): Order: pubdate newest (the default), click most played, stow most saved
Example request: curl -G "https://api.qovia.ai/v1/raw/bilibili/creator_videos?mid=1517478075" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_bil_bdb3bc6cddd2","src":"social","platform":"bilibili","lang":"zh-CN","text":"高阶HDI化，正在重塑PCB产业格局\n从智能手表等AI终端，到英伟达AI服务器和光模块，为什么越来越多的设备开始采用高阶HDI？ \n与传统PCB相比，HDI究竟解决了什么技术难题？…","author":{"uid_hash":"851c5e9d2289","mid":"1517478075","name":"坤元Research"},"metrics":{"plays":4696,"comments":10,"danmaku":1},"extra":{"source_id":"BV1oeJX6bELV","url":"https://www.bilibili.com/video/BV1oeJX6bELV","title":"高阶HDI化，正在重塑PCB产业格局","aid":"117449638944356","duration_s":636,"published_at":"2026-10-16T16:30:10+08:00","category":{"id":231,"name":null},"cover":"https://i0.hdslb.com/bfs/archive/dbfb60105a77a928b19bd3f5519970ddf00f187a.jpg"},"prov":{"hash":"0xc91a1c6a84576b38","ts":"2026-10-22T00:00:00+08:00","source":"live"}},{"id":"soc_bil_c1ebaf32d311","src":"social","platform":"bilibili","lang":"zh-CN","text":"看懂玻璃封装基板的产业逻辑和价值流向\nAI芯片越做越大，传统有机封装基板开始撑不住了，玻璃基板正在成为下一代先进封装的重要方向。\n这期我们从最底层的工艺讲清楚：为什么是玻璃？TGV…","author":{"uid_hash":"851c5e9d2289","mid":"1517478075","name":"坤元Research"},"metrics":{"plays":29270,"comments":103,"danmaku":10},"extra":{"source_id":"BV18Sh16xEPX","url":"https://www.bilibili.com/video/BV18Sh16xEPX","title":"看懂玻璃封装基板的产业逻辑和价值流向","aid":"117331930059084","duration_s":830,"published_at":"2026-09-25T21:34:21+08:00","category":{"id":231,"name":null},"cover":"https://i2.hdslb.com/bfs/archive/85db5326e9f02da3d504580cdc2a1ddcbbd70179.jpg"},"prov":{"hash":"0xefe766f0060f1577","ts":"2026-10-22T00:00:00+08:00","source":"live"}}],"cursor":2,"has_more":true,"total":9}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/bilibili/popular — Bilibili popular videos

ID: raw.bilibili.popular. Docs: https://qovia.ai/docs/api-reference/raw.bilibili.popular/
Bilibili's popular videos, 20 a page, as the same records as video detail (same ids) with plays, likes, coins, saves, comments, shares and danmaku. Use the previous page's cursor as page to continue; stop when has_more is false.
Price: $0.001000 per successful call. Status: live.
Parameters:
- page (optional; integer; default 1; min 1; max 50): Page number; use the cursor returned by the previous page
Example request: curl -G "https://api.qovia.ai/v1/raw/bilibili/popular" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_bil_11760c9b62a2","src":"social","platform":"bilibili","lang":"zh-CN","text":"折1万次，会坏吗？iPhone Duo深度评测\n相信各位和我们一样，对苹果的第一台折叠屏手机充满了好奇，这次我们为iPhone Duo准备了一系列特别的测试，甚至专门准备了一台能够…","author":{"uid_hash":"bdecfe51a931","mid":"946974","name":"影视飓风","avatar":"https://i0.hdslb.com/bfs/face/c1733474892caa45952b2c09a89323157df7129a.jpg"},"metrics":{"plays":662143,"likes":66418,"coins":37011,"saves":15064,"comments":10201,"shares":9252,"danmaku":13953},"extra":{"source_id":"BV1xrnz6gEVD","url":"https://www.bilibili.com/video/BV1xrnz6gEVD","title":"折1万次，会坏吗？iPhone Duo深度评测","aid":"117478344627500","cid":"42926145926","duration_s":1492,"published_at":"2026-10-21T20:00:00+08:00","category":{"id":95,"name":"数码"},"cover":"https://i0.hdslb.com/bfs/archive/ccacc1c956715cf06db7a29b634c3c269654acea.jpg"},"prov":{"hash":"0xdb0742074c1745b4","ts":"2026-10-22T00:00:00+08:00","source":"live"}},{"id":"soc_bil_7127530b3a6c","src":"social","platform":"bilibili","lang":"zh-CN","text":"《南屏晚钟》来啦！\n大家晚上好，今天唱《南屏晚钟》 。\n还没等到我回复的新朋友们不要伤心和失望呀！\n平时白天忙一些，晚上时间就充裕啦～\n吃完晚饭我来回大家评论哟！\n再次感谢每一位朋…","author":{"uid_hash":"c1a05d0a77c8","mid":"249082219","name":"李诺Noomi","avatar":"https://i1.hdslb.com/bfs/face/3ccca3980dedd3dc44b2814c5ddc176b7db6b7f4.jpg"},"metrics":{"plays":1305495,"likes":87053,"coins":10746,"saves":15013,"comments":5192,"shares":2603,"danmaku":481},"extra":{"source_id":"BV1mgnP6yELh","url":"https://www.bilibili.com/video/BV1mgnP6yELh","title":"《南屏晚钟》来啦！","aid":"117472741165711","cid":"42898752711","duration_s":97,"published_at":"2026-10-20T18:25:41+08:00","category":{"id":31,"name":"翻唱"},"cover":"https://i1.hdslb.com/bfs/archive/6e7a970e4f679969853d80f8154b6ccb3d3a5b48.jpg"},"prov":{"hash":"0x8facacbe7099267f","ts":"2026-10-22T00:00:00+08:00","source":"live"}}],"cursor":2,"has_more":true}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

## Douyin Xingtu

### GET /v1/raw/xingtu/author — Douyin Xingtu creator profile

ID: raw.xingtu.author. Docs: https://qovia.ai/docs/api-reference/raw.xingtu.author/
Xingtu creator profile: nickname, followers, gender, location, the matching Douyin uid / sec_uid / handle, MCN, content labels, Xingtu and e-commerce status. Unknown author ids answer 404 and are not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- author_id (required; string): Xingtu creator ID (o_author_id)
- channel (optional; string; one of "1", "10"; default "1"): 1 short video, 10 live streaming
Example request: curl -G "https://api.qovia.ai/v1/raw/xingtu/author?author_id=6790158034132795406" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_xin_a890182a3d8f","src":"social","platform":"xingtu","author_id":"6790158034132795406","nickname":"犟种兄弟","avatar_url":"https://p11.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-avt-0015_b5cd790831737f84254c5a5cb4ca0fd6.jpeg","followers":2737562,"gender":"male","location":{"province":"辽宁省","city":"沈阳市"},"douyin":{"uid":"2422960710762380","sec_uid":"MS4wLjABAAAATBkQ-V3vn_LrvOI7cYOZ7pDNihy7fSR0HZTF8dzJcomEi9X3YQCfyb4BzUO8W8aD","unique_id":"Xiaomengzaizhene","short_id":"3040643096"},"mcn":{"id":"7091111787000496139","name":"忠新影视"},"content_labels":["搞笑剧情","剧情反转","陈翔短剧"],"tags":[{"tag":"剧情搞笑","subtags":["剧情"]}],"is_star":true,"ecommerce_enabled":true,"channels":[1],"joined_at":"2020-02-06T10:41:05+08:00","prov":{"hash":"0x751265002a285a8c","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/xingtu/author_videos — Douyin Xingtu creator recent videos

ID: raw.xingtu.author_videos. Docs: https://qovia.ai/docs/api-reference/raw.xingtu.author_videos/
A creator's latest personal and Xingtu (sponsored) videos, up to 15 each, with plays, likes, comments and shares, plus a summary of recent interaction rate, median plays and view rate against peers (keys ending in _enrollment cover Xingtu videos). Unknown authors answer 404 and creators without videos answer empty; neither is charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- author_id (required; string): Xingtu creator ID (o_author_id)
- only_assign (optional; boolean; default false): When true, Xingtu videos cover assigned orders only
Example request: curl -G "https://api.qovia.ai/v1/raw/xingtu/author_videos?author_id=6790158034132795406" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_xin_892124ba9175","src":"social","platform":"xingtu","lang":"zh-CN","text":"蒙哥，老师以后跟你各论各的","author":{"author_id":"6790158034132795406","douyin_uid":"2422960710762380","name":null,"followers":null},"metrics":{"plays":5000740,"likes":200204,"comments":1329,"shares":14800},"extra":{"source_id":"7674181083131054406","published_at":"2026-08-15T17:02:03+08:00","duration_s":249,"is_hot":false,"is_star_video":false,"url":"https://www.douyin.com/video/7674181083131054406"},"prov":{"hash":"0xf46ca3820c6362d2","ts":"2026-10-20T12:00:00+08:00","source":"live"}}],"cursor":null,"has_more":false,"author_id":"6790158034132795406","summary":{"interaction":{"rate":0.0768,"compare_avg":0.0239,"compare_author":0.81},"interaction_enrollment":{"rate":0.0601,"compare_avg":-0.0205,"compare_author":0.59},"play_medium":{"rate":409298,"compare_avg":25.8,"compare_author":0.98},"play_medium_enrollment":{"rate":1790337,"compare_avg":40.3,"compare_author":0.98},"video_view_rate":{"rate":0.2339,"compare_avg":0.0834,"compare_author":0.83},"video_view_rate_enrollment":{"rate":0.2167,"compare_avg":0.0953,"compare_author":0.85}}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/xingtu/author_spread — Douyin Xingtu creator reach overview

ID: raw.xingtu.author_spread. Docs: https://qovia.ai/docs/api-reference/raw.xingtu.author_spread/
Reach overview for the last 30 or 90 days: video count, average likes/comments/shares, interaction rate, completion rate, median plays and the share of peers beaten, plus CPM/CPE estimates. Rates are Xingtu's basis-point integers (528 = 5.28%); expect_cpm, expect_cpe and sales_expect_cpm are in CNY cents. A window without videos answers empty (estimates only) and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- author_id (required; string): Xingtu creator ID (o_author_id)
- video_type (optional; integer; one of 1, 2; default 1): 1 personal videos, 2 Xingtu (sponsored) videos
- range (optional; integer; one of 2, 3; default 2): 2 last 30 days, 3 last 90 days
- only_assign (optional; boolean; default false): Only with video_type=2: assigned orders only
- flow_type (optional; integer; one of 0, 1; default 0): Only with video_type=2: 1 excludes ad traffic
Example request: curl -G "https://api.qovia.ai/v1/raw/xingtu/author_spread?author_id=6790158034132795406" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_xin_7d90c97f0782","src":"social","platform":"xingtu","author_id":"6790158034132795406","videos":7,"avg_duration":25556,"avg_likes":54259,"avg_comments":310,"avg_shares":11408,"interact_rate":{"value":528,"overtake":8620},"play_over_rate":{"value":1055,"overtake":6673},"play_median":{"value":1311912,"overtake":9003},"play_stability":null,"expect_cpm":{"cpm_21_60":1192,"cpm_60":1315},"expect_cpe":{"cpe_21_60":28,"cpe_60":31},"sales_expect_cpm":{"cpm_21_60":1546,"cpm_60":1705},"prov":{"hash":"0x3e8e11d0cd112e6c","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/xingtu/author_pricing — Douyin Xingtu creator rate card

ID: raw.xingtu.author_pricing. Docs: https://qovia.ai/docs/api-reference/raw.xingtu.author_pricing/
A creator's Xingtu rate card (integrated video, custom video and so on, in CNY, with list price, settlement type and whether it is open) and industry tags. Creators without any price answer empty and are not charged.
Price: $0.010000 per successful call. Status: live.
Parameters:
- author_id (required; string): Xingtu creator ID (o_author_id)
- channel (optional; string; one of "1", "10"; default "1"): 1 short video, 10 live streaming
Example request: curl -G "https://api.qovia.ai/v1/raw/xingtu/author_pricing?author_id=6790158034132795406" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_xin_e273f03d7b93","src":"social","platform":"xingtu","author_id":"6790158034132795406","prices":[{"field":"long_video_price","desc":"植入视频","price":87000,"origin_price":87000,"settlement_desc":"固定价格","video_type":2,"is_open":true},{"field":"price","desc":"定制视频","price":96000,"origin_price":96000,"settlement_desc":"固定价格","video_type":71,"is_open":true}],"industry_tags":["生活服务-二手交易","互联网电商服务-综合电商平台"],"prov":{"hash":"0x8b8d66b574df7754","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/xingtu/author_audience — Douyin Xingtu creator viewer profile

ID: raw.xingtu.author_audience. Docs: https://qovia.ai/docs/api-reference/raw.xingtu.author_audience/
Who watches the creator's videos: distributions by device brand, city tier, age, city, province, gender, consumer segment and interest, each with Xingtu's one-line summary and per-bucket counts. Creators without a profile answer empty and are not charged.
Price: $0.010000 per successful call. Status: live.
Parameters:
- author_id (required; string): Xingtu creator ID (o_author_id)
Example request: curl -G "https://api.qovia.ai/v1/raw/xingtu/author_audience?author_id=6790158034132795406" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_xin_5cbca277db81","src":"social","platform":"xingtu","author_id":"6790158034132795406","dimensions":[{"type":2,"name":"年龄分布","summary":"18到23岁居多,占比46%","buckets":[{"key":"18-23","value":506224},{"key":"24-30","value":178006}]},{"type":32,"name":"城市等级分布","summary":"一线居多,占比24%","buckets":[{"key":"一线","value":421298},{"key":"三线","value":414508}]}],"updated_at":"2026-10-20T12:11:12+08:00","prov":{"hash":"0x781dafa0a4b1ecaf","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/xingtu/author_fans — Douyin Xingtu creator follower profile

ID: raw.xingtu.author_fans. Docs: https://qovia.ai/docs/api-reference/raw.xingtu.author_fans/
Profile of a creator's followers (or fan club, or loyal fans): age, gender, consumer segment, device brand, interests and more, in the same shape as the viewer profile. Creators without a profile answer empty and are not charged.
Price: $0.010000 per successful call. Status: live.
Parameters:
- author_id (required; string): Xingtu creator ID (o_author_id)
- crowd (optional; integer; one of 1, 2, 5; default 1): 1 followers, 2 fan club members, 5 loyal fans
Example request: curl -G "https://api.qovia.ai/v1/raw/xingtu/author_fans?author_id=6790158034132795406" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_xin_219d1e8dee5d","src":"social","platform":"xingtu","author_id":"6790158034132795406","dimensions":[{"type":1,"name":"性别分布","summary":"男性居多,占比74%","buckets":[{"key":"female","value":709830},{"key":"male","value":2024415}]}],"updated_at":"2026-10-20T12:11:18+08:00","prov":{"hash":"0x4d248318aefe3f95","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/xingtu/author_seeding — Douyin Xingtu creator search lift

ID: raw.xingtu.author_seeding. Docs: https://qovia.ai/docs/api-reference/raw.xingtu.author_seeding/
Search lift after viewers watch the creator: average searches after viewing, search-after-view rate and search-term CTR. Xingtu only publishes display values (such as "<10" or "1%"), returned as strings. Creators without data answer empty and are not charged.
Price: $0.010000 per successful call. Status: live.
Parameters:
- author_id (required; string): Xingtu creator ID (o_author_id)
- range (optional; string; one of "30", "90"; default "30"): Window: the last 30 or 90 days
Example request: curl -G "https://api.qovia.ai/v1/raw/xingtu/author_seeding?author_id=6790158034132795406" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_xin_60f93f1bf1ec","src":"social","platform":"xingtu","author_id":"6790158034132795406","search_after_view_count":"<10","search_after_view_rate":"<0.02%","search_word_ctr":"1%","updated_at":"2026-10-19T13:25:27+08:00","prov":{"hash":"0xefabc428dcb28200","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/xingtu/author_cpm — Douyin Xingtu creator CPM and CPE

ID: raw.xingtu.author_cpm. Docs: https://qovia.ai/docs/api-reference/raw.xingtu.author_cpm/
Cost per thousand plays (CPM) and per engagement (CPE) at the current rate card, for 20-60 s and 60 s+ videos, in CNY; cpm_20_60_rank_percent is the peer percentile, views the expected plays, and sn_ fields are Xingtu's alternative basis. Creators without data answer empty and are not charged.
Price: $0.010000 per successful call. Status: live.
Parameters:
- author_id (required; string): Xingtu creator ID (o_author_id)
Example request: curl -G "https://api.qovia.ai/v1/raw/xingtu/author_cpm?author_id=6790158034132795406" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_xin_6cfc4e263819","src":"social","platform":"xingtu","author_id":"6790158034132795406","cpm_20_60":11.924,"cpm_60":13.1576,"cpe_20_60":0.2819,"cpe_60":0.3111,"cpm_20_60_rank_percent":0.0406,"sn_cpm_20_60":11.924,"sn_cpm_60":13.1576,"sn_cpe_20_60":0.2831,"sn_cpe_60":0.3124,"views":7296186,"sn_views":7296186,"updated_at":"2026-10-19T22:34:11+08:00","prov":{"hash":"0x3b23a176cfd0e8a3","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/xingtu/author_indices — Douyin Xingtu creator business indices

ID: raw.xingtu.author_indices. Docs: https://qovia.ai/docs/api-reference/raw.xingtu.author_indices/
Xingtu's business indices (cooperation, cost-performance, conversion, shopping, spread and star), each with score, peer average, rank, rank percentile and period-over-period change. Creators without data answer empty and are not charged.
Price: $0.010000 per successful call. Status: live.
Parameters:
- author_id (required; string): Xingtu creator ID (o_author_id)
- industry_tag (optional; integer; default 0; min 0): Industry tag ID; 0 for all industries
Example request: curl -G "https://api.qovia.ai/v1/raw/xingtu/author_indices?author_id=6790158034132795406" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_xin_06c43a95c3b9","src":"social","platform":"xingtu","author_id":"6790158034132795406","indices":{"cooperate_index":{"value":75.64,"avg_value":75.55,"rank":147221,"rank_percent":0.0674,"relative_ratio":0},"cp_index":{"value":69.97,"avg_value":64.09,"rank":27040,"rank_percent":0.0124,"relative_ratio":0},"link_convert_index":{"value":61.51,"avg_value":55.24,"rank":174328,"rank_percent":0.0798,"relative_ratio":-0.0956},"link_shopping_index":{"value":71.76,"avg_value":53.24,"rank":68468,"rank_percent":0.0313,"relative_ratio":0.1617},"link_spread_index":{"value":71.62,"avg_value":53.09,"rank":69171,"rank_percent":0.0317,"relative_ratio":0.15},"link_star_index":{"value":70.1,"avg_value":56.19,"rank":51681,"rank_percent":0.0236,"relative_ratio":0.0381}},"prov":{"hash":"0x3efa5d92ce5c7227","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/xingtu/author_conversion — Douyin Xingtu creator conversion

ID: raw.xingtu.author_conversion. Docs: https://qovia.ai/docs/api-reference/raw.xingtu.author_conversion/
Conversion value of the creator's Xingtu videos: median plays, related video count, and display ranges for cost per click, component clicks, component click rate, average sales, GPM and recommended product price (null when Xingtu has none). Creators without any data answer empty and are not charged.
Price: $0.010000 per successful call. Status: live.
Parameters:
- author_id (required; string): Xingtu creator ID (o_author_id)
- range (optional; integer; one of 1, 2, 3; default 2): 1 last 7 days, 2 last 30 days, 3 last 90 days
- industry_id (optional; integer; default 0; min 0): Industry ID; 0 for all industries
Example request: curl -G "https://api.qovia.ai/v1/raw/xingtu/author_conversion?author_id=6790158034132795406" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_xin_3fe1366eef66","src":"social","platform":"xingtu","author_id":"6790158034132795406","video_plays_median":771476,"related_videos":2,"related_cpc_range":"16-18","component_click_count_range":"500以下","component_click_rate_range":"2%以下","avg_sales_amount_range":null,"gpm_range":null,"product_price_range":null,"prov":{"hash":"0x1932de56b52bf9b7","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/xingtu/author_content_keywords — Douyin Xingtu creator content keywords

ID: raw.xingtu.author_content_keywords. Docs: https://qovia.ai/docs/api-reference/raw.xingtu.author_content_keywords/
The most frequent words in a creator's recent videos (about 20), sorted by count; videos is the number of videos containing the word (null when Xingtu does not say). Creators without keywords answer empty and are not charged.
Price: $0.000500 per successful call. Status: live.
Parameters:
- author_id (required; string): Xingtu creator ID (o_author_id)
Example request: curl -G "https://api.qovia.ai/v1/raw/xingtu/author_content_keywords?author_id=6790158034132795406" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_xin_a016353f7ecf","src":"social","platform":"xingtu","author_id":"6790158034132795406","keywords":[{"word":"学校","count":10,"videos":5},{"word":"老师","count":6,"videos":6},{"word":"便宜","count":4,"videos":null}],"prov":{"hash":"0x78cdb1180c725388","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/xingtu/author_comment_keywords — Douyin Xingtu creator comment keywords

ID: raw.xingtu.author_comment_keywords. Docs: https://qovia.ai/docs/api-reference/raw.xingtu.author_comment_keywords/
Hot words in the comments under a Xingtu creator's videos, with Xingtu's hot_rate passed through as is. No keywords answers an empty result and is not charged.
Price: $0.000500 per successful call. Status: live.
Parameters:
- author_id (required; string): Xingtu creator ID (o_author_id)
Example request: curl -G "https://api.qovia.ai/v1/raw/xingtu/author_comment_keywords?author_id=6790158034132795406" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_xin_738d17898c68","src":"social","platform":"xingtu","author_id":"6790158034132795406","keywords":[{"word":"老师","hot_rate":1107},{"word":"学校","hot_rate":521},{"word":"时候","hot_rate":505}],"prov":{"hash":"0x8053a5a59be79c94","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/xingtu/video_report — Douyin Xingtu video report

ID: raw.xingtu.video_report. Docs: https://qovia.ai/docs/api-reference/raw.xingtu.video_report/
Xingtu's report for one Douyin video: plays, likes, comments, shares, saves, interactions, interaction rate, completion rate, content labels and music, plus the author's Xingtu id, Douyin uid, name and followers. Videos Xingtu does not know answer 404 and are not charged.
Price: $0.010000 per successful call. Status: live.
Parameters:
- item_id (required; string): Douyin video ID (aweme_id)
Example request: curl -G "https://api.qovia.ai/v1/raw/xingtu/video_report?item_id=7674181083131054406" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_xin_892124ba9175","src":"social","platform":"xingtu","lang":"zh-CN","text":"蒙哥，老师以后跟你各论各的","author":{"author_id":"6790158034132795406","douyin_uid":"2422960710762380","name":"犟种兄弟","followers":2737562},"metrics":{"plays":5000740,"likes":200204,"comments":1329,"shares":14800,"saves":6054,"interactions":216333,"interact_rate":0.0432,"finish_rate":0.0882},"extra":{"source_id":"7674181083131054406","published_at":"2026-08-15T17:02:03+08:00","duration_s":249.915,"labels":["陈翔短剧","搞笑剧情","青春期烦恼"],"music":{"id":"7674181093137992502","title":"@犟种兄弟创作的原声"},"url":"https://www.douyin.com/video/7674181083131054406"},"prov":{"hash":"0x6fb2ea24c0fd500c","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/xingtu/video_trend — Douyin Xingtu video daily trend

ID: raw.xingtu.video_trend. Docs: https://qovia.ai/docs/api-reference/raw.xingtu.video_trend/
Daily series for about 30 days after a video was posted: plays, valid plays, likes, comments, shares, saves, interactions, interaction rate, completion rate and heat, in date order. Rates are Xingtu's basis-point integers (548 = 5.48%). Videos without a trend answer empty and are not charged.
Price: $0.010000 per successful call. Status: live.
Parameters:
- item_id (required; string): Douyin video ID (aweme_id)
Example request: curl -G "https://api.qovia.ai/v1/raw/xingtu/video_trend?item_id=7674181083131054406" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_xin_8281ea03739f","src":"social","platform":"xingtu","item_id":"7674181083131054406","series":{"plays":[{"date":"2026-08-15","value":939414},{"date":"2026-08-16","value":745262}],"valid_plays":[{"date":"2026-08-15","value":872988},{"date":"2026-08-16","value":681942}],"likes":[{"date":"2026-08-15","value":47684},{"date":"2026-08-16","value":35140}],"comments":[{"date":"2026-08-15","value":318},{"date":"2026-08-16","value":174}],"shares":[{"date":"2026-08-15","value":3566},{"date":"2026-08-16","value":2446}],"saves":[{"date":"2026-08-15","value":1696},{"date":"2026-08-16","value":1026}],"interactions":[{"date":"2026-08-15","value":51568},{"date":"2026-08-16","value":37760}],"interact_rate":[{"date":"2026-08-15","value":548},{"date":"2026-08-16","value":506}],"finish_rate":[{"date":"2026-08-15","value":876},{"date":"2026-08-16","value":1060}],"hot_score":[{"date":"2026-08-15","value":1742806},{"date":"2026-08-16","value":1362534}]},"prov":{"hash":"0x52c9e0b7a1f3d684","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/xingtu/video_transcript — Douyin Xingtu video transcript

ID: raw.xingtu.video_transcript. Docs: https://qovia.ai/docs/api-reference/raw.xingtu.video_transcript/
Subtitles or speech transcript of a video, as timed segments (milliseconds) plus the joined full text. Slow (about 8 s). Videos without speech or subtitles answer empty and are not charged.
Price: $0.010000 per successful call. Status: live.
Parameters:
- item_id (required; string): Douyin video ID (aweme_id)
Example request: curl -G "https://api.qovia.ai/v1/raw/xingtu/video_transcript?item_id=7674181083131054406" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_xin_7e16cf83eb7d","src":"social","platform":"xingtu","item_id":"7674181083131054406","lang":"zh-CN","text":"你家孩子假期上烧烤店打工去了，他说他想体验体验。\n不是，你看你这家长，眼瞅开学高三了…","segments":[{"start_ms":0,"end_ms":3000,"text":"你家孩子假期上烧烤店打工去了，他说他想体验体验。"},{"start_ms":3000,"end_ms":9000,"text":"不是，你看你这家长，眼瞅开学高三了…"}],"prov":{"hash":"0x77854123a4ee6355","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/xingtu/videos — Douyin Xingtu videos in bulk

ID: raw.xingtu.videos. Docs: https://qovia.ai/docs/api-reference/raw.xingtu.videos/
Title, posting time, duration, plays, likes, comments, shares, saves and interaction rate for up to 20 Douyin videos per call. Order may differ from the request and unknown ids are simply missing; charged per call, and a call where none is found answers empty and is not charged.
Price: $0.010000 per successful call. Status: live.
Parameters:
- item_ids (required; string): Douyin video IDs, comma-separated, up to 20
Example request: curl -G "https://api.qovia.ai/v1/raw/xingtu/videos?item_ids=7674181083131054406%2C7694234405623846756" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_xin_395a33e12d11","src":"social","platform":"xingtu","lang":"zh-CN","text":"老许：都是为了孩子…","author":{"author_id":null,"douyin_uid":"2422960710762380","name":null,"followers":null},"metrics":{"plays":1233342,"likes":50594,"comments":177,"shares":2577,"saves":2003,"interact_rate":0.0432},"extra":{"source_id":"7694234405623846756","published_at":"2026-10-08T18:49:28+08:00","duration_s":298.143,"url":"https://www.douyin.com/video/7694234405623846756"},"prov":{"hash":"0xa7819a80f0ef02e5","ts":"2026-10-20T12:00:00+08:00","source":"live"}}],"cursor":null,"has_more":false}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

## Tieba

### GET /v1/raw/tieba/thread — Tieba thread

ID: raw.tieba.thread. Docs: https://qovia.ai/docs/api-reference/raw.tieba.thread/
Opening post of a thread (text, author, likes/saves/shares/replies, forum) plus one page of floors, about 15 per page in floor order, each with its author's nickname, level and IP location. Use raw.tieba.replies for replies inside a floor. Deleted or unknown threads answer 404 and a page past the end answers empty; neither is charged.
Price: $0.001500 per successful call. Status: live.
Parameters:
- thread_id (required; string): Thread ID (the number after tieba.baidu.com/p/)
- page (optional; integer; default 1; min 1; max 10000): Reply page, from 1; only page 1 carries the opening post's full text and images
Example request: curl -G "https://api.qovia.ai/v1/raw/tieba/thread?thread_id=10693684727" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_tie_3f9a1c27b04e","src":"social","platform":"tieba","lang":"zh-CN","text":"觉醒套和混搭传说五到底先做哪个？[小乖]黄金乡才传说二，有没有必要现在换。","author":{"uid_hash":"8d41e0a7c2f5","user_id":"1234567890","portrait":"tb.1.5a3c9e10.Qx7nB2kLmP4rT8vW1yZ0aA","nickname":"阿拉德老玩家","ip_location":"湖北","level":9,"followers":null},"metrics":{"replies":31,"likes":7,"saves":1,"shares":0},"extra":{"source_id":"10000000001","title":"问个套装问题","url":"https://tieba.baidu.com/p/10000000001","forum":{"id":"81570","name":"地下城与勇士","category":"游戏","subcategory":"网络游戏"},"published_at":"2026-05-06T09:45:46+08:00","images":["https://tiebapic.baidu.com/forum/pic/item/0000example.jpg"],"posts":[{"pid":"150000000002","floor":2,"text":"等新团本出来再考虑，混搭传说五够打现阶段的本了","images":[],"created_at":"2026-05-06T09:47:39+08:00","likes":0,"reply_count":3,"author":{"uid_hash":"2b7f90c13e6d","user_id":"2234567890","portrait":"tb.1.9e2d4b61.Hn3sK8pQ2wX5vC7mZ1rT4g","nickname":"雷阵雨","ip_location":"浙江","level":10}}],"page":{"current":1,"total":2,"has_more":true}},"prov":{"hash":"0x0f1e2d3c4b5a6978","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/tieba/replies — Tieba floor replies

ID: raw.tieba.replies. Docs: https://qovia.ai/docs/api-reference/raw.tieba.replies/
Replies inside one floor of a thread, 10 per page, cursor-paginated (a null cursor means no more). Each reply has its author's nickname and IP location; a "回复 someone :" prefix is split into reply_to. Take post_id from raw.tieba.thread extra.posts[].pid. A floor without replies, or an unknown post_id, answers empty and is not charged.
Price: $0.001500 per successful call. Status: live.
Parameters:
- thread_id (required; string): Thread ID
- post_id (required; string): Floor ID (the pid of a reply in the thread)
- cursor (optional; integer; default 0; min 0; max 100000): The cursor returned by the previous page
Example request: curl -G "https://api.qovia.ai/v1/raw/tieba/replies?thread_id=10693684727&post_id=153488634022" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"pid":"150000000101","text":"不应该是先有誓约吗","images":[],"created_at":"2026-05-06T11:15:11+08:00","likes":0,"reply_to":null,"author":{"uid_hash":"6c0d2a9e81f4","user_id":"3234567890","portrait":"tb.1.c41f7a02.Lp8xQ2mN5vB3kR9tW6yZ1h","nickname":"夏末","ip_location":"广东","level":null}},{"pid":"150000000102","text":"太初誓约哪有这么好出","images":[],"created_at":"2026-05-06T12:20:05+08:00","likes":2,"reply_to":{"user_id":"3234567890","nickname":"夏末","portrait":"tb.1.c41f7a02.Lp8xQ2mN5vB3kR9tW6yZ1h"},"author":{"uid_hash":"0e5b7d31a9c2","user_id":"4234567890","portrait":"tb.1.7b20e5d9.Vt4cH8sJ1nK6pQ3wE9rU2f","nickname":"星系","ip_location":"广东","level":null}}],"cursor":10,"has_more":true}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/tieba/user — Tieba user profile

ID: raw.tieba.user. Docs: https://qovia.ai/docs/api-reference/raw.tieba.user/
Public profile of a Tieba user: nickname, followers, following, likes received, account age, IP location and gender. Pass the author.portrait returned by raw.tieba.thread or raw.tieba.replies (a ?t= suffix is accepted). Unknown users answer 404 and are not charged.
Price: $0.001500 per successful call. Status: live.
Parameters:
- portrait (required; string): User portrait, shaped like tb.1.xxxxxxxx.xxxx
Example request: curl -G "https://api.qovia.ai/v1/raw/tieba/user?portrait=tb.1.704b7e76.oTmPuocly9yrPuREuR_FUg" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"uid_hash":"8d41e0a7c2f5","user_id":"1234567890","portrait":"tb.1.5a3c9e10.Qx7nB2kLmP4rT8vW1yZ0aA","nickname":"阿拉德老玩家","username":"alade_player","followers":5,"following":3,"total_likes":138,"account_age_years":13.1,"ip_location":"湖北","gender":"male","deregistered":false,"extra":{"tieba_uid":"300000001"},"prov":{"hash":"0x9a8b7c6d5e4f3021","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

## Zhihu

### GET /v1/raw/zhihu/question — Zhihu question detail

ID: raw.zhihu.question. Docs: https://qovia.ai/docs/api-reference/raw.zhihu.question/
One Zhihu question: title and description (plain text, its images listed apart), answer, follower, view and comment counts, asked and last-edited times (Beijing time). This route does not name the asker. A question that does not exist answers 404 and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- question_id (required; string): Question ID (the number in zhihu.com/question/<ID>)
Example request: curl -G "https://api.qovia.ai/v1/raw/zhihu/question?question_id=2096149013556721446" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_zhi_66b674e3553a","src":"social","platform":"zhihu","lang":"zh-CN","text":"医保个人账户跨省共济落地全国，意味着什么？将带来哪些利好？\n近日，国家医保局上线医保钱包2.0版。自10月16日起，全国各省、自治区、直辖市及新疆生产建设兵团已全部上线运行，职工医保个人账户跨省共济在全国全面落地。\n职工医保个人账户跨省共济，依托全国统一医保信息平台设立个人医保钱…","author":null,"metrics":{"answers":215,"followers":1189,"views":795008,"comments":18},"extra":{"source_id":"2096149013556721446","content_type":"question","title":"医保个人账户跨省共济落地全国，意味着什么？将带来哪些利好？","published_at":"2026-10-21T08:01:09+08:00","updated_at":"2026-10-21T08:01:09+08:00","question_type":"normal","images":["https://pic3.zhimg.com/v2-45bde134b33053a220851030596f9a10_r.jpg"],"url":"https://www.zhihu.com/question/2096149013556721446"},"prov":{"hash":"0xc4475716f5e931bd","ts":"2026-10-21T23:45:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/zhihu/answers — Zhihu question answers

ID: raw.zhihu.answers. Docs: https://qovia.ai/docs/api-reference/raw.zhihu.answers/
Answers to one question, up to 20: text (plain text, its images listed apart), author (with followers), upvotes, comments, saves, published and edited times, as the same records as answer detail (same ids). Zhihu's default order or newest first. First page only: Zhihu's next page cannot be reached through the current source. A question without answers answers empty, one that does not exist 404 or empty; neither is charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- question_id (required; string): Question ID (the number in zhihu.com/question/<ID>)
- sort (optional; string; one of "default", "latest"; default "default"): Order: default (Zhihu's ranking, the default) or latest (newest first)
- count (optional; integer; default 20; min 1; max 20): How many answers
Example request: curl -G "https://api.qovia.ai/v1/raw/zhihu/answers?question_id=2096149013556721446" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_zhi_0adb8742dcb5","src":"social","platform":"zhihu","lang":"zh-CN","text":"必须点个赞，对老百姓确实是个好事来的。\n简单来说，这套制度其实有点类似支付宝的亲情卡，就是你可以把某个人绑定你的亲情卡，然后设定一个限额，被绑定的这个人用支付宝支付的时候就可以直接用亲情卡支付，说白了就是可以在这个限额内花你的钱。\n只不过支付宝亲情卡的绑定门槛比较低，只要你愿意，…","author":{"uid_hash":"86af6819638a","followers":16239,"nickname":"法途萤光","user_id":"67ea9758246085568d7b80fd4dc7e1cd","url_token":"lao-bei-jing-feng-jing"},"metrics":{"likes":575,"comments":118,"saves":376},"extra":{"source_id":"2096190323630387908","content_type":"answer","title":"医保个人账户跨省共济落地全国，意味着什么？将带来哪些利好？","question_id":"2096149013556721446","published_at":"2026-10-21T10:45:18+08:00","updated_at":"2026-10-21T10:45:18+08:00","images":["https://pic1.zhimg.com/v2-e642605f52f9daec39c479ea4b30c974_r.jpg?source=1def8aca"],"cover_url":"https://pica.zhimg.com/80/v2-321f1f4709aab5b1d37b1f459cfdd7a8_720w.jpg?source=1def8aca","url":"https://www.zhihu.com/question/2096149013556721446/answer/2096190323630387908"},"prov":{"hash":"0xb583077894ac21f0","ts":"2026-10-21T23:45:00+08:00","source":"live"}},{"id":"soc_zhi_5ef66c782c7d","src":"social","platform":"zhihu","lang":"zh-CN","text":"这是在医保跨省就医先备案再结算的基础上又一项便利的举措。\n推出医保个人账户跨省共济，对于那些个人账户躺着大笔资金，又在异地有亲人要就医治疗的人来说，终于可以使用个人账户的资金来帮助亲人看病了。意味着你职工医保个人账户里的钱，可以跨省给在老家的近亲属用了。\n知乎有一个比较热的讨论话…","author":{"uid_hash":"edd664f97ba1","followers":104,"nickname":"任***生","user_id":"00000000000000000000000000000001","url_token":"example-user-1"},"metrics":{"likes":64,"comments":24,"saves":22},"extra":{"source_id":"2096156906813387925","content_type":"answer","title":"医保个人账户跨省共济落地全国，意味着什么？将带来哪些利好？","question_id":"2096149013556721446","published_at":"2026-10-21T08:32:31+08:00","updated_at":"2026-10-21T08:32:31+08:00","images":[],"cover_url":null,"url":"https://www.zhihu.com/question/2096149013556721446/answer/2096156906813387925"},"prov":{"hash":"0x7ee96186b1cd145c","ts":"2026-10-21T23:45:00+08:00","source":"live"}}],"prov":{"hash":"0x606c3670bc320b62","ts":"2026-10-21T23:45:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/zhihu/answer — Zhihu answer detail

ID: raw.zhihu.answer. Docs: https://qovia.ai/docs/api-reference/raw.zhihu.answer/
One answer: text (plain text, its images listed apart), author, its question (title and ID), published and edited times, as the same record as the answer list (same id). This route carries no upvote, comment or save counts (null): raw.zhihu.answers and raw.zhihu.article_search do. An answer that does not exist answers 404 and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- answer_id (required; string): Answer ID (the number in zhihu.com/question/<question ID>/answer/<ID>)
Example request: curl -G "https://api.qovia.ai/v1/raw/zhihu/answer?answer_id=2096190323630387908" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_zhi_0adb8742dcb5","src":"social","platform":"zhihu","lang":"zh-CN","text":"必须点个赞，对老百姓确实是个好事来的。\n简单来说，这套制度其实有点类似支付宝的亲情卡，就是你可以把某个人绑定你的亲情卡，然后设定一个限额，被绑定的这个人用支付宝支付的时候就可以直接用亲情卡支付，说白了就是可以在这个限额内花你的钱。\n只不过支付宝亲情卡的绑定门槛比较低，只要你愿意，…","author":{"uid_hash":"86af6819638a","followers":null,"nickname":"法途萤光","user_id":"67ea9758246085568d7b80fd4dc7e1cd","url_token":"lao-bei-jing-feng-jing"},"metrics":{"likes":null,"comments":null,"saves":null},"extra":{"source_id":"2096190323630387908","content_type":"answer","title":"医保个人账户跨省共济落地全国，意味着什么？将带来哪些利好？","question_id":"2096149013556721446","published_at":"2026-10-21T10:45:18+08:00","updated_at":"2026-10-21T10:45:18+08:00","images":["https://picx.zhimg.com/v2-e642605f52f9daec39c479ea4b30c974_r.jpg?source=2c26e567"],"cover_url":"https://picx.zhimg.com/v2-e642605f52f9daec39c479ea4b30c974_r.jpg?source=2c26e567","url":"https://www.zhihu.com/question/2096149013556721446/answer/2096190323630387908"},"prov":{"hash":"0xb894b5103868a2cb","ts":"2026-10-21T23:45:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/zhihu/comments — Zhihu answer comments

ID: raw.zhihu.comments. Docs: https://qovia.ai/docs/api-reference/raw.zhihu.comments/
First-level comments of an answer, cursor-paginated, 10 a page: text, likes, reply count, IP location, time (Beijing time), whether it is a hot comment, and the commenter. Hottest first (the default) or newest first. Pass the previous page's cursor back to continue; stop when has_more is false. Replies come from raw.zhihu.comment_replies. An answer without comments, or one that does not exist, answers empty and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- answer_id (required; string): Answer ID
- sort (optional; string; one of "hot", "latest"; default "hot"): Order: hot (the default) or latest (newest first)
- cursor (optional; string): The cursor from the previous page's response; leave it out for the first page
Example request: curl -G "https://api.qovia.ai/v1/raw/zhihu/comments?answer_id=2096190323630387908" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"cid":"11601712556","text":"本来就是个人账户的钱，没啥值得老百姓鼓掌的","likes":109,"ip_location":"北京","reply_count":15,"created_at":"2026-10-21T13:08:56+08:00","is_hot":false,"images":[],"author":{"uid_hash":"94b392d47736","nickname":"L***e","user_id":"00000000000000000000000000000002","url_token":"example-user-2"}},{"cid":"11601773273","text":"其实没啥用，因为国家没出钱。个人账户的钱跟你个人银行卡的钱其实差不多，迟早都是用的。而且，大部分人，个人账户也没多少钱，有的都是体制内的。","likes":52,"ip_location":"重庆","reply_count":5,"created_at":"2026-10-21T14:21:30+08:00","is_hot":false,"images":[],"author":{"uid_hash":"02bcf44137fc","nickname":"山***生","user_id":"00000000000000000000000000000003","url_token":"example-user-3"}}],"cursor":"648091405_11601921724_0","has_more":true,"total":118,"prov":{"hash":"0xfe8c592741eb8410","ts":"2026-10-21T23:45:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/zhihu/comment_replies — Zhihu comment replies

ID: raw.zhihu.comment_replies. Docs: https://qovia.ai/docs/api-reference/raw.zhihu.comment_replies/
Replies under one first-level comment, cursor-paginated, up to 20 a page: text, likes, IP location, time (Beijing time), the reply it answers, and the replier. Hottest first (the default) or oldest first. Pass the previous page's cursor back to continue; stop when has_more is false. A comment without replies answers empty and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- comment_id (required; string): First-level comment cid (from the answer comments endpoint)
- sort (optional; string; one of "hot", "oldest"; default "hot"): Order: hot (the default) or oldest (oldest first)
- count (optional; integer; default 20; min 1; max 20): Items per page
- cursor (optional; string): The cursor from the previous page's response; leave it out for the first page
Example request: curl -G "https://api.qovia.ai/v1/raw/zhihu/comment_replies?comment_id=11601712556" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"cid":"11601513968","text":"改变就是好事","likes":46,"ip_location":"广东","reply_count":null,"created_at":"2026-10-21T14:57:14+08:00","is_hot":false,"images":[],"author":{"uid_hash":"8a8ca2db203a","nickname":"一***佬","user_id":"00000000000000000000000000000004","url_token":"example-user-4"},"parent_cid":"11601712556","reply_to_cid":null},{"cid":"11601688358","text":"做得好可以稍微夸一下，这是正负应该做的，做得不好就该直接骂","likes":8,"ip_location":"广东","reply_count":null,"created_at":"2026-10-21T16:27:12+08:00","is_hot":false,"images":[],"author":{"uid_hash":"c5330daf21ae","nickname":"A***号","user_id":"00000000000000000000000000000005","url_token":"example-user-5"},"parent_cid":"11601712556","reply_to_cid":"11601513968"}],"cursor":"1792574724_11602011360_0","has_more":true,"total":15,"prov":{"hash":"0x0595094c4644d6f1","ts":"2026-10-21T23:45:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/zhihu/user — Zhihu user profile

ID: raw.zhihu.user. Docs: https://qovia.ai/docs/api-reference/raw.zhihu.user/
A Zhihu user's profile: nickname, followers, answer and article counts, verification, whether it is an organisation, IP location, employers listed on the profile, headline and avatar. Pass the url_token (from zhihu.com/people/<url_token>). This route carries no following or upvote totals. A user that does not exist answers 404 and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- url_token (required; string): The user's url_token (from zhihu.com/people/<url_token>)
Example request: curl -G "https://api.qovia.ai/v1/raw/zhihu/user?url_token=lao-bei-jing-feng-jing" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"uid_hash":"86af6819638a","platform":"zhihu","user_id":"67ea9758246085568d7b80fd4dc7e1cd","url_token":"lao-bei-jing-feng-jing","nickname":"法途萤光","followers":16239,"answers":2068,"articles":26,"verified":true,"verify_reason":"法律职业资格证持证人","is_org":false,"ip_location":"广东","employers":["律师事务所","金融企业"],"signature":"吃货法师\n法律行业多年工作经验 亏啥也不能亏了胃","avatar_url":"https://pic1.zhimg.com/v2-fdb0486b8ed0dd00d64eec59f834e3a0_xl.jpg?source=32738c0c&needBackground=1","url":"https://www.zhihu.com/people/lao-bei-jing-feng-jing","prov":{"hash":"0xbfe9dbbcafef308b","ts":"2026-10-21T23:45:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/zhihu/hot_list — Zhihu hot list

ID: raw.zhihu.hot_list. Docs: https://qovia.ai/docs/api-reference/raw.zhihu.hot_list/
Zhihu's hot list, about 30 questions in rank order: title and excerpt, answer and follower counts, rank, heat (「1848 万热度」 is 18480000), the new or hot label and a picture, as the same records as question detail (same ids). The list carries no view or comment counts (null).
Price: $0.001000 per successful call. Status: live.
Parameters: none.
Example request: curl -G "https://api.qovia.ai/v1/raw/zhihu/hot_list" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_zhi_66b674e3553a","src":"social","platform":"zhihu","lang":"zh-CN","text":"医保个人账户跨省共济落地全国，意味着什么？将带来哪些利好？\n近日，国家医保局上线医保钱包2.0版。自10月16日起，全国各省、自治区、直辖市及新疆生产建设兵团已全部上线运行，职工医保个人账户跨省共济在全国全面落地。 职工医保个人账户跨省共济，依托全国统一医保信息平台设立个人医保钱…","author":null,"metrics":{"answers":215,"followers":1188,"views":null,"comments":null},"extra":{"source_id":"2096149013556721446","content_type":"question","title":"医保个人账户跨省共济落地全国，意味着什么？将带来哪些利好？","published_at":"2026-10-21T08:01:09+08:00","rank":1,"heat":18480000,"heat_label":"1848 万热度","label":"hot","cover_url":"https://pica.zhimg.com/v2-d622fc703c850030325b874b3e4adcb9.png","images":[],"url":"https://www.zhihu.com/question/2096149013556721446"},"prov":{"hash":"0xfb11d7b41acae09a","ts":"2026-10-21T23:45:00+08:00","source":"live"}},{"id":"soc_zhi_861c0f35534d","src":"social","platform":"zhihu","lang":"zh-CN","text":"樊振东发文称不管啥心态，都无法改变偷拍不尊重人的本质，如何看待以爱为名的侵扰？怎样算真正支持运动员？\n[图片]","author":null,"metrics":{"answers":252,"followers":450,"views":null,"comments":null},"extra":{"source_id":"2096173845665117950","content_type":"question","title":"樊振东发文称不管啥心态，都无法改变偷拍不尊重人的本质，如何看待以爱为名的侵扰？怎样算真正支持运动员？","published_at":"2026-10-21T09:39:49+08:00","rank":2,"heat":8120000,"heat_label":"812 万热度","label":"hot","cover_url":"https://pic1.zhimg.com/v2-d63563de8c04cec32b17c1638b15c8c8_1440w.png","images":[],"url":"https://www.zhihu.com/question/2096173845665117950"},"prov":{"hash":"0xfb064d5aead1056d","ts":"2026-10-21T23:45:00+08:00","source":"live"}}],"prov":{"hash":"0xea5e6cf55179cb2b","ts":"2026-10-21T23:45:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/zhihu/article_search — Zhihu content search

ID: raw.zhihu.article_search. Docs: https://qovia.ai/docs/api-reference/raw.zhihu.article_search/
Keyword search over Zhihu answers and articles; answers are the same records as answer detail (same ids). Answers or articles only, sort by relevance, most upvoted or newest, filter by publish time (Zhihu applies it loosely). Pass the previous page's cursor and search_id back to continue (adjacent pages may repeat a few records: deduplicate by id); stop when has_more is false. No results answers empty and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- keyword (required; string; min length 1; max length 100): Search keyword
- type (optional; string; one of "all", "answer", "article"; default "all"): Type: all (the default), answer (answers only) or article (articles only)
- sort (optional; string; one of "general", "most_liked", "latest"; default "general"): Order: general (relevance, the default), most_liked (most upvoted) or latest
- publish_time (optional; string; one of "all", "day", "week", "month", "quarter", "half_year", "year"; default "all"): Published within: all (the default), a day, a week, a month, three months, half a year or a year
- cursor (optional; integer; default 0; min 0; max 1000): The cursor from the previous page's response
- search_id (optional; string): The search_id from the previous page's response; leave it out for the first page
Example request: curl -G "https://api.qovia.ai/v1/raw/zhihu/article_search?keyword=deepseek" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_zhi_25f7dab19356","src":"social","platform":"zhihu","lang":"zh-CN","text":"这波开源再次把A\\和O吊起来锤！DS YES\n客观地说，对所以厂商间接的价格压力不小。对国产芯片，昇腾是最大的受益者；其他国产厂商面对的门槛被明显抬高了，国产厂商工作的兄弟们压力不小。\nDeepInfer 最早基于 vLLM 开发，现在的 vLLM 痕迹已经很少，调度器、输入准备…","author":{"uid_hash":"a90a26b11344","followers":7645,"nickname":"不***猫","user_id":"00000000000000000000000000000006","url_token":"example-user-6"},"metrics":{"likes":378,"comments":21,"saves":136},"extra":{"source_id":"2095938107812193081","content_type":"answer","title":"如何看待DeepSeek于10月20日开源的推理框架DeepInfer？","question_id":"2095923427483951981","published_at":"2026-10-20T18:03:05+08:00","updated_at":"2026-10-20T18:03:05+08:00","images":[],"cover_url":null,"url":"https://www.zhihu.com/question/2095923427483951981/answer/2095938107812193081"},"prov":{"hash":"0x33bd97c85d10ed12","ts":"2026-10-21T23:45:00+08:00","source":"live"}},{"id":"soc_zhi_bcd8236779c2","src":"social","platform":"zhihu","lang":"zh-CN","text":"10月17日，DeepSeek开放了自研搜索API。提供搜索、抓取两个接口，开发者几行代码调用，AI就有了一双能看全网的眼睛。\n搜索一次半分钱，5块钱1000次，请求失败不计费。\nDeepSeek出手就干大事。互联网这30年，信息入口的钱有两种赚法，他选了第三种。\n一种是百度式，…","author":{"uid_hash":"86304c158b44","followers":2037,"nickname":"小***论","user_id":"00000000000000000000000000000007","url_token":"example-user-7"},"metrics":{"likes":13,"comments":1,"saves":10},"extra":{"source_id":"2095207817133216122","content_type":"article","title":"实测DeepSeek搜索，半分钱撞了百度的命根子","question_id":null,"published_at":"2026-10-18T17:41:10+08:00","updated_at":"2026-10-18T17:41:10+08:00","images":["https://pic1.zhimg.com/v2-e502668fbe60b2d00cee40968825f82c_r.jpg"],"cover_url":"https://picx.zhimg.com/80/v2-e502668fbe60b2d00cee40968825f82c_qhd.jpg?source=4e949a73","url":"https://zhuanlan.zhihu.com/p/2095207817133216122"},"prov":{"hash":"0xb854e0bc66c21058","ts":"2026-10-21T23:45:00+08:00","source":"live"}}],"cursor":20,"has_more":true,"search_id":"600fd1f58c9c6284ffaac78be50e4d04","prov":{"hash":"0x69388e0514229e45","ts":"2026-10-21T23:45:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

## WeChat Official Accounts & Channels

### GET /v1/raw/wechat/account_search — WeChat official account search

ID: raw.wechat.account_search. Docs: https://qovia.ai/docs/api-reference/raw.wechat.account_search/
Search WeChat official accounts by name or keyword: original ID (gh_…), name, WeChat ID, avatar, description, verifying organization and account type. One page of results, not paginated. kind picks subscription accounts, service accounts or both. No match answers empty and is not charged.
Price: $0.005000 per successful call. Status: live.
Parameters:
- keyword (required; string; min length 1; max length 50): Official account name or keyword
- kind (optional; string; one of "subscription", "service", "all"; default "subscription"): Account type: subscription accounts (default), service accounts, or all (both, de-duplicated)
Example request: curl -G "https://api.qovia.ai/v1/raw/wechat/account_search?keyword=%E5%A4%AE%E8%A7%86%E6%96%B0%E9%97%BB" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_wec_f66c11bf1ab8","mp_id":"gh_example","name":"示例公众号","wechat_id":"example_account","avatar":"https://example.com/avatar.jpg","description":"账号简介","verified":true,"verified_by":"示例机构","type":"subscription"}],"cursor":null,"has_more":false,"prov":{"hash":"0xe249fde3d74fb05b","ts":"2026-10-21T17:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/wechat/articles — WeChat official account articles

ID: raw.wechat.articles. Docs: https://qovia.ai/docs/api-reference/raw.wechat.articles/
History articles of one official account, newest first, one page per call: title, link, publish time, cover, digest, author, IP location and original/paid flags. Pass the previous page's cursor back unchanged to continue; stop when has_more is false. Take mp_id from raw.wechat.account_search. Empty pages are not charged.
Price: $0.005000 per successful call. Status: live.
Parameters:
- mp_id (required; string; max length 64): Official account id (starts with gh_ or wxid_; the mp_id from raw.wechat.account_search)
- cursor (optional; string; max length 1024): The cursor returned by the previous page; omit it for the first page
Example request: curl -G "https://api.qovia.ai/v1/raw/wechat/articles?mp_id=gh_example" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_wec_8d6202d11c59","title":"示例文章","url":"https://mp.weixin.qq.com/s/example","published_at":"2026-10-21T09:30:00+08:00","cover":"https://example.com/cover.jpg","digest":"文章摘要","author":"作者","ip_region":"北京","is_original":true,"is_paid":false,"reads_label":"10万+","likes":7562}],"cursor":"NEXT_OFFSET","has_more":true,"prov":{"hash":"0x6a2bed4dd60ccaaa","ts":"2026-10-21T17:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/wechat/article_metrics — WeChat article metrics

ID: raw.wechat.article_metrics. Docs: https://qovia.ai/docs/api-reference/raw.wechat.article_metrics/
Reads, likes, "watching" (在看), comments and shares of one official account article, with the time the numbers were taken. url is the article's mp.weixin.qq.com link (full or /s/ short form, e.g. the url from raw.wechat.articles). Charged only when metrics come back.
Price: $0.005000 per successful call. Status: live.
Parameters:
- url (required; string; max length 2048): Article link starting with https://mp.weixin.qq.com/ (or http://)
Example request: curl -G "https://api.qovia.ai/v1/raw/wechat/article_metrics?url=https%3A%2F%2Fmp.weixin.qq.com%2Fs%2Fexample" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_wec_8d6202d11c59","url":"https://mp.weixin.qq.com/s/example","reads":12345,"likes":328,"watching":76,"comments":18,"shares":42,"updated_at":"2026-10-21T10:00:00+08:00","prov":{"hash":"0x40520e8eb57a2c12","ts":"2026-10-21T17:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/wechat/channel_search — WeChat Channels search

ID: raw.wechat.channel_search. Docs: https://qovia.ai/docs/api-reference/raw.wechat.channel_search/
Search WeChat Channels (视频号) accounts by name or keyword: account identifier (username), name, bio and avatar. One page of results, not paginated. No match answers empty and is not charged.
Price: $0.005000 per successful call. Status: live.
Parameters:
- keyword (required; string; min length 1; max length 50): Channels account name or keyword
Example request: curl -G "https://api.qovia.ai/v1/raw/wechat/channel_search?keyword=%E5%A4%AE%E8%A7%86%E6%96%B0%E9%97%BB" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_wec_e0ba85643ec6","username":"finder_example","name":"示例视频号","signature":"视频号简介","avatar":"https://example.com/avatar.jpg"}],"cursor":null,"has_more":false,"prov":{"hash":"0x5a9a63dcd685da20","ts":"2026-10-21T17:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

## Xiaohongshu (RedNote)

### GET /v1/raw/xiaohongshu/note — Xiaohongshu (RedNote) note detail

ID: raw.xiaohongshu.note. Docs: https://qovia.ai/docs/api-reference/raw.xiaohongshu.note/
One Xiaohongshu note: title and text, author, exact like / comment / save / share counts, topics, publish time and IP location, images, and for video notes the video link and duration. A note that does not exist or was deleted answers empty and is not charged.
Price: $0.005000 per successful call. Status: live.
Parameters:
- note_id (required; string): Note ID (24 hex characters, the ID in xiaohongshu.com/explore/<ID>)
Example request: curl -G "https://api.qovia.ai/v1/raw/xiaohongshu/note?note_id=6a14846d000000000702d0d4" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_xia_456d9ed67d8b","src":"social","platform":"xiaohongshu","lang":"zh-CN","text":"高三后期，班里开始靠咖啡续命了\n高三后期。\n教室里最常见的饮料已经不是矿泉水了。\n⸻\n是咖啡。\n⸻\n以前上课。\n桌角摆着…","author":{"uid_hash":"16d5e890d464","user_id":"66097f36000000000600cdb3","nickname":"说***吗"},"metrics":{"likes":11045,"comments":1072,"saves":1153,"shares":359},"extra":{"source_id":"6a14846d000000000702d0d4","url":"https://www.xiaohongshu.com/explore/6a14846d000000000702d0d4","title":"高三后期，班里开始靠咖啡续命了","note_type":"image","topic":"#晚自习","topics":["晚自习","高考倒计时","我的高三记忆"],"published_at":"2026-05-26T01:18:37+08:00","ip_location":"山东","cover_url":"https://sns-na-i27.xhscdn.com/notes_pre_post/1040g3k8320jnafonm8805pg9fsr1hjdj6tlakno?imageView2/2/w/1080/format/webp","images":["https://sns-na-i27.xhscdn.com/notes_pre_post/1040g3k8320jnafonm8805pg9fsr1hjdj6tlakno?imageView2/2/w/1080/format/webp"],"video_url":null,"video_dur_s":null},"prov":{"hash":"0x9bfd99f0f6635fc6","ts":"2026-10-21T20:49:50+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/xiaohongshu/comments — Xiaohongshu (RedNote) note comments

ID: raw.xiaohongshu.comments. Docs: https://qovia.ai/docs/api-reference/raw.xiaohongshu.comments/
First-level comments of a note, cursor-paginated: text, likes, reply count, time, IP location, images and the commenter. sort=default (the default) follows Xiaohongshu's own order (pinned and popular first), about 5 a page, with the commenter's user ID; sort=latest is newest first, 10-15 a page, without like counts and with the commenter's Xiaohongshu ID (red_id) only. Pass the previous page's cursor back unchanged to continue; stop when has_more is false. Replies come from raw.xiaohongshu.comment_replies. A note without comments, or one that does not exist, answers empty and is not charged.
Price: $0.005000 per successful call. Status: live.
Parameters:
- note_id (required; string): Note ID (24 hex characters)
- sort (optional; string; one of "default", "latest"; default "default"): Order: default is Xiaohongshu's own (pinned and popular first), latest is newest first
- cursor (optional; string; default ""): The cursor returned by the previous page, passed back unchanged; omit it for the first page
Example request: curl -G "https://api.qovia.ai/v1/raw/xiaohongshu/comments?note_id=6a14846d000000000702d0d4" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_xia_58ce829ad61c","cid":"6a17eab1000000002902f300","text":"喝了晚上还能睡着怎么解","likes":1918,"ip_location":"陕西","reply_count":62,"created_at":"2026-05-28T15:11:45+08:00","images":[],"author":{"uid_hash":"fdff38b77243","user_id":"5978bc135e87e717fbd0bd1c","red_id":null,"nickname":"肉*嘟"}},{"id":"soc_xia_a8db397877ca","cid":"6a1832b2000000002b0021ca","text":"我考研的时候真是靠咖啡续命，然后我还不爱喝咖啡，所以我都只用一点点水冲，冲出来比咳嗽糖浆还浓就直接喝，早中晚都要喝，之后…","likes":777,"ip_location":"山东","reply_count":27,"created_at":"2026-05-28T20:18:59+08:00","images":[],"author":{"uid_hash":"63a7e5825bb9","user_id":"596ea3b25e87e716dd1bfdb8","red_id":null,"nickname":"胖**胖"}}],"cursor":"6a1b938c000000002b025bef","has_more":true,"total":1072,"prov":{"hash":"0x1b64b7d7c2a0e5b3","ts":"2026-10-21T20:50:31+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/xiaohongshu/comment_replies — Xiaohongshu (RedNote) comment replies

ID: raw.xiaohongshu.comment_replies. Docs: https://qovia.ai/docs/api-reference/raw.xiaohongshu.comment_replies/
Replies (second-level comments) under one first-level comment, oldest first, about 5 a page: text, likes, time, images, the replier (nickname and Xiaohongshu ID) and the comment replied to. comment_id is a cid from raw.xiaohongshu.comments. Pass the previous page's cursor back unchanged to continue; stop when has_more is false. No replies answers empty and is not charged.
Price: $0.005000 per successful call. Status: live.
Parameters:
- note_id (required; string): Note ID (24 hex characters)
- comment_id (required; string): First-level comment ID (a cid from raw.xiaohongshu.comments)
- cursor (optional; string; default ""): The cursor returned by the previous page, passed back unchanged; omit it for the first page
Example request: curl -G "https://api.qovia.ai/v1/raw/xiaohongshu/comment_replies?note_id=6a14846d000000000702d0d4&comment_id=6a17eab1000000002902f300" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_xia_f3463aa6961a","cid":"6a18470d0000000027015f08","text":"你是上过高中的[笑哭R]","likes":1070,"ip_location":null,"created_at":"2026-05-28T21:45:50+08:00","images":[],"author":{"uid_hash":null,"user_id":null,"red_id":"397***18","nickname":"野***."},"parent_cid":"6a17eab1000000002902f300","reply_to_cid":null},{"id":"soc_xia_fbe959fab37d","cid":"6a18614d000000002a02c11f","text":"其实早读喝的中午午休睡得可香","likes":259,"ip_location":null,"created_at":"2026-05-28T23:37:50+08:00","images":[],"author":{"uid_hash":null,"user_id":null,"red_id":"941***82","nickname":"不**遇"},"parent_cid":"6a17eab1000000002902f300","reply_to_cid":null}],"cursor":"6a1bcaf5000000002a02cff8","has_more":true,"prov":{"hash":"0xd0d27ac0b189046f","ts":"2026-10-21T20:52:12+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/xiaohongshu/user — Xiaohongshu (RedNote) user profile

ID: raw.xiaohongshu.user. Docs: https://qovia.ai/docs/api-reference/raw.xiaohongshu.user/
A Xiaohongshu user's profile: nickname, Xiaohongshu ID, exact followers, following, likes and saves (together and apart), note count, verification, gender, IP location, bio and avatar. A user that does not exist answers 404 and is not charged.
Price: $0.005000 per successful call. Status: live.
Parameters:
- user_id (required; string): User ID (24 hex characters, the ID in xiaohongshu.com/user/profile/<ID>; not the Xiaohongshu ID)
Example request: curl -G "https://api.qovia.ai/v1/raw/xiaohongshu/user?user_id=60014bac0000000001009be4" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"uid_hash":"0af3127bb080","platform":"xiaohongshu","user_id":"60014bac0000000001009be4","red_id":"Bel***83","nickname":"木**师","followers":10512,"following":1,"likes_and_saves":27720,"likes":18907,"saves":8813,"notes":430,"verified":false,"verify_reason":null,"gender":"female","ip_location":"天津","location":"天津津南","profession":"茶艺师","signature":"我是**\n线下茶艺老师\n直播课周一至周五\n上午10点-13点","avatar_url":"https://sns-avatar-qc-ae.rednotecdn.com/avatar/1040g2jo30pmiu3qp6k005o019em096v44mekl3g?imageView2/2/w/540/format/webp","shop_id":"625113963801e1000190ca26","url":"https://www.xiaohongshu.com/user/profile/60014bac0000000001009be4","prov":{"hash":"0xcd2c76631d6563c1","ts":"2026-10-21T20:51:40+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/xiaohongshu/user_notes — Xiaohongshu (RedNote) user notes

ID: raw.xiaohongshu.user_notes. Docs: https://qovia.ai/docs/api-reference/raw.xiaohongshu.user_notes/
Notes a user posted, pinned ones first and then newest first, about 20 a page: title, text excerpt, like / comment / save / share counts, publish time, cover and images, and for video notes the video link and duration. Pass the previous page's cursor back unchanged to continue; stop when has_more is false. A user without notes, or one that does not exist, answers empty and is not charged.
Price: $0.005000 per successful call. Status: live.
Parameters:
- user_id (required; string): User ID (24 hex characters)
- cursor (optional; string): The cursor returned by the previous page, passed back unchanged; omit it for the first page
Example request: curl -G "https://api.qovia.ai/v1/raw/xiaohongshu/user_notes?user_id=60014bac0000000001009be4" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_xia_0d673b889ef3","src":"social","platform":"xiaohongshu","lang":"zh-CN","text":"斟茶礼，茶桌上的礼仪，你懂吗？\n茶为瑞草魁香，是国之嘉叶，更是融于日常的饮品。\n中华文化源远流长、灿烂辉煌。\n在5000…","author":{"uid_hash":"0af3127bb080","user_id":"60014bac0000000001009be4","nickname":"木**师"},"metrics":{"likes":114,"comments":3,"saves":107,"shares":17},"extra":{"source_id":"64f33666000000001e032bdb","url":"https://www.xiaohongshu.com/explore/64f33666000000001e032bdb","title":"斟茶礼，茶桌上的礼仪，你懂吗？","note_type":"image","topic":null,"topics":[],"published_at":"2023-09-03T08:00:28+08:00","ip_location":null,"cover_url":"https://sns-i14-ae.rednotecdn.com/1040g00830rimgdqmii005o019em096v4b842tco?imageView2/2/w/1440/format/heif/q/45&redImage/frame/0&ap=12&sc=USR_DTL&sign=024e7bca01ab61f655a9685f1413c890&t=6ad8bce1","images":["https://sns-i14-ae.rednotecdn.com/1040g00830rimgdqmii005o019em096v4b842tco?imageView2/2/w/1440/format/heif/q/45&redImage/frame/0&ap=12&sc=USR_DTL&sign=024e7bca01ab61f655a9685f1413c890&t=6ad8bce1"],"video_url":null,"video_dur_s":null,"pinned":true}},{"id":"soc_xia_41e0ee183d8b","src":"social","platform":"xiaohongshu","lang":"zh-CN","text":"炭火煮水泡乌龙茶\n#茶艺培训# #传统# #茶文化# #**#","author":{"uid_hash":"0af3127bb080","user_id":"60014bac0000000001009be4","nickname":"木**师"},"metrics":{"likes":9,"comments":0,"saves":1,"shares":0},"extra":{"source_id":"6ad5e6ba000000000c00dc09","url":"https://www.xiaohongshu.com/explore/6ad5e6ba000000000c00dc09","title":"炭火煮水泡乌龙茶","note_type":"video","topic":"#茶艺培训","topics":["茶艺培训","传统","茶文化"],"published_at":"2026-10-20T07:30:13+08:00","ip_location":"天津","cover_url":"https://sns-i14-ae.rednotecdn.com/1040g2sg326gik5bj4f305o019em096v47k0e1no?imageView2/2/w/1440/format/heif/q/45&redImage/frame/0&ap=12&sc=USR_DTL&sign=fb382a48f922fe7bf9c0daba8f406832&t=6ad8bce1","images":[],"video_url":"https://sns-v27-ae.rednotecdn.com/stream/1/110/258/01ead5e6ad49f2a201037001a1538dd088_258.mp4?sign=4df437fa11f62549afeeff6959f4d34f&t=6add5a20","video_dur_s":187,"pinned":false}}],"cursor":"6a5ef90f000000000402bdef","has_more":true,"prov":{"hash":"0xf188baac4d3eac13","ts":"2026-10-21T20:53:05+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/xiaohongshu/search — Xiaohongshu (RedNote) note search

ID: raw.xiaohongshu.search. Docs: https://qovia.ai/docs/api-reference/raw.xiaohongshu.search/
Search Xiaohongshu notes by keyword, 20 a page: title, text excerpt, author, like / comment / save / share counts, publish time, cover and images, and for video notes the video link and duration. Sort by relevance, newest, most liked, most commented or most saved; filter by note type and publish time. Page with page; stop when has_more is false. No results answers empty and is not charged.
Price: $0.005000 per successful call. Status: live.
Parameters:
- keyword (required; string; min length 1; max length 50): Search keyword
- page (optional; integer; default 1; min 1; max 50): Page number, from 1; stop when has_more is false
- sort (optional; string; one of "general", "latest", "most_liked", "most_commented", "most_saved"; default "general"): Order: general (relevance, the default), latest, most_liked, most_commented or most_saved
- note_type (optional; string; one of "all", "video", "image"; default "all"): Note type: all (the default), video or image notes
- note_time (optional; string; one of "all", "day", "week", "month", "year"; default "all"): Published within: all (the default), a day, a week, a month or a year
Example request: curl -G "https://api.qovia.ai/v1/raw/xiaohongshu/search?keyword=%E5%92%96%E5%95%A1" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_xia_c79d099f083d","src":"social","platform":"xiaohongshu","lang":"zh-CN","text":"真假摩可纳咖啡对比（一）\n图一开封的地方，真的字体会比较清爽，假的是比较粗的，下面的8，真的是相对会扁一点，两个在一起对…","author":{"uid_hash":"7c3b8fbf0df6","user_id":"5a916db4e8ac2b54e8b53aba","nickname":"J*y"},"metrics":{"likes":1205,"comments":1570,"saves":966,"shares":287},"extra":{"source_id":"69f7dc410000000035021f62","url":"https://www.xiaohongshu.com/explore/69f7dc410000000035021f62","title":"真假摩可纳咖啡对比（一）","note_type":"image","topic":null,"topics":[],"published_at":"2026-05-04T07:37:37+08:00","ip_location":null,"cover_url":"https://sns-na-i2.xhscdn.com/notes_pre_post/1040g3k831vnnp4k7hmd04a1oi1mr8elqsn8nfuo?imageView2/2/w/1440/format/heif/q/45&redImage/frame/0&ap=5&sc=SRH_DTL&sign=d1255ac1c4bf31cc41bf6055f160ecbe&t=6ad8bc4c","images":["https://sns-na-i2.xhscdn.com/notes_pre_post/1040g3k831vnnp4k7hmd04a1oi1mr8elqsn8nfuo?imageView2/2/w/1440/format/heif/q/45&redImage/frame/0&ap=5&sc=SRH_DTL&sign=d1255ac1c4bf31cc41bf6055f160ecbe&t=6ad8bc4c"],"video_url":null,"video_dur_s":null}},{"id":"soc_xia_f21edded4be3","src":"social","platform":"xiaohongshu","lang":"zh-CN","text":"天塌了，陪伴了南阳二十年的哥德咖啡倒闭了\n回来过年想约老友来坐坐。结果老友们全都忙，店也倒闭了。好难过。人到中年突然失去…","author":{"uid_hash":"d7b627e0a01d","user_id":"64f839840000000006031878","nickname":"霜*"},"metrics":{"likes":245,"comments":148,"saves":43,"shares":132},"extra":{"source_id":"699ac514000000001a023963","url":"https://www.xiaohongshu.com/explore/699ac514000000001a023963","title":"天塌了，陪伴了南阳二十年的哥德咖啡倒闭了","note_type":"image","topic":null,"topics":[],"published_at":"2026-02-22T16:57:56+08:00","ip_location":null,"cover_url":"https://sns-na-i2.xhscdn.com/1040g00831ssql5qnm85g5p7o7621m63o0hcapb0?imageView2/2/w/1440/format/heif/q/45&redImage/frame/0&ap=5&sc=SRH_DTL&sign=1a03e8797b04253659c7cfc84958295c&t=6ad8bc4c","images":["https://sns-na-i2.xhscdn.com/1040g00831ssql5qnm85g5p7o7621m63o0hcapb0?imageView2/2/w/1440/format/heif/q/45&redImage/frame/0&ap=5&sc=SRH_DTL&sign=1a03e8797b04253659c7cfc84958295c&t=6ad8bc4c"],"video_url":null,"video_dur_s":null}}],"page":1,"has_more":true,"prov":{"hash":"0xeef6e1b624a71251","ts":"2026-10-21T20:54:20+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

## Xiaohongshu Pugongying

### GET /v1/raw/pgy/note — Xiaohongshu Pugongying note detail

ID: raw.pgy.note. Docs: https://qovia.ai/docs/api-reference/raw.pgy.note/
Note body, image structure, likes/saves/comments and topics.
Price: $0.010000 per successful call. Status: live.
Parameters:
- note_id (required; string): Note ID (24 hex characters)
Example request: curl -G "https://api.qovia.ai/v1/raw/pgy/note?note_id=6abcb896000000001a0338c3" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_pgy_ef86d33b7c64","src":"social","platform":"pgy","lang":"zh-CN","text":"早八人通勤咖啡测评｜这三家真的值","author":{"uid_hash":"b2b37c7a90cf","user_id":"5bff56cf000000000500814f","nickname":"咖啡地图","followers":56900},"metrics":{"likes":3204,"comments":517,"saves":1188,"shares":96,"impressions":182040,"reads":24310},"extra":{"note_type":"image","topic":"#咖啡测评","source_id":"6abcb896000000001a0338c3","url":"https://www.xiaohongshu.com/explore/6abcb896000000001a0338c3","title":"早八人通勤咖啡测评｜这三家真的值","topics":["咖啡测评","通勤咖啡"],"published_at":"2026-07-04T08:12:30+08:00","images":["http://ci.xiaohongshu.com/1040g008325nt8kc64a105n2g1j5m6qn4ten67uo?imageView2/2/w/1080/format/jpg"],"video_dur_s":null,"brand":null,"metrics_available":true},"prov":{"hash":"0x28f25812c6759f96","ts":"2026-07-04T09:12:41+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/pgy/featured_comments — Xiaohongshu Pugongying featured comments

ID: raw.pgy.featured_comments. Docs: https://qovia.ai/docs/api-reference/raw.pgy.featured_comments/
Up to 5 featured comments shown on a note page, no pagination; includes commenter nickname and user id, no IP location. A note without comments returns an empty list and is not charged.
Price: $0.005000 per successful call. Status: live.
Parameters:
- note_id (required; string): Note ID (24 hex characters)
Example request: curl -G "https://api.qovia.ai/v1/raw/pgy/featured_comments?note_id=6abcb896000000001a0338c3" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"cid":"426385758826386092","text":"一瓶能用多久呢？","likes":12,"reply_count":2,"created_at":"2026-10-17T23:39:25+08:00","user":{"uid_hash":"e8ff6e2cf04e","user_id":"69c7dadc0000000033024f58","nickname":"你的眼眸"}},{"cid":"426371270022688812","text":"味道闻着怎么样","likes":3,"reply_count":0,"created_at":"2026-10-07T23:46:05+08:00","user":{"uid_hash":"8de9207b2c3f","user_id":"6a72b44f0000000013003000","nickname":"元气少女"}}],"cursor":null,"has_more":false}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/pgy/creator — Xiaohongshu Pugongying creator profile

ID: raw.pgy.creator. Docs: https://qovia.ai/docs/api-reference/raw.pgy.creator/
Creator profile with followers, likes & saves and note count.
Price: $0.010000 per successful call. Status: live.
Parameters:
- user_id (required; string): User ID (24 hex characters)
Example request: curl -G "https://api.qovia.ai/v1/raw/pgy/creator?user_id=5f4efa82000000000100717e" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"uid_hash":"7be2a1c09d4e","nickname":"咖啡地图","followers":56900,"likes_and_saves":702311,"notes":214,"extra":{"source_id":"5f4efa82000000000100717e","url":"https://www.xiaohongshu.com/user/profile/5f4efa82000000000100717e","red_id":"coffeemap","avatar":"https://sns-avatar-qc.xhscdn.com/avatar/63a9c5f0f71eafc781b0debb.jpg?imageView2/2/w/120/format/jpg","location":"上海 徐汇区","gender":"女","personal_tags":["咖啡爱好者","上班族"],"content_tags":[{"category":"美食","tags":["咖啡","探店"]}],"feature_tags":["测评"],"business_notes":18,"read_median":6305,"engagement_median":1066},"prov":{"hash":"0x8eac9416fb78111e","ts":"2026-07-04T09:12:41+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/pgy/note_search — Xiaohongshu Pugongying note search

ID: raw.pgy.note_search. Docs: https://qovia.ai/docs/api-reference/raw.pgy.note_search/
Keyword note search over Pugongying's content square (registered creators only), with impressions, reads, engagements, saves, cooperation/ad flags, brand and author followers. Charged per call, up to 60 notes per page; total is capped at 1000.
Price: $0.010000 per successful call. Status: live.
Parameters:
- keyword (required; string; min length 1; max length 50): Search keyword
- page (optional; integer; default 1; min 1; max 50): Page number, from 1
- page_size (optional; integer; default 20; min 1; max 60): Items per page
- sort (optional; string; one of "hot", "impNum", "readNum", "engageNum", "fansNum"; default "hot"): Sort (descending): hot overall popularity, impNum impressions, readNum reads, engageNum engagement, fansNum author followers
- fans_min (optional; integer; min 0): Minimum author followers
- fans_max (optional; integer; min 0): Maximum author followers
Example request: curl -G "https://api.qovia.ai/v1/raw/pgy/note_search?keyword=%E5%92%96%E5%95%A1" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_pgy_2d421ed0641f","note_id":"6ac8bc350000000012037196","url":"https://www.xiaohongshu.com/explore/6ac8bc350000000012037196","title":"茶百道的咖啡喝了不烧心。。。","published_at":"2026-10-09T18:29:50+08:00","category":"美食","subcategory":"美食测评","note_type":"video","is_cooperation":true,"is_ad":true,"cover":"http://ci.xiaohongshu.com/1040g0083263lnnrg46005q4b9f1q5jbtudr6578?imageView2/2/w/540/format/jpg/q/75","impressions":152935,"reads":13910,"engagements":1196,"saves":259,"author":{"uid_hash":"49b06ca04204","user_id":"688b4bc3000000002802cd7d","nickname":"杨梅在碗里","followers":36800},"brand":"茶百道"}],"total":1000,"cursor":2,"has_more":true}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/pgy/kol_overview — Xiaohongshu Pugongying creator overview

ID: raw.pgy.kol_overview. Docs: https://qovia.ai/docs/api-reference/raw.pgy.kol_overview/
Pugongying creator overview: read and interaction medians with "beats N% of peers" percentiles, activity, invite response rate, 30-day follower growth, accumulated impressions and reads, and Pugongying's estimated CPM / CPUV / CPE (CNY). *_pct fields are 0-100. Empty results are not charged.
Price: $0.010000 per successful call. Status: live.
Parameters:
- user_id (required; string): Creator user ID (24 hex characters)
- business (optional; integer; one of 0, 1; default 0): Notes: 0 regular notes, 1 sponsored notes
Example request: curl -G "https://api.qovia.ai/v1/raw/pgy/kol_overview?user_id=5f4efa82000000000100717e" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"user_id":"5f4efa82000000000100717e","filters":{"business":0},"as_of":"2026-10-19","notes":1,"content_mix":[{"tag":"家居家装","pct":100}],"trade_names":[],"read_median":63054,"read_median_beyond_pct":99.3,"interaction_median":10667,"interaction_beyond_pct":99.8,"picture_read_beyond_pct":98,"video_read_beyond_pct":64.9,"picture_read_cost":0.32,"video_read_cost":1.55,"fans_30d_growth_pct":0.7,"fans_30d_growth_beyond_pct":78.9,"active_days_last_7":7,"is_active":true,"response_rate_pct":41.2,"invites":34,"easy_connect":false,"advantage":"品效型博主","advantage_hint":"外溢指标处于前20%水位","picture_cases":2,"video_cases":0,"impressions":244603,"reads":63054,"engagements":11627,"estimates":{"picture_cpm":0,"picture_cpuv":0,"picture_cpe":0,"video_cpm":12.26,"video_cpuv":0,"video_cpe":0.13},"prov":{"hash":"0xc26246ba63117ade","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/pgy/kol_note_performance — Xiaohongshu Pugongying creator note performance

ID: raw.pgy.kol_note_performance. Docs: https://qovia.ai/docs/api-reference/raw.pgy.kol_note_performance/
Pugongying note performance for a creator over 30 or 90 days: impression, read, interaction, like, save, comment and share medians, 100+/1000+ like ratios, video completion, traffic-source shares (0-1), long-tail reads and the notes in the window. No notes in the window returns empty, not charged.
Price: $0.010000 per successful call. Status: live.
Parameters:
- user_id (required; string): Creator user ID (24 hex characters)
- date_type (optional; integer; one of 1, 2; default 1): Period: 1 last 30 days, 2 last 90 days
- note_type (optional; integer; one of 1, 2, 3; default 3): Note type: 1 image posts, 2 videos, 3 all
- ad_switch (optional; integer; one of 0, 1; default 1): Traffic: 1 all traffic, 0 organic only
- business (optional; integer; one of 0, 1; default 0): Notes: 0 regular notes, 1 sponsored notes
Example request: curl -G "https://api.qovia.ai/v1/raw/pgy/kol_note_performance?user_id=5f4efa82000000000100717e" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"user_id":"5f4efa82000000000100717e","filters":{"ad_switch":1,"business":0,"date_type":1,"note_type":3},"notes_count":1,"video_notes_count":1,"hundred_like_pct":100,"thousand_like_pct":100,"content_mix":[{"tag":"家居家装","pct":100}],"trade_names":[],"impression_median":244603,"impression_median_beyond_pct":99.3,"read_median":63054,"read_median_beyond_pct":99.3,"interaction_median":10667,"interaction_rate_pct":18.4,"interaction_beyond_pct":99.8,"like_median":10007,"save_median":398,"comment_median":262,"share_median":877,"video_full_view_pct":6.5,"video_full_view_beyond_pct":61.5,"picture_3s_view_pct":0,"engagements":11627,"new_followers":83,"traffic_sources":{"impressions":{"homefeed":0.944,"search":0.019,"follow":0.004,"detail":0.008,"nearby":0,"other":0.025},"reads":{"homefeed":0.959,"search":0.009,"follow":0.002,"detail":0.003,"nearby":0,"other":0.027}},"long_term":{"daily":{"period_start":"2026-02-22","period_end":"2026-04-23","notes":4,"recent_reads":1230,"recent_reads_beyond_pct":42.2,"long_term_reads":1287,"long_term_reads_beyond_pct":82.2,"recent_sources_pct":{"search":34.5,"explore":52.2,"profile":3.4,"follow":4.6,"other":5.3},"long_term_sources_pct":{"search":91.3,"explore":0.1,"profile":5.1,"follow":0.7,"other":2.9}},"cooperation":{"period_start":"2026-02-22","period_end":"2026-04-23","notes":0,"recent_reads":null,"recent_reads_beyond_pct":null,"long_term_reads":null,"long_term_reads_beyond_pct":null,"recent_sources_pct":{"search":null,"explore":null,"profile":null,"follow":null,"other":null},"long_term_sources_pct":{"search":null,"explore":null,"profile":null,"follow":null,"other":null}}},"notes":[{"id":"soc_pgy_25e29f4d353a","note_id":"6abb548b000000001803aa44","url":"https://www.xiaohongshu.com/explore/6abb548b000000001803aa44","title":"无限暖暖真人建造？是暖妈亲自设计的家","published_on":"2026-09-29","note_type":"video","cover":"http://ci.xiaohongshu.com/1040g008325mjkbli586g5nqeva108sbu4q7k10g?imageView2/2/w/540/format/jpg/q/75","impressions":244603,"reads":63054,"engagements":11627,"likes":10007,"saves":398}],"prov":{"hash":"0xfe111bced02ca10b","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/pgy/kol_notes — Xiaohongshu Pugongying creator notes

ID: raw.pgy.kol_notes. Docs: https://qovia.ai/docs/api-reference/raw.pgy.kol_notes/
Pugongying note cases for a creator: notes with reads, likes, saves, video/ad flags and cooperation brand. Up to 100 notes per page, charged per call; no notes returns an empty list, not charged. This endpoint is slow (about 5-10 s).
Price: $0.010000 per successful call. Status: live.
Parameters:
- user_id (required; string): Creator user ID (24 hex characters)
- page (optional; integer; default 1; min 1; max 50): Page number, 100 notes per page
- order_type (optional; integer; one of 1, 2, 3; default 1): Sort: 1 newest, 2 most read, 3 most engagement
- note_type (optional; integer; one of 1, 2, 3, 4; default 4): Note type: 1 image posts, 2 videos, 3 sponsored notes, 4 all
- ad_switch (optional; integer; one of 0, 1; default 1): Traffic: 1 all traffic, 0 organic only
Example request: curl -G "https://api.qovia.ai/v1/raw/pgy/kol_notes?user_id=5f4efa82000000000100717e" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_pgy_25e29f4d353a","note_id":"6abb548b000000001803aa44","url":"https://www.xiaohongshu.com/explore/6abb548b000000001803aa44","title":"无限暖暖真人建造？是暖妈亲自设计的家","published_on":"2026-09-29","is_video":true,"is_ad":false,"brand":null,"cover":"http://ci.xiaohongshu.com/1040g008325mjkbli586g5nqeva108sbu4q7k10g?imageView2/2/w/540/format/jpg/q/75","reads":63054,"likes":10007,"saves":398}],"total":12,"cursor":null,"has_more":false}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/pgy/kol_core_data — Xiaohongshu Pugongying creator core data

ID: raw.pgy.kol_core_data. Docs: https://qovia.ai/docs/api-reference/raw.pgy.kol_core_data/
Pugongying core data for a creator over 30 or 90 days: impressions, reads and engagements in total and per day, with CPM, CPV (per read), CPE (per engagement) and CPUV in CNY. Empty results are not charged.
Price: $0.010000 per successful call. Status: live.
Parameters:
- user_id (required; string): Creator user ID (24 hex characters)
- date_type (optional; integer; one of 1, 2; default 1): Period: 1 last 30 days, 2 last 90 days
- note_type (optional; integer; one of 1, 2, 3; default 3): Note type: 1 image posts, 2 videos, 3 all
- ad_switch (optional; integer; one of 0, 1; default 1): Traffic: 1 all traffic, 0 organic only
- business (optional; integer; one of 0, 1; default 0): Notes: 0 regular notes, 1 sponsored notes
Example request: curl -G "https://api.qovia.ai/v1/raw/pgy/kol_core_data?user_id=5f4efa82000000000100717e" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"user_id":"5f4efa82000000000100717e","filters":{"ad_switch":1,"business":0,"date_type":1,"note_type":3},"as_of":"2026-10-19","summary":{"impressions":244603,"reads":63054,"engagements":11627,"cpm":6.13,"cpv":0.07,"cpe":0.13,"cpuv":0},"daily":[{"date":"2026-09-20","impressions":47686,"reads":9883,"engagements":316,"cpm":20.97,"cpv":0,"cpe":3.16,"cpuv":0},{"date":"2026-09-21","impressions":49077,"reads":10178,"engagements":321,"cpm":20.38,"cpv":0,"cpe":3.11,"cpuv":0}],"prov":{"hash":"0x419c351cf5248cdc","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/pgy/kol_fans_summary — Xiaohongshu Pugongying creator fan summary

ID: raw.pgy.kol_fans_summary. Docs: https://qovia.ai/docs/api-reference/raw.pgy.kol_fans_summary/
Pugongying fan summary for a creator: followers and growth, active / engaged / reading / paying fans with their ratios and "beats N% of peers" percentiles (*_pct fields are 0-100). Empty results are not charged.
Price: $0.010000 per successful call. Status: live.
Parameters:
- user_id (required; string): Creator user ID (24 hex characters)
Example request: curl -G "https://api.qovia.ai/v1/raw/pgy/kol_fans_summary?user_id=5f4efa82000000000100717e" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"user_id":"5f4efa82000000000100717e","followers":13568,"followers_gained":93,"growth_pct":0.7,"growth_beyond_pct":78.9,"active_fans_28d":7989,"active_fans_pct":58.9,"active_fans_beyond_pct":23.1,"engaged_fans_30d":132,"engaged_fans_pct":1,"engaged_fans_beyond_pct":75.5,"reading_fans_30d":410,"reading_fans_pct":3,"reading_fans_beyond_pct":57.2,"paying_fans_30d":1347,"paying_fans_pct":9.9,"prov":{"hash":"0x6533d772bc5369ce","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/pgy/kol_fans_profile — Xiaohongshu Pugongying creator fan profile

ID: raw.pgy.kol_fans_profile. Docs: https://qovia.ai/docs/api-reference/raw.pgy.kol_fans_profile/
Pugongying fan profile for a creator: age, gender, interest, province, city and device distributions (share is a 0-1 fraction). Creators without a profile return empty, not charged.
Price: $0.010000 per successful call. Status: live.
Parameters:
- user_id (required; string): Creator user ID (24 hex characters)
Example request: curl -G "https://api.qovia.ai/v1/raw/pgy/kol_fans_profile?user_id=5f4efa82000000000100717e" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"user_id":"5f4efa82000000000100717e","as_of":"2026-10-19","ages":[{"group":"18-24","share":0.238},{"group":"25-34","share":0.4}],"gender":{"male":0.578,"female":0.422},"interests":[{"name":"生活记录","share":0.127}],"provinces":[{"name":"广东","share":0.13}],"cities":[{"name":"上海","share":0.054}],"devices":[{"name":"apple inc.","label":"苹果","share":0.266}],"prov":{"hash":"0xa0934a07ad371913","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/pgy/kol_fans_trend — Xiaohongshu Pugongying creator follower trend

ID: raw.pgy.kol_fans_trend. Docs: https://qovia.ai/docs/api-reference/raw.pgy.kol_fans_trend/
Pugongying follower trend for a creator: daily follower totals or increments over 30 or 60 days, with the net gain and its ratio (gained_share is 0-1). Empty results are not charged.
Price: $0.010000 per successful call. Status: live.
Parameters:
- user_id (required; string): Creator user ID (24 hex characters)
- date_type (optional; integer; one of 1, 2; default 1): Period: 1 last 30 days, 2 last 60 days
- increase_type (optional; integer; one of 1, 2; default 1): Values: 1 total followers, 2 daily change
Example request: curl -G "https://api.qovia.ai/v1/raw/pgy/kol_fans_trend?user_id=5f4efa82000000000100717e" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"user_id":"5f4efa82000000000100717e","filters":{"date_type":1,"increase_type":1},"gained":93,"gained_share":0.0069,"points":[{"date":"2026-09-20","value":13475},{"date":"2026-09-21","value":13478}],"prov":{"hash":"0x0ac87331786ef97c","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

## TikTok

### GET /v1/raw/tiktok/video — TikTok video detail

ID: raw.tiktok.video. Docs: https://qovia.ai/docs/api-reference/raw.tiktok.video/
One TikTok post: caption, author, play / like / comment / share / save counts, hashtags (with their IDs), publish time (UTC), duration, cover and link. A post that does not exist or was deleted answers 404 and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- video_id (required; string): TikTok post ID (the number in tiktok.com/@user/video/<ID>)
Example request: curl -G "https://api.qovia.ai/v1/raw/tiktok/video?video_id=7688834577418194206" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_tik_a0e58b99a96a","src":"social","platform":"tiktok","lang":"en","text":"this group chat deserves a soundtrack 🎤 TikTok x #TheVoice, all season long. #TheVoice 3-night premiere continues tonight, Sept. 23 at 8 p.m. EDT on @NBC and next day on @Peacock 🎶 @NBC's The Voice ","author":{"uid_hash":"bc27041e9163","followers":96372896,"nickname":"TikTok","uid":"107955","sec_uid":"MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM","unique_id":"tiktok"},"metrics":{"likes":17754,"comments":1867,"shares":729,"saves":1129,"plays":661019},"extra":{"source_id":"7688834577418194206","published_at":"2026-09-23T20:45:19+00:00","video_dur_s":42,"topic":"#thevoice","topics":["thevoice"],"topic_ids":{"thevoice":"43468"},"content_type":"video","cover_url":"https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oooSzAqDVEOeU6TFEAAHpAEJII00fa5A2jIlCe~tplv-tiktokx-cropcenter-q:300:400:q70.heic?dr=8596&refresh_token=6b7e99b2&x-expires=1792681200&x-signature=cmACeVJq2y7ze6VQmLiCVMz1eFY%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=1d1a97fc&idc=useast5&s=AWEME_DETAIL&sc=cover&biz_tag=tt_video","url":"https://www.tiktok.com/@tiktok/video/7688834577418194206"},"prov":{"hash":"0x77779098e3ad0e76","ts":"2026-10-21T23:15:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/tiktok/comments — TikTok video comments

ID: raw.tiktok.comments. Docs: https://qovia.ai/docs/api-reference/raw.tiktok.comments/
First-level comments of a post, cursor-paginated, up to 50 a page: text, likes, reply count, time (UTC), whether the creator liked it, and the commenter. Pass the previous page's cursor back to continue; stop when has_more is false. Replies come from raw.tiktok.comment_replies. A post without comments, or one that does not exist, answers empty and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- video_id (required; string): TikTok post ID
- cursor (optional; integer; default 0; min 0): The cursor from the previous page's response
- count (optional; integer; default 20; min 1; max 50): Items per page
Example request: curl -G "https://api.qovia.ai/v1/raw/tiktok/comments?video_id=7688834577418194206" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"cid":"7688835994091668276","text":"[Sticker] Damm they sound like angels","likes":669,"reply_count":8,"created_at":"2026-09-23T20:50:58+00:00","liked_by_author":true,"images":[],"author":{"uid_hash":"1c77d3208293","nickname":"B***~","uid":"7000000000000000001","sec_uid":"MS4wLjABAAAAexampleTikTokUserSecUid0000000000000001","unique_id":"example.user.1"}},{"cid":"7688850784449053453","text":"Riley Green and his duck noise 😂","likes":236,"reply_count":9,"created_at":"2026-09-23T21:48:44+00:00","liked_by_author":true,"images":[],"author":{"uid_hash":"8201ad78c9e9","nickname":"A***o","uid":"7000000000000000002","sec_uid":"MS4wLjABAAAAexampleTikTokUserSecUid0000000000000002","unique_id":"example.user.2"}}],"cursor":20,"has_more":true,"total":1867,"prov":{"hash":"0x1b8d24ed4d820c6f","ts":"2026-10-21T23:15:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/tiktok/comment_replies — TikTok comment replies

ID: raw.tiktok.comment_replies. Docs: https://qovia.ai/docs/api-reference/raw.tiktok.comment_replies/
Replies under one comment, cursor-paginated, up to 50 a page: text, likes, time (UTC), the reply it answers, and the replier. Pass the previous page's cursor back to continue; stop when has_more is false. A comment without replies answers empty and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- video_id (required; string): TikTok post ID
- comment_id (required; string): Parent comment cid (from the video comments endpoint)
- cursor (optional; integer; default 0; min 0): The cursor from the previous page's response
- count (optional; integer; default 20; min 1; max 50): Items per page
Example request: curl -G "https://api.qovia.ai/v1/raw/tiktok/comment_replies?video_id=7688834577418194206&comment_id=7688850784449053453" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"cid":"7689194623361434398","text":"name a better duo 😂","likes":38,"reply_count":null,"created_at":"2026-09-24T20:02:46+00:00","liked_by_author":false,"images":[],"author":{"uid_hash":"bc27041e9163","nickname":"TikTok","uid":"107955","sec_uid":"MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM","unique_id":"tiktok"},"parent_cid":"7688850784449053453","reply_to_cid":null},{"cid":"7689268967651721992","text":"why. is just an ok now? [Photo]","likes":0,"reply_count":null,"created_at":"2026-09-25T00:54:09+00:00","liked_by_author":false,"images":[],"author":{"uid_hash":"db5a3d41c0fa","nickname":"X***✓","uid":"7000000000000000003","sec_uid":"MS4wLjABAAAAexampleTikTokUserSecUid0000000000000003","unique_id":"example.user.3"},"parent_cid":"7688850784449053453","reply_to_cid":"7689194623361434398"}],"cursor":5,"has_more":true,"total":9,"prov":{"hash":"0x3213b2049308e5a3","ts":"2026-10-21T23:15:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/tiktok/creator — TikTok creator profile

ID: raw.tiktok.creator. Docs: https://qovia.ai/docs/api-reference/raw.tiktok.creator/
Creator profile with followers, likes, post count, following, bio, verification and avatar. Pass either sec_uid or unique_id (the username). An account that does not exist answers 404 or 400 and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- sec_uid (optional; string): The user's sec_uid (starts with MS4wLjABAAAA); pass this or unique_id
- unique_id (optional; string): The username (from tiktok.com/@<username>, without the @); pass this or sec_uid
Example request: curl -G "https://api.qovia.ai/v1/raw/tiktok/creator?unique_id=nike" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"uid_hash":"bc27041e9163","nickname":"TikTok","followers":96372866,"total_likes":465910260,"posts":1598,"verified":true,"platform":"tiktok","uid":"107955","sec_uid":"MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM","unique_id":"tiktok","following":1,"signature":"Your next discovery is waiting on TikTok.","verify_reason":"Verified account","avatar_url":"https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.webp?dr=9640&refresh_token=4f36520e&x-expires=1792767600&x-signature=s4%2F4qptOFzoXARYNzQD1JyH0SsI%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=2472a6c6&idc=useast5","url":"https://www.tiktok.com/@tiktok","prov":{"hash":"0x6c101e1fbe7982ea","ts":"2026-10-21T23:15:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/tiktok/creator_videos — TikTok creator videos

ID: raw.tiktok.creator_videos. Docs: https://qovia.ai/docs/api-reference/raw.tiktok.creator_videos/
Posts a creator published, newest first (or most popular first), about 10 a page, as the same records as video detail (same ids). Pass either sec_uid or unique_id. Pass the previous page's cursor back to continue; stop when has_more is false. A creator without posts answers empty and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- sec_uid (optional; string): The user's sec_uid (starts with MS4wLjABAAAA); pass this or unique_id
- unique_id (optional; string): The username (without the @); pass this or sec_uid
- cursor (optional; integer; default 0; min 0): The cursor from the previous page's response; 0 for the first page
- sort (optional; string; one of "latest", "popular"; default "latest"): Order: latest (the default) or popular
Example request: curl -G "https://api.qovia.ai/v1/raw/tiktok/creator_videos?unique_id=tiktok" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_tik_1d1dace29c96","src":"social","platform":"tiktok","lang":"en","text":"The throwback sounds we didn’t know we were missing, brought back to life on the FYF 💖 @Adam Barrera unpacks how nostalgia took over TikTok.","author":{"uid_hash":"bc27041e9163","followers":96383847,"nickname":"TikTok","uid":"107955","sec_uid":"MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM","unique_id":"tiktok"},"metrics":{"likes":2160,"comments":664,"shares":152,"saves":160,"plays":110453},"extra":{"source_id":"7698770783367171359","published_at":"2026-10-20T15:23:03+00:00","video_dur_s":106,"topic":null,"topics":[],"topic_ids":{},"content_type":"video","cover_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/oYiO1Aj1aA7yiGqAi938DIhBKXXfIw5ACi9AEB~tplv-tiktokx-cropcenter-q:300:400:q70.heic?dr=9232&refresh_token=e4308f3a&x-expires=1792681200&x-signature=yjGRqzothcZNOi4xf%2F2QzNi%2FUdo%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=132edbea&idc=no1a&biz_tag=tt_video&s=PUBLISH&sc=cover","url":"https://www.tiktok.com/@tiktok/video/7698770783367171359"},"prov":{"hash":"0xe2c5655a06b2623a","ts":"2026-10-21T23:15:00+08:00","source":"live"}},{"id":"soc_tik_fddf5cf084af","src":"social","platform":"tiktok","lang":"en","text":"this summer gave us pop songs, glam routines, and a few main-character habits. @McCall Mirabella breaks down this summer's souvenirs 🐬☀️","author":{"uid_hash":"bc27041e9163","followers":96383847,"nickname":"TikTok","uid":"107955","sec_uid":"MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM","unique_id":"tiktok"},"metrics":{"likes":13070,"comments":5347,"shares":1372,"saves":1303,"plays":1410452},"extra":{"source_id":"7694797676306615583","published_at":"2026-10-09T22:25:11+00:00","video_dur_s":50,"topic":null,"topics":[],"topic_ids":{},"content_type":"video","cover_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/osDEKIayAATxid4XIifhL1BBXAZ8wiCZcATiAJ~tplv-tiktokx-cropcenter-q:300:400:q70.heic?dr=9232&refresh_token=07634866&x-expires=1792681200&x-signature=N3eW1jFxXijNDzUyLY2HaLYHC48%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=132edbea&idc=no1a&biz_tag=tt_video&s=PUBLISH&sc=cover","url":"https://www.tiktok.com/@tiktok/video/7694797676306615583"},"prov":{"hash":"0xe4f1a942a3c4df06","ts":"2026-10-21T23:15:00+08:00","source":"live"}}],"cursor":1788883336438,"has_more":true,"prov":{"hash":"0x011d1392782e7aec","ts":"2026-10-21T23:15:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/tiktok/search — TikTok video search

ID: raw.tiktok.search. Docs: https://qovia.ai/docs/api-reference/raw.tiktok.search/
Search TikTok posts by keyword, as the same records as video detail (same ids); sort by relevance or likes, filter by publish time, pick the region. Pass the previous page's cursor back to continue (adjacent pages may repeat a few posts: deduplicate by id); stop when has_more is false. No results answers empty and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- keyword (required; string; min length 1; max length 100): Search keyword
- cursor (optional; integer; default 0; min 0; max 1000): The cursor from the previous page's response
- count (optional; integer; default 20; min 1; max 30): Items per page
- sort (optional; string; one of "general", "most_liked"; default "general"): Order: general (relevance, the default) or most_liked
- publish_time (optional; string; one of "all", "day", "week", "month", "quarter", "half_year"; default "all"): Published within: all (the default), a day, a week, a month, three months or half a year
- region (optional; string; default "US"): Region, a two-letter uppercase country code (ISO 3166-1); US by default
Example request: curl -G "https://api.qovia.ai/v1/raw/tiktok/search?keyword=nike&region=US" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_tik_9e48546cd716","src":"social","platform":"tiktok","lang":"en","text":"Nike mind 001 🔥🔥🔥 #fyp #sneakers #streetwear #streetwear #nike ","author":{"uid_hash":"e3ccd58d819c","followers":2950,"nickname":"Q***y","uid":"7000000000000000004","sec_uid":"MS4wLjABAAAAexampleTikTokUserSecUid0000000000000004","unique_id":"example.user.4"},"metrics":{"likes":19,"comments":0,"shares":0,"saves":0,"plays":4281},"extra":{"source_id":"7699038487848193282","published_at":"2026-10-21T08:41:33+00:00","video_dur_s":11,"topic":"#fyp","topics":["fyp","sneakers","streetwear","nike"],"topic_ids":{"fyp":"229207","sneakers":"64092","streetwear":"315492","nike":"9789"},"content_type":"video","cover_url":"https://p16-common-sign.tiktokcdn-us.com/tos-no1a-p-0037-no/ocAJwFYyq2TsDernRfgBHCEjgkEVFGxQAqAxQ4~tplv-tiktokx-cropcenter:500:800.jpeg?biz_tag=musically_video.video_cover&dr=9638&idc=useast8&ps=13740610&refresh_token=a400b46e&shcp=9b759fb9&shp=c1333099&t=4d5b0474&x-expires=1792616400&x-signature=xphAE2iSQWb3avOQxS%2BXfx0N2ZM%3D","url":"https://www.tiktok.com/@example.user.4/video/7699038487848193282"},"prov":{"hash":"0xe14a962a80ca2a5d","ts":"2026-10-21T23:15:00+08:00","source":"live"}},{"id":"soc_tik_56aaf63cda54","src":"social","platform":"tiktok","lang":"pt","text":"Tênis Nike 😍 #airmax95 #nikesneakers #nikeairmax #sporlife #nike ","author":{"uid_hash":"b04c374c292e","followers":8456,"nickname":"T***🥇","uid":"7000000000000000005","sec_uid":"MS4wLjABAAAAexampleTikTokUserSecUid0000000000000005","unique_id":"example.user.5"},"metrics":{"likes":1071,"comments":6,"shares":69,"saves":92,"plays":9423},"extra":{"source_id":"7698432825535663381","published_at":"2026-10-19T17:31:23+00:00","video_dur_s":15,"topic":"#airmax95","topics":["airmax95","nikesneakers","nikeairmax","sporlife","nike"],"topic_ids":{"airmax95":"3514896","nikesneakers":"3746670","nikeairmax":"702042","sporlife":"43175617","nike":"9789"},"content_type":"video","cover_url":"https://p16-common-sign.tiktokcdn-us.com/tos-alisg-p-0037/oseWwgJgGJFfUFpEAIefACGOsLPTPrGRQh4GGs~tplv-tiktokx-cropcenter:500:800.jpeg?biz_tag=musically_video.video_cover&dr=9638&idc=useast8&ps=13740610&refresh_token=44c1892b&shcp=9b759fb9&shp=c1333099&t=4d5b0474&x-expires=1792616400&x-signature=TraKW2ttdki9mcEnOXr6Jb6Ki%2Fw%3D","url":"https://www.tiktok.com/@example.user.5/video/7698432825535663381"},"prov":{"hash":"0x594f2ae067a753d1","ts":"2026-10-21T23:15:00+08:00","source":"live"}}],"cursor":20,"has_more":true,"prov":{"hash":"0xa1565bda8147e52a","ts":"2026-10-21T23:15:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/tiktok/user_search — TikTok user search

ID: raw.tiktok.user_search. Docs: https://qovia.ai/docs/api-reference/raw.tiktok.user_search/
Keyword search for creators with nickname, username, sec_uid, followers, likes, verification and bio, about 20 a page. Pass the previous page's cursor back to continue; stop when has_more is false. No results answers empty and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- keyword (required; string; min length 1; max length 100): Search keyword
- cursor (optional; integer; default 0; min 0; max 1000): The cursor from the previous page's response
Example request: curl -G "https://api.qovia.ai/v1/raw/tiktok/user_search?keyword=nike" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"uid_hash":"63801dff9c4f","nickname":"Nike","uid":"208464585232822272","sec_uid":"MS4wLjABAAAA_3ndMt8d_tECTdpKgCxcx238tOnQZX-20wqN01aMui5zQ7hsqSdff-jC5qYC-Cl_","unique_id":"nike","followers":9321274,"total_likes":50052777,"verified":true,"verify_reason":"verified account","signature":null,"avatar_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/e0b0ac7b6ad6447a8e923fd1eb162f2c~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&refresh_token=e2a6f980&x-expires=1792681200&x-signature=dxkuSAAlH2pKfgZh8lZMFRIsq3g%3D&t=223449c4&ps=87d6e48a&shp=30310797&shcp=c1333099&idc=no1a&sc=avatar&s=SEARCH","url":"https://www.tiktok.com/@nike"},{"uid_hash":"ff054c516289","nickname":"Nike Football","uid":"7481436802697839659","sec_uid":"MS4wLjABAAAASaJUsOF0LAshl5VRYETtJiROSRolZzdAtYOxG1ldR40x8Qk9pY9zvd3jzQI67kWY","unique_id":"nikefootball","followers":703124,"total_likes":5809232,"verified":true,"verify_reason":"verified account","signature":null,"avatar_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/91b628158cd4dd88147039197d1842b5~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&refresh_token=e8f7a335&x-expires=1792681200&x-signature=ztQtO%2BRjwwF6s9o8UHuLzro4GCs%3D&t=223449c4&ps=87d6e48a&shp=30310797&shcp=c1333099&idc=no1a&sc=avatar&s=SEARCH","url":"https://www.tiktok.com/@nikefootball"}],"cursor":20,"has_more":true,"prov":{"hash":"0x95f0f1f7560bc287","ts":"2026-10-21T23:15:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/tiktok/hashtag_videos — TikTok hashtag videos

ID: raw.tiktok.hashtag_videos. Docs: https://qovia.ai/docs/api-reference/raw.tiktok.hashtag_videos/
Posts under one hashtag, as the same records as video detail (same ids). Hashtag IDs are in a post record's extra.topic_ids. Pass the previous page's cursor back to continue; stop when has_more is false. A hashtag without posts answers empty and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- hashtag_id (required; string): Hashtag ID (a value of a post record's extra.topic_ids)
- cursor (optional; integer; default 0; min 0; max 1000): The cursor from the previous page's response
- count (optional; integer; default 10; min 1; max 30): Items per page
- region (optional; string; one of "US", "GB", "FR", "JP", "VN", "SG"; default "US"): Region: US, GB, FR, JP, VN or SG; US by default
Example request: curl -G "https://api.qovia.ai/v1/raw/tiktok/hashtag_videos?hashtag_id=43468" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_tik_60c33be50a32","src":"social","platform":"tiktok","lang":"en","text":"@ivmbigcountry enchants with his powerful take on \"I Put A Spell On You\" by Screamin' Jay Hawkins. Watch the 3-night premiere of #TheVoice starting tonight 8/7c on NBC and next day on Peacock","author":{"uid_hash":"c50938dcb35c","followers":null,"nickname":"NBC's The Voice","uid":"183519689707278336","sec_uid":"MS4wLjABAAAA4hV9fMViyhGMNvwuTT5SWFzwkDN1EzOhzO-Wf7q2aGvVKYmCOB5jQLPtjYY2vah5","unique_id":"nbcthevoice"},"metrics":{"likes":1755462,"comments":10785,"shares":75309,"saves":120497,"plays":13058372},"extra":{"source_id":"7688183991920545055","published_at":"2026-09-22T02:40:41+00:00","video_dur_s":92,"topic":"#thevoice","topics":["thevoice"],"topic_ids":{"thevoice":"43468"},"content_type":"video","cover_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/okEAxVdIJEeARAjjeUIACFEIq6D10YAdyfbnqq~tplv-tiktokx-origin.image?dr=1347&refresh_token=92673447&x-expires=1792681200&x-signature=CadlsdI%2FKuwXYQWUEEn7ASgS1GU%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=c0f880ed&idc=no1a&sc=cover&biz_tag=tt_video&s=CHALLENGE_AWEME","url":"https://www.tiktok.com/@nbcthevoice/video/7688183991920545055"},"prov":{"hash":"0x14c4b70dfb431d12","ts":"2026-10-21T23:15:00+08:00","source":"live"}},{"id":"soc_tik_9156a5c03078","src":"social","platform":"tiktok","lang":"en","text":"@lex 💜 leaves the Coaches in awe with her unforgettable performance of \"Die on This Hill\" by Sienna Spiro. Find out which Coach she picks tomorrow night as #TheVoice 3-night premiere continues at 8/7c on NBC and next day on Peacock","author":{"uid_hash":"c50938dcb35c","followers":null,"nickname":"NBC's The Voice","uid":"183519689707278336","sec_uid":"MS4wLjABAAAA4hV9fMViyhGMNvwuTT5SWFzwkDN1EzOhzO-Wf7q2aGvVKYmCOB5jQLPtjYY2vah5","unique_id":"nbcthevoice"},"metrics":{"likes":674231,"comments":2327,"shares":15953,"saves":32244,"plays":5879859},"extra":{"source_id":"7688529299984387358","published_at":"2026-09-23T01:00:38+00:00","video_dur_s":299,"topic":"#thevoice","topics":["thevoice"],"topic_ids":{"thevoice":"43468"},"content_type":"video","cover_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/okABAfmhBiC1iABCaziJZpELWBKInsdA5XI1JA~tplv-tiktokx-origin.image?dr=1347&refresh_token=2aa0ce0a&x-expires=1792681200&x-signature=31VnpGIvo9FdVQ%2F0runqpSilcOw%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=c0f880ed&idc=no1a&biz_tag=tt_video&s=CHALLENGE_AWEME&sc=cover","url":"https://www.tiktok.com/@nbcthevoice/video/7688529299984387358"},"prov":{"hash":"0xa8fed1acb1f4b08a","ts":"2026-10-21T23:15:00+08:00","source":"live"}}],"cursor":10,"has_more":true,"prov":{"hash":"0xb9c4d4b033e7b73d","ts":"2026-10-21T23:15:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

## YouTube

### GET /v1/raw/youtube/video — YouTube video detail

ID: raw.youtube.video. Docs: https://qovia.ai/docs/api-reference/raw.youtube.video/
One YouTube video: title and description, channel (name, @handle, subscribers), like / comment / view counts, hashtags, keywords, category, publish time (UTC), duration, language, thumbnail and link. A video that does not exist answers 404 and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- video_id (required; string): YouTube video ID (the 11 characters in youtube.com/watch?v=<ID>)
Example request: curl -G "https://api.qovia.ai/v1/raw/youtube/video?video_id=9bZkp7q19f0" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_you_a3d5e29f65bc","src":"social","platform":"youtube","lang":"ko","text":"PSY - GANGNAM STYLE(강남스타일) M/V\nPSY - ‘I LUV IT’ M/V @    • PSY - ‘I LUV IT’ M/V  \nPSY - ‘New Face’ M/V @   • PSY - ‘New Face’ M/V  \n\nPSY - 8TH ALBUM '4X2=8' on iTunes @\nhttps://smarturl.it/PSY_8thAlbum\n\nPSY - GANGNAM STYLE(강남스타일) on iTunes @ http://smarturl.it/PsyGangnam\n\n#PSY #싸이 #GANGNAMSTYLE #강남스타일\n\nMore about PSY@\n   / officialpsy  \n  / officialpsy  \n  / psy_oppa  \n  / 42psy42  \nhttp://iTunes.com/PSY\nhttp://sptfy.com/PSY\nhttp://weibo.com/psyoppa","author":{"uid_hash":"b222b8024cc0","followers":20600000,"nickname":"officialpsy","uid":"UCrDkAvwZum-UTjHmzDI2iIw","unique_id":"officialpsy"},"metrics":{"likes":32323636,"comments":5400000,"plays":6099601169},"extra":{"source_id":"9bZkp7q19f0","title":"PSY - GANGNAM STYLE(강남스타일) M/V","published_at":"2012-07-15T07:46:32+00:00","video_dur_s":252,"topic":"#GANGNAMSTYLE","topics":["GANGNAMSTYLE","PSY","싸이","강남스타일"],"keywords":["PSY","싸이","강남스타일","뮤직비디오","Music Video","Gangnam Style","KOREAN SINGER","KPOP","KOERAN WAVE","PSY 6甲","6th Studio Album","싸이6집","육갑","Psy Gangnam Style"],"category":"Music","content_type":"video","cover_url":"https://i.ytimg.com/vi/9bZkp7q19f0/maxresdefault.jpg","url":"https://www.youtube.com/watch?v=9bZkp7q19f0"},"prov":{"hash":"0x2e3ae05063727e69","ts":"2026-10-22T03:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/youtube/comments — YouTube video comments

ID: raw.youtube.comments. Docs: https://qovia.ai/docs/api-reference/raw.youtube.comments/
First-level comments of a video, top or newest first, about 20 a page: text, likes, reply count, time (UTC, converted from YouTube's "3 days ago" and as precise as the unit it names), whether the creator hearted it, and the commenter. Pass the previous page's cursor back to continue; stop when has_more is false. Replies come from raw.youtube.comment_replies with a comment's reply_cursor. A video without comments, or one that does not exist, answers empty and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- video_id (required; string): YouTube video ID
- sort (optional; string; one of "top", "newest"; default "top"): Order: top (the default) or newest
- cursor (optional; string; max length 6000): The cursor from the previous page's response; leave it out for the first page
Example request: curl -G "https://api.qovia.ai/v1/raw/youtube/comments?video_id=dQw4w9WgXcQ" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"cid":"UgzHP6__JvKiK1Cmha14AaABAg","text":"Click this link https://boot.dev/?promo=LTT and use my code LTT to get 25% off your first payment for boot.dev.","likes":46,"reply_count":4,"created_at":"2026-10-20T00:00:00+00:00","liked_by_author":false,"author":{"uid_hash":"e91c380c4459","nickname":"@LinusTechTips","uid":"UCXuqSBlHAE6Xw-yeJA0Tunw","unique_id":"LinusTechTips"},"reply_cursor":"Eg0SC0xHQTRaRnItaGZvGAYygwEaUBIaVWd6SFA2X19KdktpSzFDbWhhMTRBYUFCQWciAggAKhhVQ1h1cVNCbEhBRTZYdy15"},{"cid":"UgxZuA2rLwz-KGgqs5R4AaABAg","text":"THIS. This is what I want more of- TECH TIPS. This is a fun, informative video about technology. I would love to see more of these. Video idea- I would love to see an Nvidia App guide now that the Nvidia Control panel is going away. Most existing tutorials simply say \"configure this option this way\" but do not fully explain what the option means. I think LTT could do a good job of this.","likes":1600,"reply_count":15,"created_at":"2026-10-20T00:00:00+00:00","liked_by_author":true,"author":{"uid_hash":"5f0c2a9e41b7","nickname":"@example.user.1","uid":"UCexampleCommenter000001","unique_id":"example.user.1"},"reply_cursor":"Eg0SC0xHQTRaRnItaGZvGAYygwEaUBIaVWd4WnVBMnJMd3otS0dncXM1UjRBYUFCQWciAggAKhhVQ1h1cVNCbEhBRTZYdy15"}],"cursor":"Eg0SC0xHQTRaRnItaGZvGAYyjAMKzwJnZXRfcmFua2VkX3N0cmVhbXMtLUNxY0JDSUFFRlJl","has_more":true,"prov":{"hash":"0x92bfddd95544b4bf","ts":"2026-10-22T03:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/youtube/comment_replies — YouTube comment replies

ID: raw.youtube.comment_replies. Docs: https://qovia.ai/docs/api-reference/raw.youtube.comment_replies/
Replies under one comment: text, likes, time (UTC, converted from "3 days ago"), whether the creator hearted it, the parent comment and the replier. About 10 on the first page, about 50 on later ones. For the first page pass a comment's reply_cursor (from raw.youtube.comments), then the previous page's cursor; stop when has_more is false. A comment without replies answers empty and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- cursor (required; string; max length 6000): A comment record's reply_cursor for the first page, then the previous page's cursor
Example request: curl -G "https://api.qovia.ai/v1/raw/youtube/comment_replies?cursor=Eg0SC0xHQTRaRnItaGZvGAYygwEaUBIaVWd4WnVBMnJMd3otS0dncXM1UjRBYUFCQWciAggAKhhVQ1h1cVNCbEhBRTZYdy15ZUpBMFR1bncyC0xHQTRaRnItaGZvQAFICoIBAggBQi9jb21tZW50LXJlcGxpZXMtaXRlbS1VZ3hadUEyckx3ei1LR2dxczVSNEFhQUJBZw%253D%253D" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"cid":"UgxZuA2rLwz-KGgqs5R4AaABAg.AcBrV04REKSAcBweQijAMF","text":"I feel like it's more of a \"Techquickie\", though.","likes":41,"reply_count":null,"created_at":"2026-10-20T00:00:00+00:00","liked_by_author":false,"author":{"uid_hash":"9a63d1e07c25","nickname":"@example.user.2","uid":"UCexampleCommenter000002","unique_id":"example.user.2"},"parent_cid":"UgxZuA2rLwz-KGgqs5R4AaABAg"},{"cid":"UgxZuA2rLwz-KGgqs5R4AaABAg.AcBrV04REKSAcC06hk8b5K","text":"they should be the Veritasium of pc gaming, with their usual random crap on the side. write that down LTT and pay me later, lol.","likes":12,"reply_count":null,"created_at":"2026-10-20T00:00:00+00:00","liked_by_author":false,"author":{"uid_hash":"c41e8b2f6d90","nickname":"@example.user.3","uid":"UCexampleCommenter000003","unique_id":"example.user.3"},"parent_cid":"UgxZuA2rLwz-KGgqs5R4AaABAg"}],"cursor":"Eg0SC0xHQTRaRnItaGZvGAYy2gEKU2dldF9jb21tZW50X3dpdGhfcmVwbGllc19zdHJlYW0t","has_more":true,"prov":{"hash":"0x9a77dd85a539a1cc","ts":"2026-10-22T03:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/youtube/channel — YouTube channel profile

ID: raw.youtube.channel. Docs: https://qovia.ai/docs/api-reference/raw.youtube.channel/
Channel profile with name, @handle, subscribers, video count (rounded the way YouTube shows them), description, keywords, avatar, banner and link. A channel that does not exist answers 404 or 400 and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- channel_id (required; string): Channel ID (24 characters starting with UC, from youtube.com/channel/<ID>; a video record's author.uid)
Example request: curl -G "https://api.qovia.ai/v1/raw/youtube/channel?channel_id=UCXuqSBlHAE6Xw-yeJA0Tunw" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"uid_hash":"e91c380c4459","nickname":"Linus Tech Tips","followers":16900000,"posts":7900,"platform":"youtube","uid":"UCXuqSBlHAE6Xw-yeJA0Tunw","unique_id":"LinusTechTips","signature":"Linus Tech Tips is a passionate team of \"professionally curious\" experts in consumer technology and video production who aim to educate and entertain.\n\nSponsorship Inquiries: partnerships@linusmediagroup.com","keywords":["Unboxing","Review","Computer","Hardware","Motherboard","Intel","AMD","NVIDIA","gaming"],"avatar_url":"https://yt3.googleusercontent.com/gnvYLhXy8FAlPXZ2RTrkrgj-5kyt0vdE2FUGVOiKGdEZIa-wN5A-7nwZBlWJLzUMmoh1NWAU=s900-c-k-c0x00ffffff-no-rj","banner_url":"https://yt3.googleusercontent.com/U_7GWetO6k4sq3pAkbFEIIWzZLKcIJlGJqNz6NQAhgqF6DVD5pllwWF6trSUWEIRn4MkhNlhy9Y=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj","url":"https://www.youtube.com/channel/UCXuqSBlHAE6Xw-yeJA0Tunw","prov":{"hash":"0x7432cf3d8b073d37","ts":"2026-10-22T03:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/youtube/channel_videos — YouTube channel videos

ID: raw.youtube.channel_videos. Docs: https://qovia.ai/docs/api-reference/raw.youtube.channel_videos/
Videos a channel published, newest first, about 30 a page, as the same records as video detail (same ids): title, views (rounded), duration, publish time (UTC, converted from "3 days ago"), thumbnail and link. Pass the previous page's cursor back to continue; stop when has_more is false. A channel without videos, or one that does not exist, answers empty and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- channel_id (required; string): Channel ID (24 characters starting with UC)
- cursor (optional; string; max length 6000): The cursor from the previous page's response; leave it out for the first page
Example request: curl -G "https://api.qovia.ai/v1/raw/youtube/channel_videos?channel_id=UCuAXFkgsw1L7xaCfnd5JJOw" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_you_5dfd188c053b","src":"social","platform":"youtube","lang":null,"text":"Rick Astley - Angels On My Side (Live at The O2, London, April 2026)","author":{"uid_hash":"7906a4aba221","followers":null,"nickname":"Rick Astley","uid":"UCuAXFkgsw1L7xaCfnd5JJOw","unique_id":"RickAstleyYT"},"metrics":{"plays":109000},"extra":{"source_id":"PXC_PYeB6F8","title":"Rick Astley - Angels On My Side (Live at The O2, London, April 2026)","published_at":"2026-07-23T00:00:00+00:00","video_dur_s":231,"content_type":"video","cover_url":"https://i.ytimg.com/vi/PXC_PYeB6F8/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDjichxht-_GtPETZ7g8ZB6-E32BQ","url":"https://www.youtube.com/watch?v=PXC_PYeB6F8"},"prov":{"hash":"0x18f5cb66ca1f56d7","ts":"2026-10-22T03:30:00+08:00","source":"live"}},{"id":"soc_you_8efd104a1f48","src":"social","platform":"youtube","lang":null,"text":"Rick Astley - Dance (Live at The O2, London, April 2026)","author":{"uid_hash":"7906a4aba221","followers":null,"nickname":"Rick Astley","uid":"UCuAXFkgsw1L7xaCfnd5JJOw","unique_id":"RickAstleyYT"},"metrics":{"plays":62000},"extra":{"source_id":"LaOUkDBDjW8","title":"Rick Astley - Dance (Live at The O2, London, April 2026)","published_at":"2026-07-23T00:00:00+00:00","video_dur_s":234,"content_type":"video","cover_url":"https://i.ytimg.com/vi/LaOUkDBDjW8/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLB22UoKUjTJ3Jjci9MCfj8vBunIlg","url":"https://www.youtube.com/watch?v=LaOUkDBDjW8"},"prov":{"hash":"0xff7e924bd77be796","ts":"2026-10-22T03:30:00+08:00","source":"live"}}],"cursor":"4qmFsgLZCRIYVUN1QVhGa2dzdzFMN3hhQ2ZuZDVKSk93GrwJOGdhRUJ4cUJCM3ItQmpyN0Jn","has_more":true,"prov":{"hash":"0x2268bfb6e71c9943","ts":"2026-10-22T03:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/youtube/search — YouTube video search

ID: raw.youtube.search. Docs: https://qovia.ai/docs/api-reference/raw.youtube.search/
Search YouTube videos by keyword, about 20 a page, as the same records as video detail (same ids): title, description snippet, channel, views, duration, publish time (UTC, converted from "3 days ago"), thumbnail and link. Filter by upload date: the last hour, today, this week, this month (the default) or this year. Pass the previous page's cursor back to continue; stop when has_more is false. No results answers empty and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- keyword (required; string; min length 1; max length 100): Search keyword
- upload_date (optional; string; one of "hour", "today", "week", "month", "year"; default "month"): Uploaded within: hour, today, week, month (the default) or year
- cursor (optional; string; max length 6000): The cursor from the previous page's response; leave it out for the first page
Example request: curl -G "https://api.qovia.ai/v1/raw/youtube/search?keyword=nike" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_you_7c265a093c9a","src":"social","platform":"youtube","lang":null,"text":"Nike’s Worsening Slump Forces CEO to Rethink Turnaround\nNike Inc. is cutting jobs and embarking on a sweeping overhaul of the business as results deteriorate and test Wall Street's ...","author":{"uid_hash":"6586b6e1f98e","followers":null,"nickname":"Bloomberg Television","uid":"UCIALMKvObZNtJ6AmdCLP7Lg","unique_id":null},"metrics":{"plays":89001},"extra":{"source_id":"RTZP4M8gN0U","title":"Nike’s Worsening Slump Forces CEO to Rethink Turnaround","published_at":"2026-10-07T00:00:00+00:00","video_dur_s":358,"content_type":"video","cover_url":"https://i.ytimg.com/vi/RTZP4M8gN0U/hq720.jpg?sqp=-oaymwEgCNAFEJQDSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC9xg=&rs=AOn4CLAq3Ec2ul1G-dVdPJwIKBkFIMQrDQ","url":"https://www.youtube.com/watch?v=RTZP4M8gN0U"},"prov":{"hash":"0xb3d4cc9aa6b75e13","ts":"2026-10-22T03:30:00+08:00","source":"live"}},{"id":"soc_you_8ec9fc0734c3","src":"social","platform":"youtube","lang":null,"text":"Rapid Recap: Nike's stock has struggled as it faces stiff competition - here’s what experts say\nCNBC's Jim Cramer, BTIG's Bob Drbul, Evercore ISI's Michael Binetti, and Permanent Portfolio's Michael Cuggino weigh in on ...","author":{"uid_hash":"d567d3852b43","followers":null,"nickname":"CNBC Television","uid":"UCrp_UI8XtuYfpiqluWLD7Lw","unique_id":null},"metrics":{"plays":55577},"extra":{"source_id":"tjeur2Hdh8w","title":"Rapid Recap: Nike's stock has struggled as it faces stiff competition - here’s what experts say","published_at":"2026-10-07T00:00:00+00:00","video_dur_s":167,"content_type":"video","cover_url":"https://i.ytimg.com/vi/tjeur2Hdh8w/hq720.jpg?sqp=-oaymwEgCNAFEJQDSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC9xg=&rs=AOn4CLBDw_TnBwtbdGDgLWisUxHgCMAa4g","url":"https://www.youtube.com/watch?v=tjeur2Hdh8w"},"prov":{"hash":"0x97a713ff74381ed4","ts":"2026-10-22T03:30:00+08:00","source":"live"}}],"cursor":"EpEFEgRuaWtlGowDRWdRSUJCQUJTQlNDQVF0SFYxOWpSMTg0UXpkd1VZSUJDMmxxUzBNeE4w","has_more":true,"prov":{"hash":"0x5bee0e0b8c810cc0","ts":"2026-10-22T03:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

## Instagram

### GET /v1/raw/instagram/post — Instagram post detail

ID: raw.instagram.post. Docs: https://qovia.ai/docs/api-reference/raw.instagram.post/
One Instagram post (a picture, a video or Reel, or a carousel): caption, author, like and comment counts, plays and shares (videos), hashtags, the picture of each carousel slide, cover, video duration, place, publish time (UTC) and link; a like count the author hid is null. Pass the post's link or its shortcode. A post that does not exist or was deleted answers 404 and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- post (required; string; max length 400): The post's link (instagram.com/p/<shortcode>/, /reel/<shortcode>/ or /tv/<shortcode>/), or the shortcode in it
Example request: curl -G "https://api.qovia.ai/v1/raw/instagram/post?post=DewxhTugF2T" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_ins_db6dd17747d8","src":"social","platform":"instagram","lang":null,"text":"new NBA season prep with @jordanclarksons and @cbrickley603 🏀\n\nthe @nyknicks shooting guard joins the legendary basketball trainer in the gym for a custom workout.","author":{"uid_hash":"1c8ec1290d27","followers":null,"nickname":"Instagram","uid":"25025320","username":"instagram"},"metrics":{"likes":142304,"comments":12254,"shares":2075,"plays":53697159},"extra":{"source_id":"4011477195854994819","shortcode":"DeroUGDhF2D","published_at":"2026-10-19T16:01:46+00:00","content_type":"video","topic":null,"topics":[],"images":[],"cover_url":"https://scontent-cdg4-1.cdninstagram.com/v/t51.82787-15/857156235_18805668469001321_8991881220425152601_n.jpg?stp=dst-jpg_e15_p480x480_tt6&_nc_cat=1&ig_cache_key=NDAxMTQ3NzE5NTg1NDk5NDgxOTE4ODA1NjY4NDY2MDAxMzIx.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjEyMTcuc2RyLnZpZGVvX3VzZXJfdXBsb2FkZWRfdGh1bWJuYWlsLkMzIn0%3D&_nc_ohc=0xrVPmHGbkEQ7kNvwGYYd9D&_nc_oc=AdrvU2a-Q5ISwZghvhBMvBf41-l2slcJgINakbXSSH8TOaVcdHPA0Gyux1jAIf2tq-M&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-cdg4-1.cdninstagram.com&_nc_gid=1TOIYyDhxMZsJhUCXfrKBA&_nc_ss=7a3ba&oh=00_AQMOd4RBrA57M035Ccz9M0yFUOsCbkVc4h-3DEPcT0E4EA&oe=6ADEF9D7","video_dur_s":87,"location":"New York, N.Y.","url":"https://www.instagram.com/p/DeroUGDhF2D/"},"prov":{"hash":"0xa3dcec5e218eb08e","ts":"2026-10-22T03:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/instagram/comments — Instagram post comments

ID: raw.instagram.comments. Docs: https://qovia.ai/docs/api-reference/raw.instagram.comments/
First-level comments of a post (in Instagram's ranked order), cursor-paginated, about 15 a page: text, likes, reply count, time (UTC), whether the author liked it, and the commenter. Pass the previous page's cursor back unchanged to continue; stop when has_more is false. Replies come from raw.instagram.comment_replies. A post without comments, or one that does not exist, answers empty and is not charged.
Price: $0.002000 per successful call. Status: live.
Parameters:
- post (required; string; max length 400): The post's link or shortcode (a post record's extra.shortcode)
- cursor (optional; string; max length 4000): The cursor from the previous page's response, unchanged; leave it out for the first page
Example request: curl -G "https://api.qovia.ai/v1/raw/instagram/comments?post=DewxhTugF2T" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"cid":"18360615367247033","text":"Big time 📈","likes":7,"reply_count":1,"created_at":"2026-10-21T17:12:41+00:00","liked_by_author":false,"author":{"uid_hash":"ad0a04787983","nickname":"Pinkbike","uid":"39419021","username":"pinkbike"}},{"cid":"17990988468067466","text":"@example.user.2 one for you to try with your 😎","likes":14,"reply_count":4,"created_at":"2026-10-21T16:16:07+00:00","liked_by_author":true,"author":{"uid_hash":"a654f623b259","nickname":"L***r","uid":"70000000001","username":"example.user.1"}}],"cursor":"BE1fBDYTDBtffUJDQQpDE0UeVR9YQGYfQStHNV9XCw07PwpC","has_more":true,"total":2513,"prov":{"hash":"0x35e725afd5c8d284","ts":"2026-10-22T03:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/instagram/comment_replies — Instagram comment replies

ID: raw.instagram.comment_replies. Docs: https://qovia.ai/docs/api-reference/raw.instagram.comment_replies/
Replies under one comment, cursor-paginated, about 8 a page: text, likes, time (UTC), whether the author liked it, the reply it answers, and the replier. Pass the post's link or shortcode and the comment's cid. Pass the previous page's cursor back unchanged to continue; stop when has_more is false. A comment without replies, or one that does not exist, answers empty and is not charged.
Price: $0.002000 per successful call. Status: live.
Parameters:
- post (required; string; max length 400): The link or shortcode of the comment's post
- comment_id (required; string): The first-level comment's cid (from the post comments endpoint)
- cursor (optional; string; max length 4000): The cursor from the previous page's response, unchanged; leave it out for the first page
Example request: curl -G "https://api.qovia.ai/v1/raw/instagram/comment_replies?post=DewxhTugF2T&comment_id=17990988468067466" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"cid":"17951280948057079","text":"@example.user.1 ahh sure, easy 😮","likes":0,"reply_count":null,"created_at":"2026-10-21T16:43:37+00:00","liked_by_author":false,"author":{"uid_hash":"bb8000ceb0ca","nickname":"H***s","uid":"70000000002","username":"example.user.2"},"parent_cid":"17990988468067466","reply_to_cid":null},{"cid":"18108452606216598","text":"ready to see that POV","likes":0,"reply_count":null,"created_at":"2026-10-21T18:54:08+00:00","liked_by_author":false,"author":{"uid_hash":"43ad409b8d10","nickname":"Oakley | Meta","uid":"68825295038","username":"oakleymeta"},"parent_cid":"17990988468067466","reply_to_cid":null}],"cursor":null,"has_more":false,"total":4,"prov":{"hash":"0xe7d8183927d4d375","ts":"2026-10-22T03:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/instagram/user — Instagram user profile

ID: raw.instagram.user. Docs: https://qovia.ai/docs/api-reference/raw.instagram.user/
An Instagram user's profile: followers, following, post count, verification, bio, category, whether the account is private or a business, the links in the bio and the avatar. Pass the username (instagram.com/<username>). A user that does not exist answers 404 and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- username (required; string): The username (from instagram.com/<username>, without @)
Example request: curl -G "https://api.qovia.ai/v1/raw/instagram/user?username=instagram" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"uid_hash":"1c8ec1290d27","nickname":"Instagram","followers":686515583,"posts":8622,"verified":true,"platform":"instagram","uid":"25025320","username":"instagram","following":157,"signature":"Discover what's new on Instagram 🔎✨","category":null,"is_private":false,"is_business":false,"links":[{"title":null,"url":"http://help.instagram.com"},{"title":"Close Friends Only with @kaicenat and @kaiyacenat | Spotify","url":"https://open.spotify.com/episode/6B8XsGCYuHMYzSLvLMitS7?si=kXd6_Y6AQhueoC_McepSKg"},{"title":"Close Friends Only with @kaicenat and @kaiyacenat | YouTube","url":"https://www.youtube.com/watch?v=z0X36mIbyCo"}],"avatar_url":"https://instagram.fmed1-1.fna.fbcdn.net/v/t51.82787-19/550891366_18667771684001321_1383210656577177067_n.jpg?stp=dst-jpg_s320x320_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.fmed1-1.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2gHxA7alZTt1KD68Vi6nu_AjirqNFPZRr3fltDbI5UYmgvBAjkIu7IPlYQjW5w-p94E&_nc_ohc=EH2t9XyJry8Q7kNvwGPGs3A&_nc_gid=L4WYrLzzZILSFohLoLqT6A&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AQMCVp62TTZUnNmWSp_j8e3-UrndLjmGRYtqlD0qmKToBg&oe=6ADEDAE7&_nc_sid=8b3546","url":"https://www.instagram.com/instagram/","prov":{"hash":"0x2a08be02b825b88c","ts":"2026-10-22T03:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/instagram/user_posts — Instagram user posts

ID: raw.instagram.user_posts. Docs: https://qovia.ai/docs/api-reference/raw.instagram.user_posts/
The posts on a user's profile, the ones the user pinned first, then newest first, 12 a page, as the same records as post detail (same ids) plus saves (videos) and whether the user pinned the post; collab posts the user co-authored carry their publisher as author. The counts of the newest posts can trail post detail by a few hours. Pass either the username or the user ID. Pass the previous page's cursor back unchanged to continue; stop when has_more is false. A user without posts, or one that does not exist, answers empty and is not charged.
Price: $0.002000 per successful call. Status: live.
Parameters:
- username (optional; string): The username (without @); pass this or user_id
- user_id (optional; string): The user ID (a profile's uid); pass this or username
- cursor (optional; string; max length 4000): The cursor from the previous page's response, unchanged; leave it out for the first page
Example request: curl -G "https://api.qovia.ai/v1/raw/instagram/user_posts?username=instagram" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_ins_c4228c88178e","src":"social","platform":"instagram","lang":null,"text":"we said yes 🎉🎉🎉 (with help from @muse)","author":{"uid_hash":"1c8ec1290d27","followers":null,"nickname":"Instagram","uid":"25025320","username":"instagram"},"metrics":{"likes":264579,"comments":4685},"extra":{"source_id":"3994809802840683658","shortcode":"DdwalmrkTSK","published_at":"2026-09-26T16:01:00+00:00","content_type":"carousel","topic":null,"topics":[],"images":["https://scontent-cph2-1.cdninstagram.com/v/t51.82787-15/825322636_18797172301001321_1840526250724222048_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=111&ig_cache_key=Mzk5NDgwNDgyNTExOTY5NDkzNw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMTA4MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=dE0BpUU0xeEQ7kNvwElBvdx&_nc_oc=AdrbMtwC8_rchUMQ9OfbTLJRWbfcR5ADeuixjEN-vWZo91sXAX9ujO5Bp2IE7d8lNyw&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&se=7&_nc_ht=scontent-cph2-1.cdninstagram.com&_nc_gid=6Rps2g5erRxYSo_TATWYcw&_nc_ss=703ba&oh=00_AQNJIeHBnUZb4jW9_Y0CcHyTzz0YMjGvtsXk4oT-NyhpxA&oe=6ADEE7E8","https://scontent-cph2-1.cdninstagram.com/v/t51.82787-15/825323018_18797175124001321_7311944808548486139_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=107&ig_cache_key=Mzk5NDgwOTc2OTIwNTg4MTk1Mw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMTA4MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=oiRKhL7ZG24Q7kNvwHQKn5K&_nc_oc=Adr5SiehGbMGUS2nMll10qsYLgLhPPZbs8cOXrcqzjFwvHpVGk7C7xTler-Et0PGYeU&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&se=7&_nc_ht=scontent-cph2-1.cdninstagram.com&_nc_gid=6Rps2g5erRxYSo_TATWYcw&_nc_ss=703ba&oh=00_AQNiEnJM-4xA0NSG8Km1q0vrTFsja0-f7FS0cjnSgBBAzA&oe=6ADEFCDB","https://scontent-cph2-1.cdninstagram.com/v/t51.82787-15/825322962_18797175115001321_2105147553826773819_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=107&ig_cache_key=Mzk5NDgwOTc3MDQzMDU2ODQwNA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMTA4MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=U1qqjraYXk4Q7kNvwHSAqCj&_nc_oc=Adr6E7BUw2c-RMiS-nFj8E45KM-b1xxo0P8BCRFv8P_qWCH9j1XIBfBQTwN7QfLJjSE&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&se=7&_nc_ht=scontent-cph2-1.cdninstagram.com&_nc_gid=6Rps2g5erRxYSo_TATWYcw&_nc_ss=703ba&oh=00_AQMwUEYzVAa1AQ5-rA6wLjNEvFQVyCi_5Ejcikhrq-z3iA&oe=6ADED754"],"cover_url":"https://scontent-cph2-1.cdninstagram.com/v/t51.82787-15/825322636_18797172301001321_1840526250724222048_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=111&ig_cache_key=Mzk5NDgwNDgyNTExOTY5NDkzNw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMTA4MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=dE0BpUU0xeEQ7kNvwElBvdx&_nc_oc=AdrbMtwC8_rchUMQ9OfbTLJRWbfcR5ADeuixjEN-vWZo91sXAX9ujO5Bp2IE7d8lNyw&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&se=7&_nc_ht=scontent-cph2-1.cdninstagram.com&_nc_gid=6Rps2g5erRxYSo_TATWYcw&_nc_ss=703ba&oh=00_AQNJIeHBnUZb4jW9_Y0CcHyTzz0YMjGvtsXk4oT-NyhpxA&oe=6ADEE7E8","video_dur_s":null,"location":null,"url":"https://www.instagram.com/p/DdwalmrkTSK/","pinned":false},"prov":{"hash":"0xfb163e582a0072d3","ts":"2026-10-22T03:30:00+08:00","source":"live"}},{"id":"soc_ins_b3e6797aecd1","src":"social","platform":"instagram","lang":null,"text":"Saved posts → an actual collection 📌\n\nConnect your Instagram and @muse and it can sort them by theme, so your interior design inspo isn’t buried under recipes.","author":{"uid_hash":"1c8ec1290d27","followers":null,"nickname":"Instagram","uid":"25025320","username":"instagram"},"metrics":{"likes":80975,"comments":4410,"shares":7029,"saves":5585,"plays":49213697},"extra":{"source_id":"3994748868695958823","shortcode":"DdwMu5VhCUn","published_at":"2026-09-26T14:03:22+00:00","content_type":"video","topic":null,"topics":[],"images":[],"cover_url":"https://scontent-cph2-1.cdninstagram.com/v/t51.82787-15/825320587_18797135827001321_2410519140595393030_n.jpg?stp=dst-jpg_e15_s640x640_tt6&_nc_cat=106&ig_cache_key=Mzk5NDc0ODg2ODY5NTk1ODgyMzE4Nzk3MTM1ODIxMDAxMzIx.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjEwODAuc2RyLnZpZGVvX3VzZXJfdXBsb2FkZWRfdGh1bWJuYWlsLkMzIn0%3D&_nc_ohc=N8IYvCcHMvQQ7kNvwF9zNC4&_nc_oc=AdqEtJ0IOUfasc1t4spxHrjASfJyeQxG4whMRmYR-_TsB5nuMmOw6RJfOBSFli3IoJE&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-cph2-1.cdninstagram.com&_nc_gid=6Rps2g5erRxYSo_TATWYcw&_nc_ss=703ba&oh=00_AQPorMZDg5mi9QGPS6ujUFSc971vZpevgoI7D13lqqC7jg&oe=6ADEE01E","video_dur_s":12,"location":null,"url":"https://www.instagram.com/p/DdwMu5VhCUn/","pinned":false},"prov":{"hash":"0xef40f1d459c686f2","ts":"2026-10-22T03:30:00+08:00","source":"live"}}],"cursor":"D01MBAwpDhZIZQNSHV1DRj5GHUM3QRdGF1wqbk9cR0tIWANH","has_more":true,"prov":{"hash":"0xbc6db7dfa2ed93aa","ts":"2026-10-22T03:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/instagram/hashtag_posts — Instagram hashtag posts

ID: raw.instagram.hashtag_posts. Docs: https://qovia.ai/docs/api-reference/raw.instagram.hashtag_posts/
The newest posts carrying a hashtag, about 30 a page, as the same records as post detail (same ids) with the author's user ID only and no plays, shares or carousel slides; total is how many posts carry the hashtag. Pass the previous page's cursor back unchanged to continue; stop when has_more is false. A hashtag nobody used answers empty and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- hashtag (required; string; min length 1; max length 100): The hashtag (without
- cursor (optional; string; max length 4000): The cursor from the previous page's response, unchanged; leave it out for the first page
Example request: curl -G "https://api.qovia.ai/v1/raw/instagram/hashtag_posts?hashtag=travel" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_ins_e553866650de","src":"social","platform":"instagram","lang":null,"text":"A operação começará em 15 de dezembro de 2027, com três voos semanais ✨. Confira mais no link da bio 🔗. #qatarairways✈️ #travel #explorepage #viagens #informaçao","author":{"uid_hash":"b0d64510d3d2","followers":null,"nickname":null,"uid":"70000000003","username":null},"metrics":{"likes":0,"comments":0},"extra":{"source_id":"4013029541808673639","shortcode":"DexJRs4p5Nn","published_at":"2026-10-21T19:22:27+00:00","content_type":"image_post","topic":"#qatarairways","topics":["qatarairways","travel","explorepage","viagens","informaçao"],"images":["https://scontent-cdg4-3.cdninstagram.com/v/t51.82787-15/862325060_17969227299194626_1865856716945445925_n.jpg?stp=dst-jpg_e35_p1080x1080_sh2.08_tt6&_nc_ht=scontent-cdg4-3.cdninstagram.com&_nc_cat=110&_nc_oc=Q6cZ2gFu66BjcgkXs06g_kLZSs1VgZr9JgkAe58tT7iSkO83az2T6VlkE9mvU1e4irp8-eY&_nc_ohc=pVziCq2jNiYQ7kNvwGHAGs9&_nc_gid=NpyjTo1tYiCXYX7t_Ah8HQ&edm=AA0rjkIBAAAA&ccb=7-5&ig_cache_key=NDAxMzAyOTU0MTgwODY3MzYzOQ%3D%3D.3-ccb7-5&oh=00_AQMFcTm3HBQhDIK992wWP88uVgF9WF7n3W1qBSoOqCCrjA&oe=6ADEEB6C&_nc_sid=49ed71"],"cover_url":"https://scontent-cdg4-3.cdninstagram.com/v/t51.82787-15/862325060_17969227299194626_1865856716945445925_n.jpg?stp=dst-jpg_e35_p1080x1080_sh2.08_tt6&_nc_ht=scontent-cdg4-3.cdninstagram.com&_nc_cat=110&_nc_oc=Q6cZ2gFu66BjcgkXs06g_kLZSs1VgZr9JgkAe58tT7iSkO83az2T6VlkE9mvU1e4irp8-eY&_nc_ohc=pVziCq2jNiYQ7kNvwGHAGs9&_nc_gid=NpyjTo1tYiCXYX7t_Ah8HQ&edm=AA0rjkIBAAAA&ccb=7-5&ig_cache_key=NDAxMzAyOTU0MTgwODY3MzYzOQ%3D%3D.3-ccb7-5&oh=00_AQMFcTm3HBQhDIK992wWP88uVgF9WF7n3W1qBSoOqCCrjA&oe=6ADEEB6C&_nc_sid=49ed71","video_dur_s":null,"location":null,"url":"https://www.instagram.com/p/DexJRs4p5Nn/"},"prov":{"hash":"0x69439966f886432e","ts":"2026-10-22T03:30:00+08:00","source":"live"}},{"id":"soc_ins_9e233058428f","src":"social","platform":"instagram","lang":null,"text":"Ho Chi Minh City 🇻🇳\n\n#vietnam #travel #travelgram #traveling #asia","author":{"uid_hash":"48f38f8bd1b9","followers":null,"nickname":null,"uid":"70000000004","username":null},"metrics":{"likes":0,"comments":0},"extra":{"source_id":"4013029633108641592","shortcode":"DexJTB6joc4","published_at":"2026-10-21T19:20:33+00:00","content_type":"carousel","topic":"#vietnam","topics":["vietnam","travel","travelgram","traveling","asia"],"images":[],"cover_url":"https://scontent-cdg4-2.cdninstagram.com/v/t51.82787-15/848153455_18131539450760347_2769299367844032000_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-cdg4-2.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2gFu66BjcgkXs06g_kLZSs1VgZr9JgkAe58tT7iSkO83az2T6VlkE9mvU1e4irp8-eY&_nc_ohc=9JrWVnKeOG0Q7kNvwEg65mt&_nc_gid=NpyjTo1tYiCXYX7t_Ah8HQ&edm=AA0rjkIBAAAA&ccb=7-5&oh=00_AQNU4dxI33qBLM7cfR28bzseoivZX_Esq4vQ-4W_ueHPcQ&oe=6ADEFEEF&_nc_sid=49ed71","video_dur_s":null,"location":null,"url":"https://www.instagram.com/p/DexJTB6joc4/"},"prov":{"hash":"0xa5fd1bf8ffbdf901","ts":"2026-10-22T03:30:00+08:00","source":"live"}}],"cursor":"QVFDOFBiU2ptS3k0bUVqMy1WR29XWjkxbzlpemx3ZjBtMjdF","has_more":true,"total":798248141,"prov":{"hash":"0x63da10b488f692b2","ts":"2026-10-22T03:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

## X (Twitter)

### GET /v1/raw/x/post — X post detail

ID: raw.x.post. Docs: https://qovia.ai/docs/api-reference/raw.x.post/
One X (Twitter) post: full text, language, author, like / reply / repost / quote / bookmark / view counts, hashtags, images, video cover and duration, links, the post it replies to, the reposted or quoted post, publish time (UTC) and link. A post that does not exist or cannot be seen answers 400 and is not charged; a single 400 can also be a passing failure, so ask again.
Price: $0.001000 per successful call. Status: live.
Parameters:
- post_id (required; string): The post's ID (the number in x.com/<handle>/status/<ID>)
Example request: curl -G "https://api.qovia.ai/v1/raw/x/post?post_id=2112560723603632217" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_x_88c4e895916c","src":"social","platform":"x","lang":"en","text":"There's a lot of ground to cover when you're building a Moon Base. \n\nDuring the first phase of @NASAMoonBase development, robotic rovers will gather new details about the lunar South Pole region, while lunar terrain vehicles will extend the reach of each Artemis mission. https://t.co/tal41Kyght","author":{"uid_hash":"99eae2f7b3d7","followers":92313359,"nickname":"NASA","uid":"11348282","unique_id":"NASA"},"metrics":{"likes":3365,"comments":230,"shares":492,"quotes":59,"saves":179,"views":519079},"extra":{"source_id":"2112560723603632217","published_at":"2026-10-20T15:05:00+00:00","content_type":"video","topic":null,"topics":[],"images":[],"cover_url":"https://pbs.twimg.com/media/HVFSyBvWAAE5Y1_.jpg","video_dur_s":46,"links":[],"reply_to":null,"conversation_id":"2112560723603632217","sensitive":false,"repost_of":null,"quote_of":null,"url":"https://x.com/NASA/status/2112560723603632217"},"prov":{"hash":"0x4e5629f2f5dedf8f","ts":"2026-10-22T03:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/x/comments — X post replies

ID: raw.x.comments. Docs: https://qovia.ai/docs/api-reference/raw.x.comments/
Replies to a post (X's comments) in X's relevance order, up to about 40 a page: text, likes, reply count, images, time (UTC) and the replier. Pass the previous page's cursor back to continue; stop when has_more is false. Replies are posts too: pass a cid as post_id to get its own replies. A post without replies answers empty and one that does not exist answers 400; neither is charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- post_id (required; string): The post's ID (the number in x.com/<handle>/status/<ID>)
- cursor (optional; string): The cursor from the previous page's response; leave it out for the first page
Example request: curl -G "https://api.qovia.ai/v1/raw/x/comments?post_id=2112560723603632217" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"cid":"2112560726397092239","text":"@NASAMoonBase The journey is just beginning. See how NASA and our partners are getting @NASAMoonBase moving in the full video: https://t.co/oI5pwU8Fyz","likes":429,"reply_count":12,"created_at":"2026-10-20T15:05:01+00:00","images":[],"author":{"uid_hash":"99eae2f7b3d7","nickname":"NASA","uid":"11348282","unique_id":"NASA"}},{"cid":"2112612259579191731","text":"@NASA @NASAMoonBase Great Moon Base progress!","likes":409,"reply_count":12,"created_at":"2026-10-20T18:29:47+00:00","images":[],"author":{"uid_hash":"264760c8afaa","nickname":"NASA Administrator Jared Isaacman","uid":"2000593641480605696","unique_id":"NASAAdmin"}}],"cursor":"DAAKCgABHVLXUzf__m0LAAIAAAGoRW1QQzZ3QUFBZlEvZ0dKTjB2R3AvQUFBQUNVZFVWNjEvNWRRUGgxUmNsdEEyNEY5SFZGbkZGUWFNY3NkVW1GMCs1cFFnaDFSV2o5dUc3RjZIVkZ0NThoYkFac2RVWUdvTUZwaHN4MVJZNk5CRzZFN0hWRjBFVU5ic1FrZFVWVGc3VllSd1IxUlZIUUVGNEdCSFZIS0VhZ1hNUUlkVW1jcng5dGdNeDFSWTMxZzIzRjFIVkY4eU9rYTRjb2RVWFRzbHhaeGF4MVJWaVBnMnJIMkhWRmRkS3Zid1hFZFVWMlFnMWJnS2gxUlcrdTNGMkZuSFZGWVBjM2E0YXNkVVZqZExwcFFXUjFSZ05qM1d2R1lIVkZTeWE5WEFZOGRVV2xpQWRlUVFoMVJjWHhrVnNFbUhWRmR3S29hWUswZFVtdHN5MWZCUEIxUlhjbEZteUFESFZGMTE5QVdNVlFkVVZpdVFOWndOaDFTdUR0SG02QXFIVkhWSjEzVzBIVWRVVy8xaFpveHZSMVJVc2tJMWpCWkhWRlppMURic1h3ZFVWUHhpRnNROXc9PQgAAwAAAAILAAQAAAAGQm90dG9tAAA","has_more":true,"total":230,"prov":{"hash":"0xd103ab1a2af6d6e1","ts":"2026-10-22T03:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/x/user — X user profile

ID: raw.x.user. Docs: https://qovia.ai/docs/api-reference/raw.x.user/
An X user's profile with followers, following, post count, verification (the blue check and the government or business type), bio, location, website, join time (UTC), avatar, banner and whether the account is protected. Pass either the handle (x.com/<handle>) or the numeric uid. A user that does not exist answers 404 and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- unique_id (optional; string): The handle (from x.com/<handle>, without the @); pass this or uid
- uid (optional; string): The user's numeric ID (author.uid in the records); pass this or unique_id
Example request: curl -G "https://api.qovia.ai/v1/raw/x/user?unique_id=NASA" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"uid_hash":"99eae2f7b3d7","nickname":"NASA","followers":92313358,"posts":74446,"verified":true,"platform":"x","uid":"11348282","unique_id":"NASA","following":115,"signature":"Making the seemingly impossible, possible. ✨","verify_reason":"Government","location":"Pale Blue Dot","website":"http://www.nasa.gov/","created_at":"2007-12-19T20:20:32+00:00","protected":false,"avatar_url":"https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_400x400.jpg","banner_url":"https://pbs.twimg.com/profile_banners/11348282/1788992290","url":"https://x.com/NASA","prov":{"hash":"0x5f0696afaa47c688","ts":"2026-10-22T03:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/x/user_posts — X user posts

ID: raw.x.user_posts. Docs: https://qovia.ai/docs/api-reference/raw.x.user_posts/
Posts and reposts a user published, the pinned post first on the first page, then newest first, about 20 a page, as the same records as post detail (same ids); a repost (content_type repost) carries its counts in extra.repost_of. Pass the previous page's cursor back to continue; stop when has_more is false. A page can answer 400 once: ask again. Pass either the handle or the numeric uid. A user that does not exist answers 400 and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- unique_id (optional; string): The handle (from x.com/<handle>, without the @); pass this or uid
- uid (optional; string): The user's numeric ID (author.uid in the records); pass this or unique_id
- cursor (optional; string): The cursor from the previous page's response; leave it out for the first page
Example request: curl -G "https://api.qovia.ai/v1/raw/x/user_posts?unique_id=NASA" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_x_8028d7441f31","src":"social","platform":"x","lang":"en","text":"\"I just hear over and over again: 'I felt like I went on the mission with you'.\"\n\nArtemis II's Jeremy Hansen and Victor Glover reflect on their historic trip around the Moon — and how life on Earth has been since — in our latest Houston We Have A Podcast: https://t.co/jZ9Zm5P8Z8 https://t.co/A6YIgHFDqB","author":{"uid_hash":"99eae2f7b3d7","followers":92313359,"nickname":"NASA","uid":"11348282","unique_id":"NASA"},"metrics":{"likes":432,"comments":59,"shares":60,"quotes":9,"saves":18,"views":144316},"extra":{"source_id":"2112959650551173522","published_at":"2026-10-21T17:30:12+00:00","content_type":"image_post","topic":null,"topics":[],"images":["https://pbs.twimg.com/media/HVK9moNWUAAzx2Y.jpg"],"cover_url":"https://pbs.twimg.com/media/HVK9moNWUAAzx2Y.jpg","video_dur_s":null,"links":["https://go.nasa.gov/4dSkerm"],"reply_to":null,"conversation_id":"2112959650551173522","sensitive":false,"repost_of":null,"quote_of":null,"url":"https://x.com/NASA/status/2112959650551173522","pinned":false},"prov":{"hash":"0x7f5aa6370cbd4752","ts":"2026-10-22T03:30:00+08:00","source":"live"}},{"id":"soc_x_8b28cb565b02","src":"social","platform":"x","lang":"en","text":"RT @NASAJohnson: Some moments are worth floating back to. ✨\n\nWhen @NASA’s @SpaceX Crew-13 launched on Oct. 1, they brought along a little e…","author":{"uid_hash":"99eae2f7b3d7","followers":92313359,"nickname":"NASA","uid":"11348282","unique_id":"NASA"},"metrics":{"likes":null,"comments":null,"shares":null,"quotes":null,"saves":null,"views":null},"extra":{"source_id":"2112634828478611813","published_at":"2026-10-20T19:59:28+00:00","content_type":"repost","topic":null,"topics":[],"images":[],"cover_url":null,"video_dur_s":null,"links":[],"reply_to":null,"conversation_id":"2112634828478611813","sensitive":null,"repost_of":{"id":"soc_x_5b5e5e233512","source_id":"2112628310702272570","text":"Some moments are worth floating back to. ✨\n\nWhen @NASA’s @SpaceX Crew-13 launched on Oct. 1, they brought along a little extra company! 🚀 Meet Lucky, a hand-crocheted golden dragon and the crew’s zero-gravity indicator! These small companions float freely once a spacecraft reaches microgravity, giving astronauts a visual sign that they’re officially weightless.","author":{"uid_hash":"c2fba03d9d28","followers":null,"nickname":null,"uid":"50115087","unique_id":"NASAJohnson"},"metrics":{"likes":1132,"comments":49,"shares":140,"quotes":9,"saves":50,"views":159973},"url":"https://x.com/NASAJohnson/status/2112628310702272570"},"quote_of":null,"url":"https://x.com/NASA/status/2112634828478611813","pinned":false},"prov":{"hash":"0x4e341ea0cdfdd2f6","ts":"2026-10-22T03:30:00+08:00","source":"live"}}],"cursor":"DAAHCgABHVLXNnz__-wLAAIAAAATMjExMDA5OTM0MzUzMzY0MTc2OAgAAwAAAAIAAA","has_more":true,"prov":{"hash":"0x6b6f5ff82a51d255","ts":"2026-10-22T03:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/x/search — X post search

ID: raw.x.search. Docs: https://qovia.ai/docs/api-reference/raw.x.search/
Keyword search for X posts in X's top order, optionally only posts with images and videos; the same records as post detail (same ids), authors with their follower counts. X matches more than the text (quoted posts, links and media), so a result may not contain the keyword. About 20 a page; pass the previous page's cursor back to continue and stop when has_more is false. No results answers empty and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- keyword (required; string; min length 1; max length 200): Search keyword (X's search syntax works, e.g. from:NASA or #hashtag)
- type (optional; string; one of "top", "media"; default "top"): Results: top (the default) or media (posts with images and videos only)
- cursor (optional; string): The cursor from the previous page's response; leave it out for the first page
Example request: curl -G "https://api.qovia.ai/v1/raw/x/search?keyword=Artemis" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_x_8028d7441f31","src":"social","platform":"x","lang":"en","text":"\"I just hear over and over again: 'I felt like I went on the mission with you'.\"\n\nArtemis II's Jeremy Hansen and Victor Glover reflect on their historic trip around the Moon — and how life on Earth has been since — in our latest Houston We Have A Podcast: https://t.co/jZ9Zm5P8Z8 https://t.co/A6YIgHFDqB","author":{"uid_hash":"99eae2f7b3d7","followers":92313360,"nickname":"NASA","uid":"11348282","unique_id":"NASA"},"metrics":{"likes":433,"comments":59,"shares":60,"quotes":9,"saves":18,"views":144683},"extra":{"source_id":"2112959650551173522","published_at":"2026-10-21T17:30:12+00:00","content_type":"image_post","topic":null,"topics":[],"images":["https://pbs.twimg.com/media/HVK9moNWUAAzx2Y.jpg"],"cover_url":"https://pbs.twimg.com/media/HVK9moNWUAAzx2Y.jpg","video_dur_s":null,"links":["https://go.nasa.gov/4dSkerm"],"reply_to":null,"conversation_id":"2112959650551173522","sensitive":false,"repost_of":null,"quote_of":null,"url":"https://x.com/NASA/status/2112959650551173522"},"prov":{"hash":"0xb2bf6b75a430dda4","ts":"2026-10-22T03:30:00+08:00","source":"live"}},{"id":"soc_x_af81593ad1d0","src":"social","platform":"x","lang":"en","text":"Earthshine.\n\nArtemis II astronaut Christina Koch captured this video of Earth outside the windows of the Orion spacecraft during the second flight day of the mission. Orion was roughly 33,800 miles (54,500 km) away from Earth when @Astro_Christina took this video. https://t.co/1YBxVj4hi9","author":{"uid_hash":"67a17d97abca","followers":1208192,"nickname":"NASA Artemis","uid":"632344577","unique_id":"NASAArtemis"},"metrics":{"likes":39671,"comments":1155,"shares":6981,"quotes":548,"saves":4922,"views":2076761},"extra":{"source_id":"2047018269446455578","published_at":"2026-04-22T18:22:41+00:00","content_type":"video","topic":null,"topics":[],"images":[],"cover_url":"https://pbs.twimg.com/media/HGh4RARXoAAbk4L.jpg","video_dur_s":19,"links":[],"reply_to":null,"conversation_id":"2047018269446455578","sensitive":false,"repost_of":null,"quote_of":null,"url":"https://x.com/NASAArtemis/status/2047018269446455578"},"prov":{"hash":"0x492b093d69ae8207","ts":"2026-10-22T03:30:00+08:00","source":"live"}}],"cursor":"DAACCgACHVLXXo_AJxAKAAMdUtdej7_Y8AgABAAAAAILAAUAAADwRW1QQzZ3QUFBZlEvZ0dKTjB2R3AvQUFBQUJRZFRuT0RodFp4Y1J4V2thV0dHckNWSFVsalN3Ulc4T1FkVEJiNWJ0ckFNaDFSVEFZSGx6RzBIR2g0UlQ4WFFSb2RVbDN1eUJmQkRSMVNTaVhuRjVIZ0hVbWFVYmhYSUJBZFVyMmJjOVlSa2gxU3pybmVGbUR3SFV3Q0ZhZlhzTDBkU2grWkpsYUFXUjFNVFVUSlY2R0pIVkZTeVFqV01Ga2RUQU84aFJwQUV4MUNveXl3V3lISUhVOTVPaUlXb0x3ZFF2cGdCQnNSYXgxU0l5bWEyaERxCAAGAAAAAAgABwAAAAAMAAgKAAEcVpGlhhqwlQAAAA","has_more":true,"prov":{"hash":"0x3b3492d4acaa82b0","ts":"2026-10-22T03:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/x/trending — X trending

ID: raw.x.trending. Docs: https://qovia.ai/docs/api-reference/raw.x.trending/
X's trends for a country in X's order, about 50: the term, its category (Sports, Politics, ...), whether it is a hashtag, and a search link. X shows no count here (heat is null). country is a two-letter country code, us (United States) by default.
Price: $0.001000 per successful call. Status: live.
Parameters:
- country (optional; string; one of "us", "cn", "in", "jp", "ru", "de", "id", "br", "fr", "gb", "tr", "it", "mx", "kr", "ca", "es", "sa", "eg", "au", "pl", "ir", "pk", "vn", "ng", "bd", "nl", "ar", "ph", "my", "co", "ae", "ro", "be", "ch", "sg", "se", "no", "at", "kz", "dz", "cl", "cz", "pe", "iq", "il", "ua", "dk", "pt", "hu", "gr", "fi", "nz", "by", "sk", "rs", "lt", "lu", "ee"; default "us"): The country (ISO 3166 two-letter code, lower case), us by default; e.g. jp, gb or in
Example request: curl -G "https://api.qovia.ai/v1/raw/x/trending?country=us" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"rank":1,"word":"BioWare","heat":null,"category":"Video games","is_topic":false,"url":"https://x.com/search?q=BioWare"},{"rank":2,"word":"Carrick","heat":null,"category":"UEFA Europa League","is_topic":false,"url":"https://x.com/search?q=Carrick"},{"rank":3,"word":"DreaminaOnly29Cents","heat":null,"category":null,"is_topic":true,"url":"https://x.com/search?q=%23DreaminaOnly29Cents"},{"rank":4,"word":"Nico Paz","heat":null,"category":"UEFA Europa League","is_topic":false,"url":"https://x.com/search?q=Nico%20Paz"}],"prov":{"hash":"0xce7e024378d841b6","ts":"2026-10-22T03:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

## Reddit

### GET /v1/raw/reddit/post — Reddit post detail

ID: raw.reddit.post. Docs: https://qovia.ai/docs/api-reference/raw.reddit.post/
One Reddit post: title and body (Reddit's markdown), author, subreddit, posted and edited times (UTC), score (upvotes minus downvotes), comment and share counts, upvote ratio, flair, the link it points to, images or the video's length, as the same record as search results (same id). Pass the post's fullname: t3_ plus the ID in reddit.com/r/<subreddit>/comments/<ID>/. A post that does not exist answers 404 and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- post_id (required; string): The post's fullname: t3_ plus the ID in reddit.com/r/<subreddit>/comments/<ID>/
Example request: curl -G "https://api.qovia.ai/v1/raw/reddit/post?post_id=t3_1xbt833" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_red_1a750cbda069","src":"social","platform":"reddit","lang":"en","text":"New Airbnb rules ban hosts from making guests wash dishes, do laundry & other checkout chores","author":{"uid_hash":"299b37f83b60","followers":null,"nickname":"example_user_1","uid":"t2_00000001","username":"example_user_1"},"metrics":{"likes":11382,"comments":907,"shares":615},"extra":{"source_id":"t3_1xbt833","title":"New Airbnb rules ban hosts from making guests wash dishes, do laundry & other checkout chores","subreddit":"technology","subreddit_id":"t5_2qh16","published_at":"2026-10-21T17:16:38+00:00","updated_at":null,"content_type":"link","flair":"Society","nsfw":false,"upvote_ratio":0.9885,"link_url":"https://www.dexerto.com/entertainment/new-airbnb-rules-ban-hosts-from-making-guests-wash-dishes-do-laundry-other-checkout-chores-3420832/","images":[],"cover_url":"https://external-preview.redd.it/iG4DQyrHGxTy2LRE2VubxlYmgRAnybJEOboepBlhvDs.jpeg?auto=webp&s=09d1608dce5f50c3ff462222b1065ac67fc70cfd","video_dur_s":null,"truncated":false,"url":"https://www.reddit.com/r/technology/comments/1xbt833/new_airbnb_rules_ban_hosts_from_making_guests/"},"prov":{"hash":"0x622bd1a221d4a3a9","ts":"2026-10-22T03:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/reddit/comments — Reddit post comments

ID: raw.reddit.comments. Docs: https://qovia.ai/docs/api-reference/raw.reddit.comments/
A post's comment tree, cursor-paginated, 8 a page: a few top-level comments with the replies Reddit expands under them, flattened in Reddit's order with depth (0 for a top-level comment) and parent_cid (the comment answered): text, score, total replies, time (UTC), whether it is pinned, and the commenter. Order by best (the default), top, new, old or controversial. Replies Reddit holds back come with a replies_cursor for raw.reddit.comment_replies. Pass the previous page's cursor back to continue; stop when has_more is false. A post without comments answers empty, one that does not exist 404; neither is charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- post_id (required; string): The post's fullname (t3_…, extra.source_id of post detail, subreddit posts or search)
- sort (optional; string; one of "best", "top", "new", "old", "controversial"; default "best"): Order: best (the default), top, new, old or controversial
- cursor (optional; string; min length 13; max length 2048): The cursor from the previous page's response; leave it out for the first page
Example request: curl -G "https://api.qovia.ai/v1/raw/reddit/comments?post_id=t3_1xbt833" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"cid":"t1_19rg000ofri4j","text":"And the Airbnb host subreddit is having a complete meltdown about it","likes":4571,"reply_count":126,"created_at":"2026-10-21T17:22:20+00:00","pinned":false,"author":{"uid_hash":"299b37f83b60","nickname":"example_user_1","uid":"t2_00000001","username":"example_user_1"},"depth":0,"parent_cid":null,"replies_cursor":"commenttree:53e6639b,::1:ex:,WFr2?o%Pj"},{"cid":"t1_19rg04nkcanwl","text":"They act like landlords instead of hospitality workers, so good. Hotels are better, people.","likes":3119,"reply_count":54,"created_at":"2026-10-21T17:25:13+00:00","pinned":false,"author":{"uid_hash":"8897faae40c1","nickname":"example_user_2","uid":"t2_00000002","username":"example_user_2"},"depth":1,"parent_cid":"t1_19rg000ofri4j","replies_cursor":"commenttree:aa00d618,::2:ex:,WFsK-;LP&:(:#$C8^Ag"}],"cursor":"commenttree:b0a55329,::0:ex:,WFq4W|n.A:':HRW7A3","has_more":true,"total":920,"prov":{"hash":"0x0520c1630b7a5f06","ts":"2026-10-22T03:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/reddit/comment_replies — Reddit comment replies

ID: raw.reddit.comment_replies. Docs: https://qovia.ai/docs/api-reference/raw.reddit.comment_replies/
The replies Reddit holds back under a comment, cursor-paginated, up to 8 a page, flattened into the same tree as the comments endpoint: text, score, total replies, time (UTC), depth, parent_cid, whether it is pinned, and the replier. cursor is required: for the first page a comment's replies_cursor (from raw.reddit.comments or this endpoint), then the previous page's cursor; stop when has_more is false. A cursor Reddit does not know, or no more replies, answers empty; a post that does not exist 404; neither is charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- post_id (required; string): The fullname of the comment's post (t3_…)
- cursor (required; string; min length 13; max length 2048): A comment's replies_cursor for the first page, then the previous page's cursor
- sort (optional; string; one of "best", "top", "new", "old", "controversial"; default "best"): Order: best (the default), top, new, old or controversial
Example request: curl -G "https://api.qovia.ai/v1/raw/reddit/comment_replies?post_id=t3_1xbt833&cursor=commenttree%3A1032b8a8%2C%3A%3A1%3Aex%3A%2CWFs(EBkw2" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"cid":"t1_19rg058wqt75s","text":"Honestly, this is the play especially when traveling alone.","likes":804,"reply_count":27,"created_at":"2026-10-21T17:25:35+00:00","pinned":false,"author":{"uid_hash":"299b37f83b60","nickname":"example_user_1","uid":"t2_00000001","username":"example_user_1"},"depth":1,"parent_cid":"t1_19rfzwlkafeyp","replies_cursor":"commenttree:cd214a36,::2:ex:,WFtniC9.s"},{"cid":"t1_19rg0qfzzddac","text":"Even when travelling with my wife and kid. I mean not to worry about my kid spilling some drink on the bed. And have free breakfast options. Clean towels guaranteed. And generally some expected level of professionalism is just great.\n\nAirbnb is too stressful for me.","likes":458,"reply_count":13,"created_at":"2026-10-21T17:38:47+00:00","pinned":false,"author":{"uid_hash":"8897faae40c1","nickname":"example_user_2","uid":"t2_00000002","username":"example_user_2"},"depth":2,"parent_cid":"t1_19rg058wqt75s","replies_cursor":"commenttree:79d2a74d,::3:ex:,WFun#[H(h"}],"cursor":"commenttree:d4377d7c,::1:ex:,WFr8~yLV1:':nEHAC\"","has_more":true,"prov":{"hash":"0x91973e2a95a191ba","ts":"2026-10-22T03:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/reddit/subreddit_posts — Reddit subreddit posts

ID: raw.reddit.subreddit_posts. Docs: https://qovia.ai/docs/api-reference/raw.reddit.subreddit_posts/
A subreddit's posts by hot (the default), best, new, top, controversial or rising, cursor-paginated (about 6 on the first page, then about 24): title, the first 300 characters of the body, author, posted time (UTC), score, comment and share counts, flair and the link it points to, as the same records as post detail (same ids). The list carries no language, author ID, images or upvote ratio (null): raw.reddit.post does. Ads are left out. Pass the previous page's cursor back to continue; stop when has_more is false. A subreddit that does not exist answers 404 and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- subreddit (required; string): The subreddit's name (after r/, e.g. technology)
- sort (optional; string; one of "hot", "best", "new", "top", "controversial", "rising"; default "hot"): Order: hot (the default), best, new, top, controversial or rising
- cursor (optional; string; max length 200): The cursor from the previous page's response; leave it out for the first page
Example request: curl -G "https://api.qovia.ai/v1/raw/reddit/subreddit_posts?subreddit=technology" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_red_21addc0593d8","src":"social","platform":"reddit","lang":null,"text":"ELI5: The Earth and super massive impacts\nIn many simulations I’ve seen, a planet like object crashes into the early Earth. Part of it spins off losing mass from the impact and then it settles into orbit, eventually becoming the moon. However in other simulations of the earth today, if the moon or some other similarly-sized object approache","author":{"uid_hash":"299b37f83b60","followers":null,"nickname":"example_user_1","uid":null,"username":"example_user_1"},"metrics":{"likes":0,"comments":4,"shares":0},"extra":{"source_id":"t3_1xbu6tq","title":"ELI5: The Earth and super massive impacts","subreddit":"explainlikeimfive","subreddit_id":null,"published_at":"2026-10-21T17:51:02+00:00","updated_at":null,"content_type":"text","flair":"Planetary Science","nsfw":false,"upvote_ratio":null,"link_url":null,"images":[],"cover_url":null,"video_dur_s":null,"truncated":true,"url":"https://www.reddit.com/r/explainlikeimfive/comments/1xbu6tq/"},"prov":{"hash":"0xa0e9dd34d33942f1","ts":"2026-10-22T03:30:00+08:00","source":"live"}},{"id":"soc_red_9bc3a3b081df","src":"social","platform":"reddit","lang":null,"text":"ELI5: what is a fellowship in medicine?\nbonus points if you can also explain GME and ACGME ahaha but so it’s after you graduate med school? but it’s more schooling? or it’s working as a dr?","author":{"uid_hash":"8897faae40c1","followers":null,"nickname":"example_user_2","uid":null,"username":"example_user_2"},"metrics":{"likes":17,"comments":22,"shares":2},"extra":{"source_id":"t3_1xbu413","title":"ELI5: what is a fellowship in medicine?","subreddit":"explainlikeimfive","subreddit_id":null,"published_at":"2026-10-21T17:48:14+00:00","updated_at":null,"content_type":"text","flair":"Other","nsfw":false,"upvote_ratio":null,"link_url":null,"images":[],"cover_url":null,"video_dur_s":null,"truncated":false,"url":"https://www.reddit.com/r/explainlikeimfive/comments/1xbu413/"},"prov":{"hash":"0x1a80b263f0656360","ts":"2026-10-22T03:30:00+08:00","source":"live"}}],"cursor":"dDNfMXhicnFoMg==","has_more":true,"prov":{"hash":"0xc85a89bc5b7f14e3","ts":"2026-10-22T03:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/reddit/user — Reddit user profile

ID: raw.reddit.user. Docs: https://qovia.ai/docs/api-reference/raw.reddit.user/
A Reddit user's profile: display name, karma (total, from posts and from comments), post and comment counts, whether it is verified, a brand account or a Reddit employee, account creation time (UTC), bio, links listed on the profile and avatar. Pass the username (from reddit.com/user/<username>, without u/). This route does not show follower counts (null). A user that does not exist answers 404 and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- username (required; string): The username (from reddit.com/user/<username>, without u/)
Example request: curl -G "https://api.qovia.ai/v1/raw/reddit/user?username=nasa" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"uid_hash":"649c1eb1827c","platform":"reddit","uid":"t2_1dkvvygb","username":"nasa","nickname":"NASA","followers":null,"karma":429798,"post_karma":259891,"comment_karma":169907,"posts":914,"comments":5923,"verified":true,"is_brand":true,"is_employee":false,"nsfw":false,"created_at":"2018-05-15T21:25:14+00:00","signature":"Explore the universe and discover our home planet with NASA. \n\nVerification: nasa.gov/socialmedia","links":[{"title":"NASA.gov","url":"https://nasa.gov"},{"title":"NASA","url":"https://twitter.com/NASA"},{"title":"NASA","url":"https://instagram.com/NASA"},{"title":"NASA","url":"https://www.facebook.com/NASA/"},{"title":"NASA","url":"https://twitch.tv/NASA"}],"avatar_url":"https://styles.redditmedia.com/t5_k5gc6/styles/profileIcon_ydyqarnwt7s91.png?width=256&height=256&frame=1&auto=webp&crop=256:256,smart&s=77a410a48a906e94c2c113eafe0299c9bccd6d27","url":"https://www.reddit.com/user/nasa/","prov":{"hash":"0xfe79527b68583b1f","ts":"2026-10-22T03:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/reddit/search — Reddit post search

ID: raw.reddit.search. Docs: https://qovia.ai/docs/api-reference/raw.reddit.search/
Search Reddit posts by keyword, as the same records as post detail (same ids), about 7 a page. Order by relevance (the default), hot, top, new or comments, and limit the posting time with time_range; Reddit's search syntax works (AND, OR, NOT, quoted phrases, subreddit:, author:, title:, ...). When Reddit spell-corrects the query, corrected_query is what it searched instead. Pass the previous page's cursor back to continue; stop when has_more is false. No results answers empty and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- keyword (required; string; min length 1; max length 200): Search keyword; Reddit's search syntax works
- sort (optional; string; one of "relevance", "hot", "top", "new", "comments"; default "relevance"): Order: relevance (the default), hot, top, new or comments (most commented)
- time_range (optional; string; one of "all", "year", "month", "week", "day", "hour"; default "all"): Posting time: all (the default), year, month, week, day or hour
- cursor (optional; string; max length 2048): The cursor from the previous page's response; leave it out for the first page
Example request: curl -G "https://api.qovia.ai/v1/raw/reddit/search?keyword=openai" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_red_b3f859ab515a","src":"social","platform":"reddit","lang":"en","text":"Terence Tao explaining why it was extremely rude to dump these math solutions.\nI recommend watching the whole interview, but for me, the most puzzling part was why they wanted OpenAI to stay away. He actually explains it quite reasonably (6:17 to 9:12)","author":{"uid_hash":"299b37f83b60","followers":null,"nickname":"example_user_1","uid":"t2_00000001","username":"example_user_1"},"metrics":{"likes":150,"comments":569,"shares":null},"extra":{"source_id":"t3_1x7r549","title":"Terence Tao explaining why it was extremely rude to dump these math solutions.","subreddit":"OpenAI","subreddit_id":"t5_3b9u5","published_at":"2026-10-16T20:30:14+00:00","updated_at":null,"content_type":"video","flair":"Discussion","nsfw":false,"upvote_ratio":0.7206,"link_url":"https://youtu.be/bAnwMdfcMVw?si=DOnS2hNZSxF5cYaR&t=376","images":[],"cover_url":"https://external-preview.redd.it/V9kvyCU7sgbx8ZGBcJydsg1oNb3bYE8fFN7FfE93Z1k.jpeg?format=pjpg&auto=webp&s=5f07e63001e93eaa9d559f6f9d22144fd6e26eed","video_dur_s":null,"truncated":false,"url":"https://www.reddit.com/r/OpenAI/comments/1x7r549/terence_tao_explaining_why_it_was_extremely_rude/"},"prov":{"hash":"0xaa4e5ac69f9f97be","ts":"2026-10-22T03:30:00+08:00","source":"live"}},{"id":"soc_red_c78ae67e4e65","src":"social","platform":"reddit","lang":"en","text":"Mathematicians say OpenAI doesn't understand its own Navier-Stokes proof","author":{"uid_hash":"8897faae40c1","followers":null,"nickname":"example_user_2","uid":"t2_00000002","username":"example_user_2"},"metrics":{"likes":481,"comments":402,"shares":null},"extra":{"source_id":"t3_1x8qcrt","title":"Mathematicians say OpenAI doesn't understand its own Navier-Stokes proof","subreddit":"NowInTech","subreddit_id":"t5_exd20i","published_at":"2026-10-18T01:08:55+00:00","updated_at":null,"content_type":"link","flair":null,"nsfw":false,"upvote_ratio":0.9429,"link_url":"https://the-decoder.com/mathematicians-say-openai-doesnt-understand-its-own-navier-stokes-proof/","images":[],"cover_url":"https://external-preview.redd.it/SmEm4MEmuPMZ3tP0wC3r-FI5bo2xsQycBod_1jtAhOQ.png?auto=webp&s=2323ad854e5006feae3b301f5f7ee153440ee355","video_dur_s":null,"truncated":false,"url":"https://www.reddit.com/r/NowInTech/comments/1x8qcrt/mathematicians_say_openai_doesnt_understand_its/"},"prov":{"hash":"0x269c9a816aae8ad2","ts":"2026-10-22T03:30:00+08:00","source":"live"}}],"cursor":"eyJjYW5kaWRhdGVzX3JldHVybmVkIjoie1wic2VjdGlvbl8xX3BpcGVsaW5lXzBfZ2xvYmFsX21vZGlmaWVyc1wiOlwiMVwiLFwic2VjdGlvbl8xX3BpcGVsaW5lXzFfbG9jYWxfbW9kaWZpZXJzXCI6XCIyXCIsXCJzZWN0aW9uXzJfcGlwZWxpbmVfOF9keW5hbWljXzBfcG9zdF9zZWFyY2hcIjpcIjdcIn0iLCJleHBlcmllbmNlX3NlbGVjdGlvbiI6InBvc3RzX3YyIiwiZXhwZXJpZW5jZV92ZXJzaW9uIjoiZGVmYXVsdCIsInNlY3Rpb25fMl9waXBlbGluZV84X2R5bmFtaWNfMF9wb3N0X3NlYXJjaCI6IjcifQ==","has_more":true,"corrected_query":null,"prov":{"hash":"0xa32f01d9964b254a","ts":"2026-10-22T03:30:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

## Weibo

### GET /v1/raw/weibo/post — Weibo post detail

ID: raw.weibo.post. Docs: https://qovia.ai/docs/api-reference/raw.weibo.post/
One Weibo post: full text (long posts too), author, like / comment / repost counts, reads and video plays (when Weibo shows them), topics, images, video duration, publish time, the reposted original and link. Pass the mid or the mblogid from the post's link. A post that does not exist or was deleted answers 404 and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- post_id (required; string): The post's mid (16 digits), or the mblogid from its link weibo.com/<uid>/<mblogid>
Example request: curl -G "https://api.qovia.ai/v1/raw/weibo/post?post_id=5356598172060958" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_wei_f1213581dc20","src":"social","platform":"weibo","lang":"zh-CN","text":"【#你好，明天#｜长征有答案，奋进无止境】中国工农红军长征胜利90周年之际，重磅微视频《长征答案》发布。长征的答案，藏在雪山草地的脚印里，更写在今天安稳的日子里。九十载光阴流转，万水千山已过，但奋进的号角从未停歇。先辈踏开生路，我辈接续奔赴。向前，继续向前，走好新时代的长征路！#长征胜利90年了# http://t.cn/AXjvj4n5","author":{"uid_hash":"e8f64c406208","followers":158106483,"nickname":"人民日报","uid":"2803301701"},"metrics":{"likes":163,"comments":73,"shares":40,"plays":7173811,"views":126013},"extra":{"source_id":"5356598172060958","mblogid":"RnKnn8E9g","published_at":"2026-10-21T23:19:48+08:00","content_type":"video","topic":"#你好，明天","topics":["你好，明天","长征胜利90年了"],"images":[],"cover_url":"https://wx1.sinaimg.cn/orj480/0033ImPzly1ii981zb1frj61hc0u0u0x02.jpg","video_dur_s":140,"ip_location":null,"truncated":false,"repost_of":null,"url":"https://weibo.com/2803301701/RnKnn8E9g"},"prov":{"hash":"0xcc2cb8ebe79d9c1b","ts":"2026-10-21T23:50:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/weibo/comments — Weibo post comments

ID: raw.weibo.comments. Docs: https://qovia.ai/docs/api-reference/raw.weibo.comments/
First-level comments of a post (hottest first), cursor-paginated, up to 20 a page: text, likes, reply count, IP region, time, whether the poster liked it, and the commenter. Pass the previous page's cursor back to continue; stop when has_more is false. Replies come from raw.weibo.comment_replies. A post without comments, or one that does not exist, answers empty and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- post_id (required; string): The post's mid (16 digits, a post record's extra.source_id)
- cursor (optional; integer; min 1): The cursor from the previous page's response; leave it out for the first page
- count (optional; integer; default 20; min 1; max 20): Items per page
Example request: curl -G "https://api.qovia.ai/v1/raw/weibo/comments?post_id=5356532793082377" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"cid":"5356596773519788","text":"#致敬伟大的长征#，在新的长征路上继续奋勇前进！#红军长征胜利90周年#","likes":247,"ip_location":"中国香港","reply_count":59,"created_at":"2026-10-21T23:14:13+08:00","liked_by_author":false,"author":{"uid_hash":"c2996c06401f","nickname":"叶***","uid":"7000000001"}},{"cid":"5356537552833787","text":"弘扬伟大长征精神，走好新时代的长征路！","likes":260,"ip_location":"四川","reply_count":4,"created_at":"2026-10-21T19:18:55+08:00","liked_by_author":false,"author":{"uid_hash":"a7f13caff774","nickname":"J***名","uid":"7000000002"}}],"cursor":142331504458211,"has_more":true,"total":1948,"prov":{"hash":"0xc6f4d4c484c07691","ts":"2026-10-21T23:50:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/weibo/comment_replies — Weibo comment replies

ID: raw.weibo.comment_replies. Docs: https://qovia.ai/docs/api-reference/raw.weibo.comment_replies/
Replies under one comment, cursor-paginated, up to 20 a page: text, likes, IP region, time, the reply it answers, and the replier. Pass the previous page's cursor back to continue; stop when has_more is false. A later page can come back empty once: ask again. A comment without replies answers empty and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- comment_id (required; string): The first-level comment's cid (from the post comments endpoint)
- cursor (optional; integer; min 1): The cursor from the previous page's response; leave it out for the first page
- count (optional; integer; default 20; min 1; max 20): Items per page
Example request: curl -G "https://api.qovia.ai/v1/raw/weibo/comment_replies?comment_id=5356596773519788" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"cid":"5356597190854849","text":"致敬先烈！弘扬伟大长征精神，走好新时代的长征路！","likes":80,"ip_location":"重庆","reply_count":null,"created_at":"2026-10-21T23:15:54+08:00","author":{"uid_hash":"44e48150ce1f","nickname":"静***C","uid":"7000000003"},"parent_cid":"5356596773519788","reply_to_cid":null},{"cid":"5356597278674358","text":"在新的长征路上继续奋勇前进！","likes":70,"ip_location":"湖南","reply_count":null,"created_at":"2026-10-21T23:16:15+08:00","author":{"uid_hash":"8375a9d8d255","nickname":"小***耶","uid":"7000000004"},"parent_cid":"5356596773519788","reply_to_cid":null}],"cursor":140269923879621,"has_more":true,"total":59,"prov":{"hash":"0xf6ceace4ba8ba5d8","ts":"2026-10-21T23:50:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/weibo/user — Weibo user profile

ID: raw.weibo.user. Docs: https://qovia.ai/docs/api-reference/raw.weibo.user/
A Weibo user's profile with followers, following, post count, likes received, verification, bio, gender, location, personal domain and avatar. Pass either the uid or the personal domain (weibo.com/<domain>). A user that does not exist answers 404 and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- uid (optional; string): The user's uid (the number in weibo.com/u/<uid>); pass this or domain
- domain (optional; string): The personal domain (from weibo.com/<domain>, e.g. rmrb); pass this or uid
Example request: curl -G "https://api.qovia.ai/v1/raw/weibo/user?uid=2803301701" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"uid_hash":"e8f64c406208","nickname":"人民日报","followers":158106478,"total_likes":2531733928,"posts":154474,"verified":true,"platform":"weibo","uid":"2803301701","domain":"rmrb","following":3096,"signature":"人民日报法人微博。参与、沟通、记录时代。","verify_reason":"《人民日报》法人微博","gender":"male","location":"北京","avatar_url":"https://tvax4.sinaimg.cn/crop.0.0.1018.1018.1024/0033ImPzly8h8vgemh8kxj60sa0sadgw02.jpg?KID=imgbed,tva&Expires=1792608291&ssig=BIwm2KCi85","url":"https://weibo.com/u/2803301701","prov":{"hash":"0xa8daf0ca01f528cb","ts":"2026-10-21T23:50:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/weibo/user_posts — Weibo user posts

ID: raw.weibo.user_posts. Docs: https://qovia.ai/docs/api-reference/raw.weibo.user_posts/
Posts a user published, the pinned one first, then newest first, about 20 a page, as the same records as post detail (same ids); long posts carry their start only (extra.truncated is true; raw.weibo.post gives the full text). Page by number; stop when has_more is false. A user without posts answers empty and one that does not exist answers 404; neither is charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- uid (required; string): The user's uid (the number in weibo.com/u/<uid>)
- page (optional; integer; default 1; min 1; max 1000): Page number, from 1
Example request: curl -G "https://api.qovia.ai/v1/raw/weibo/user_posts?uid=2803301701" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_wei_5c54e4ac5cf1","src":"social","platform":"weibo","lang":"zh-CN","text":"【此刻，发条微博，#致敬伟大的长征#】#红星永远闪耀# 1934年10月至1936年10月，英雄的红军将士历时2年，纵横十余省，长驱数万里，战胜千难万险，胜利完成震撼世界、彪炳史册的长征，创造了气吞山河的人间奇迹。纪念#红军长征胜利90周年#，弘扬伟大长征精神，走好新时代的长征路！http://t.cn/AXj7rnhT","author":{"uid_hash":"e8f64c406208","followers":null,"nickname":"人民日报","uid":"2803301701"},"metrics":{"likes":9575,"comments":1933,"shares":100378,"plays":1818091},"extra":{"source_id":"5356532793082377","mblogid":"RnIFVcVRL","published_at":"2026-10-21T19:00:00+08:00","content_type":"video","topic":"#致敬伟大的长征","topics":["致敬伟大的长征","红星永远闪耀","红军长征胜利90周年"],"images":[],"cover_url":"https://wx2.sinaimg.cn/orj480/0033ImPzly1iia5k2uy7nj60ti13dx6p02.jpg","video_dur_s":19,"ip_location":null,"truncated":false,"repost_of":null,"url":"https://weibo.com/2803301701/RnIFVcVRL","pinned":true},"prov":{"hash":"0x844ced11fd673fa7","ts":"2026-10-21T23:50:00+08:00","source":"live"}},{"id":"soc_wei_56162b915c95","src":"social","platform":"weibo","lang":"zh-CN","text":"【上新！#故宫的秋天太出片了#】几枝丹柿，一泓疏影，半阙清秋。#故宫秋日进度条已过半# @故宫博物院","author":{"uid_hash":"e8f64c406208","followers":null,"nickname":"人民日报","uid":"2803301701"},"metrics":{"likes":1332,"comments":364,"shares":436},"extra":{"source_id":"5356505786222549","mblogid":"RnHYmq6LH","published_at":"2026-10-21T17:12:41+08:00","content_type":"image_post","topic":"#故宫的秋天太出片了","topics":["故宫的秋天太出片了","故宫秋日进度条已过半"],"images":["https://wx1.sinaimg.cn/large/0033ImPzly1iia3accwbrj60j60y34eo02.jpg","https://wx3.sinaimg.cn/large/0033ImPzly1iia3ac8imtj60j60y37dy02.jpg","https://wx2.sinaimg.cn/large/0033ImPzly1iia3acci42j60j60y3k5p02.jpg","https://wx4.sinaimg.cn/large/0033ImPzly1iia3acd7xlj60j60y3ao302.jpg","https://wx4.sinaimg.cn/large/0033ImPzly1iia3ac4huzj60j60y3gtn02.jpg","https://wx4.sinaimg.cn/large/0033ImPzly1iia3ac9appj60j60y37fc02.jpg","https://wx3.sinaimg.cn/large/0033ImPzly1iia3acb1mtj60j60y3gxl02.jpg","https://wx3.sinaimg.cn/large/0033ImPzly1iia3ac9zt2j60j60y3k2i02.jpg","https://wx4.sinaimg.cn/large/0033ImPzly1iia3acbc6ej60j60y3qfj02.jpg"],"cover_url":"https://wx1.sinaimg.cn/large/0033ImPzly1iia3accwbrj60j60y34eo02.jpg","video_dur_s":null,"ip_location":null,"truncated":false,"repost_of":null,"url":"https://weibo.com/2803301701/RnHYmq6LH","pinned":false},"prov":{"hash":"0xe8db8e61c34824ca","ts":"2026-10-21T23:50:00+08:00","source":"live"}}],"page":1,"has_more":true,"prov":{"hash":"0x6db3a73c2ace917b","ts":"2026-10-21T23:50:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/weibo/search — Weibo search

ID: raw.weibo.search. Docs: https://qovia.ai/docs/api-reference/raw.weibo.search/
Keyword search for Weibo posts, optionally within a range of publish dates (Beijing time, whole days), only hot, original, verified-user, media or viewpoint posts, or only posts with images, videos, music or links; the same records as post detail (same ids), with text that may be cut (extra.truncated) and no interaction counts. Pages hold a varying number of posts (up to about 20); page by number, up to 50 pages, and stop at an empty page. No results answers empty and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- keyword (required; string; min length 1; max length 100): Search keyword
- start_date (optional; string): First publish date, included (Beijing time, YYYY-MM-DD); pass it with end_date
- end_date (optional; string): Last publish date, included (Beijing time, YYYY-MM-DD); pass it with start_date
- type (optional; string; one of "all", "hot", "original", "verified", "media", "viewpoint"): Only: all, hot, original, verified (verified users), media or viewpoint; all when left out
- contains (optional; string; one of "all", "image", "video", "music", "link"): Containing: all, image, video, music or link; all when left out
- page (optional; integer; default 1; min 1; max 50): Page number, from 1, at most 50
Example request: curl -G "https://api.qovia.ai/v1/raw/weibo/search?keyword=%E9%95%BF%E5%BE%81&start_date=2026-10-20&end_date=2026-10-21" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_wei_66be530dfcd9","src":"social","platform":"weibo","lang":"zh-CN","text":"【#活动散场后男子吹响冲锋号全场沸腾#】近日，天津一场长征胜利90周年纪念活动散场后，一名男子吹响冲锋号，瞬间全场沸腾。该男子接受中新网采访时表示，当时散场后大家说再吹一个，于是就贴合主题吹了冲锋号。中国新闻网的微博视频（中国新闻网）","author":{"uid_hash":"f879ebcea33e","followers":null,"nickname":"工人日报","uid":"3840768703"},"metrics":{"likes":null,"comments":null,"shares":null},"extra":{"source_id":"5356593191060572","mblogid":"RnKfl4rU0","published_at":"2026-10-21T23:00:00+08:00","content_type":"video","topic":"#活动散场后男子吹响冲锋号全场沸腾","topics":["活动散场后男子吹响冲锋号全场沸腾"],"images":[],"cover_url":null,"video_dur_s":null,"ip_location":null,"truncated":false,"repost_of":null,"url":"https://weibo.com/3840768703/RnKfl4rU0"},"prov":{"hash":"0xdc59f6580c0f1192","ts":"2026-10-21T23:50:00+08:00","source":"live"}},{"id":"soc_wei_efafe027096e","src":"social","platform":"weibo","lang":"zh-CN","text":"#晚安，广西！#【#周深献唱纪念红军长征胜利90周年MV#】九十年长风不息，烽烟虽远，星火滚烫。@卡布叻_周深倾情演唱的《万里长风》，以歌声回望来路，循先辈足迹，奔赴属于我们的新征程。#跨越90年的回信#（来源：央视新闻）央视新闻的微博视频","author":{"uid_hash":"8a692ede06c2","followers":null,"nickname":"广西新闻网","uid":"1986954045"},"metrics":{"likes":null,"comments":null,"shares":null},"extra":{"source_id":"5356593190540232","mblogid":"RnKfl2gxq","published_at":"2026-10-21T23:00:00+08:00","content_type":"video","topic":"#晚安，广西！","topics":["晚安，广西！","周深献唱纪念红军长征胜利90周年MV","跨越90年的回信"],"images":[],"cover_url":null,"video_dur_s":null,"ip_location":null,"truncated":false,"repost_of":null,"url":"https://weibo.com/1986954045/RnKfl2gxq"},"prov":{"hash":"0xd5cc0da71c4fbd32","ts":"2026-10-21T23:50:00+08:00","source":"live"}}],"page":1,"has_more":true,"prov":{"hash":"0x0454d79596c740cd","ts":"2026-10-21T23:50:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/weibo/hot_search — Weibo hot search

ID: raw.weibo.hot_search. Docs: https://qovia.ai/docs/api-reference/raw.weibo.hot_search/
Weibo's realtime hot search board in rank order: the term, its heat, Weibo's label (新 new, 热 hot, 沸 boiling, 爆 exploding, ...), category, whether it is a topic, and a search link, plus the topics pinned above rank 1 (pinned). Ad slots are left out. No params; it changes about every minute.
Price: $0.001000 per successful call. Status: live.
Parameters: none.
Example request: curl -G "https://api.qovia.ai/v1/raw/weibo/hot_search" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"rank":1,"word":"AG 退役","heat":1383391,"label":"新","category":null,"is_topic":false,"url":"https://s.weibo.com/weibo?q=AG%20%E9%80%80%E5%BD%B9"},{"rank":2,"word":"红果短剧自砍摇钱树","heat":1284794,"label":"热","category":null,"is_topic":false,"url":"https://s.weibo.com/weibo?q=%E7%BA%A2%E6%9E%9C%E7%9F%AD%E5%89%A7%E8%87%AA%E7%A0%8D%E6%91%87%E9%92%B1%E6%A0%91"},{"rank":3,"word":"他们走过二万五千里换来今天","heat":835614,"label":null,"category":null,"is_topic":true,"url":"https://s.weibo.com/weibo?q=%23%E4%BB%96%E4%BB%AC%E8%B5%B0%E8%BF%87%E4%BA%8C%E4%B8%87%E4%BA%94%E5%8D%83%E9%87%8C%E6%8D%A2%E6%9D%A5%E4%BB%8A%E5%A4%A9%23"},{"rank":4,"word":"肖战刘铮亮当群演了","heat":731539,"label":null,"category":"剧集","is_topic":true,"url":"https://s.weibo.com/weibo?q=%23%E8%82%96%E6%88%98%E5%88%98%E9%93%AE%E4%BA%AE%E5%BD%93%E7%BE%A4%E6%BC%94%E4%BA%86%23"}],"pinned":[{"rank":null,"word":"我们的长征路","heat":null,"label":"热","category":null,"is_topic":true,"url":"https://s.weibo.com/weibo?q=%23%E6%88%91%E4%BB%AC%E7%9A%84%E9%95%BF%E5%BE%81%E8%B7%AF%23"}],"prov":{"hash":"0x91b7ec5e863c022e","ts":"2026-10-21T23:50:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

## Toutiao

### GET /v1/raw/toutiao/article — Toutiao article detail

ID: raw.toutiao.article. Docs: https://qovia.ai/docs/api-reference/raw.toutiao.article/
One Toutiao article's title, author (followers, verification), read / like / comment / share / save counts and cover. Body text and publish time are not available. A video's ID answers the same data (content_type video). An article that does not exist or was deleted answers 404 and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- article_id (required; string): Article ID (the number in toutiao.com/article/<ID>/)
Example request: curl -G "https://api.qovia.ai/v1/raw/toutiao/article?article_id=7696832476378841640" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_tou_39a391897265","src":"social","platform":"toutiao","lang":"zh-CN","text":"重磅！大风暴前夜，中国要捅破这重天！这步大棋，你看懂了吗？","author":{"uid_hash":"f5fdb2f05f9d","followers":4078656,"nickname":"占豪","user_id":"4118004227","verified":true,"verify_reason":"头条领航创作者","avatar_url":"https://p3-sign.toutiaoimg.com/user-avatar/400f6974a38c372858b860c1d2ea2473~tplv-resize:120:120.image?_iz=112761&from=tt_user.tuwen&lk3s=06827d14&x-expires=1793232000&x-signature=yCAcsbFhOUdUpP%2FWit0Fii1jM%2B4%3D"},"metrics":{"likes":2298,"comments":112,"shares":1526,"saves":1239,"views":67840},"extra":{"source_id":"7696832476378841640","url":"https://www.toutiao.com/article/7696832476378841640/","title":"重磅！大风暴前夜，中国要捅破这重天！这步大棋，你看懂了吗？","content_type":"article","published_at":null,"video_dur_s":null,"cover_url":"https://p3-sign.toutiaoimg.com/tos-cn-i-6w9my0ksvp/0d93d29482af430eb4664fe1c46810d5~tplv-tt-thumb.webp?_iz=1&bid=10&ci=&from=article.private_chat&gi=&gid=7696832476378841640&ii=0&lk3s=06827d14&rt=0&x-expires=1793202536&x-signature=RZMDpnbD%2BJtLa%2F1L2YJV7gkSuHw%3D"},"prov":{"hash":"0xd412fe8b17a7b899","ts":"2026-10-22T00:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/toutiao/video — Toutiao video detail

ID: raw.toutiao.video. Docs: https://qovia.ai/docs/api-reference/raw.toutiao.video/
One Toutiao video: title, summary, author (followers, verification), play / like / comment / share / save counts, publish time, duration and cover. A video that does not exist or was deleted, or an article's ID, answers 404 and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- video_id (required; string): Video ID (the number in toutiao.com/video/<ID>/)
Example request: curl -G "https://api.qovia.ai/v1/raw/toutiao/video?video_id=7698919784800420352" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_tou_9265ff240147","src":"social","platform":"toutiao","lang":"zh-CN","text":"北京 降雨降温 外出注意添衣保暖","author":{"uid_hash":"e8e55902e40d","followers":113447603,"nickname":"央视新闻","user_id":"4492956276","verified":true,"verify_reason":"中央广播电视总台央视新闻官方账号","avatar_url":"https://p3-sign.toutiaoimg.com/user-avatar/44ef8ebcb1014a36882db98edd29729a~tplv-resize:120:120.image?_iz=112761&from=tt_user.video&lk3s=06827d14&x-expires=1793232000&x-signature=asz%2FjNP0vD%2FLbdnN5de3Sopffpg%3D"},"metrics":{"likes":198,"comments":1,"shares":24,"saves":24,"views":39473},"extra":{"source_id":"7698919784800420352","url":"https://www.toutiao.com/video/7698919784800420352/","title":"北京 降雨降温 外出注意添衣保暖","content_type":"video","published_at":"2026-10-21T09:00:58+08:00","video_dur_s":25,"cover_url":"https://p3-sign.toutiaoimg.com/tos-cn-i-tjoges91tu/17acb236f2f0d567147b3a6b23c1b631~tplv-tt-im:1920:1440.webp?_iz=1&bid=16&ci=&from=ttvideo.private_chat&gi=&gid=7698919784800420352&ii=0&lk3s=06827d14&rt=0&x-expires=1793202528&x-signature=UNNvfr2%2FYMGNjmMOkDd3hCRcOwQ%3D"},"prov":{"hash":"0xef008600a931f305","ts":"2026-10-22T00:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/toutiao/comments — Toutiao comments

ID: raw.toutiao.comments. Docs: https://qovia.ai/docs/api-reference/raw.toutiao.comments/
First-level comments of an article or a video, hottest first, 20 a page: text, likes, reply count, time, IP location, whether the author liked it, and the commenter. Pass the previous page's cursor back to continue (adjacent pages may repeat a comment: deduplicate by cid); stop when has_more is false. Content without comments, or that does not exist, answers empty and is not charged.
Price: $0.001000 per successful call. Status: live.
Parameters:
- group_id (required; string): Article or video ID (the number in toutiao.com/article/<ID>/ or toutiao.com/video/<ID>/)
- cursor (optional; integer; default 0; min 0; max 10000): The cursor from the previous page's response; 0 for the first page
Example request: curl -G "https://api.qovia.ai/v1/raw/toutiao/comments?group_id=7696832476378841640" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"cid":"7696924554858038035","text":"人民，只有人民，才是创造世界历史的动力。","likes":125,"ip_location":"云南","reply_count":4,"created_at":"2026-10-15T23:58:29+08:00","liked_by_author":false,"images":[],"author":{"uid_hash":"5e4e56ddf496","nickname":"福***V","user_id":"4000000000000001"}},{"cid":"7698663575212688179","text":"@豆包 看的热血沸腾。我们的政府高瞻远瞩，未雨绸缪。我们大中华越来越繁荣昌盛！屹立于世界之巅！","likes":2,"ip_location":"四川","reply_count":1,"created_at":"2026-10-20T16:26:45+08:00","liked_by_author":false,"images":[],"author":{"uid_hash":"08289dab4865","nickname":"青***宛","user_id":"4000000000000002"}}],"cursor":20,"has_more":true,"total":112,"prov":{"hash":"0x42c1e69b4fcb7300","ts":"2026-10-22T00:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

## Taobao & Tmall

### GET /v1/raw/taobao/comments — Taobao & Tmall product reviews

ID: raw.taobao.comments. Docs: https://qovia.ai/docs/api-reference/raw.taobao.comments/
Buyer reviews of a Taobao or Tmall item, newest first, 20 per page: text and time, positive / neutral / negative rating, SKU, the buyer's nickname (masked by Taobao) and member level, photos and videos, the follow-up review and shop replies. item_id takes Taobao and Tmall item IDs alike. Default positive reviews without text are skipped unless they carry a follow-up. Stop paging when has_more is false. An item without reviews, or one that does not exist, answers empty and is not charged.
Price: $0.013500 per successful call. Status: live.
Parameters:
- item_id (required; string): Taobao or Tmall item ID (the id= in the item URL)
- page (optional; integer; default 1; min 1; max 500): Page number, from 1; stop when has_more is false
- skip_default_reviews (optional; boolean; default true): true (default) skips default positive reviews without text (those with a follow-up stay); false returns every review
Example request: curl -G "https://api.qovia.ai/v1/raw/taobao/comments?item_id=611261922146" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"eco_tao_e35d27d45024","cid":"1316054905552","text":"其实线上买药很方便也很优惠很好，","rating_level":"good","likes":0,"created_at":"2026-10-03T21:27:00+08:00","sku":"套餐类型:1盒装[基础体验【欧洲原研进口】]","user_name":"刘***7","user_level":0,"anonymous":true,"images":["https://img.alicdn.com/imgextra/i4/4611686018427385600/O1CN01bZPUiKO6BBJ1SdaC_!!4611686018427385600-0-rate.jpg_400x400.jpg"],"videos":[],"shop_reply":null,"followup":{"text":"相信","days_after_receipt":16,"images":["https://img.alicdn.com/imgextra/i1/4611686018427385600/O1CN01L74IopdbT1I1SdaC_!!4611686018427385600-0-rate.jpg_400x400.jpg"],"videos":[],"shop_reply":"感谢您的认可，也谢谢您的晒图和追评。能让您买药更方便、享受到实惠，我们很高兴。…"}},{"id":"eco_tao_9b5c72573494","cid":"1316866273768","text":"我觉得性价比一般，有点贵。效果还可以","rating_level":"good","likes":0,"created_at":"2026-10-14T21:08:00+08:00","sku":"套餐类型:1盒装[基础体验【欧洲原研进口】]","user_name":"欣***笑","user_level":0,"anonymous":false,"images":["https://img.alicdn.com/imgextra/i3/4611686018427380977/O1CN01mo211OzAnAF2BxNI_!!4611686018427380977-0-rate.jpg_400x400.jpg"],"videos":[],"shop_reply":null,"followup":null}],"page":1,"has_more":true,"total":400,"total_exact":false,"prov":{"hash":"0x7b921e36e8cf1b4c","ts":"2026-10-21T19:59:04+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

## JD.com

### GET /v1/raw/jd/comments — JD.com product reviews

ID: raw.jd.comments. Docs: https://qovia.ai/docs/api-reference/raw.jd.comments/
Buyer reviews of a JD.com product, newest first, 10 per page: text and time, 1-5 star rating, variant and SKU ID, the buyer's nickname (mostly masked by JD), anonymity, IP location, full-size photos, helpful votes and the shop's reply. By default only this SKU's reviews; with only_this_sku false, every variant of the product. max_page tells how far paging goes (often far fewer pages than the review total); stop when has_more is false. A SKU without reviews, or one that does not exist, answers empty and is not charged.
Price: $0.019500 per successful call. Status: live.
Parameters:
- sku_id (required; string): JD.com SKU ID (the number in item.jd.com/<SKU>.html)
- page (optional; integer; default 1; min 1; max 100): Page number, from 1, up to the max_page of the previous answer; stop when has_more is false
- only_this_sku (optional; boolean; default true): true (default) returns this SKU's reviews only; false returns the reviews of every variant (colour, size, ...) of the product
Example request: curl -G "https://api.qovia.ai/v1/raw/jd/comments?sku_id=100006271091" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"eco_jd_43a365a0aaef","cid":"106314560218561793","text":"还可以吧，唯一的缺点就是颗粒太大了，吞咽的时候有点不舒服","rating":5,"likes":0,"created_at":"2026-10-20T19:45:27+08:00","sku":"规格:【60片*1盒】院线同款-60天用量","sku_id":"100006271091","user_name":"j***i","anonymous":false,"ip_location":"广东","images":[],"shop_reply":"非常感谢您的反馈！我们注意到您对颗粒大小的反馈，这可能给您带来了些许不适。我们会努力改进产品。…"},{"id":"eco_jd_001042af4786","cid":"106191920223780233","text":"一直喝的这个，每天一个，挺好的，一家人都在喝。","rating":5,"likes":0,"created_at":"2026-10-18T18:55:50+08:00","sku":"规格:【60片*1盒】院线同款-60天用量","sku_id":"100006271091","user_name":"赵***g","anonymous":false,"ip_location":"河北","images":["https://img30.360buyimg.com/shaidan/jfs/t1/549256/12/1897/1368430/6ad4a5b5Fc881e4a1/00a9c00000e872a7.jpg"],"shop_reply":"嘿，看到您一直钟爱我们的善存多维元素片，真是倍感荣幸！…"}],"page":1,"has_more":true,"max_page":2,"total":20000,"prov":{"hash":"0x494e4995216cc2cc","ts":"2026-10-21T20:03:12+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

## Fliggy

### GET /v1/raw/fliggy/hotel — Fliggy hotel rating

ID: raw.fliggy.hotel. Docs: https://qovia.ai/docs/api-reference/raw.fliggy.hotel/
Rating summary of a Fliggy hotel: overall score (10-point scale), review counts (total, good, bad, with photos), sub-scores (location, cleanliness, service, facilities), 1–5 star distribution and top review tags. Hotel name not included. An unknown or not-yet-rated hotel returns an empty, unbilled result.
Price: $0.001500 per successful call. Status: live.
Parameters:
- hotel_id (required; string): Fliggy hotel ID (shid, 5–15 digits), e.g. 10052156
Example request: curl -G "https://api.qovia.ai/v1/raw/fliggy/hotel?hotel_id=10052156" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"eco_fli_5c1e0a9b7f42","src":"ecommerce","platform":"fliggy","lang":"zh-CN","metrics":{"rating":9,"reviews":3277,"good_reviews":2779,"bad_reviews":143,"photo_reviews":50},"dimensions":[{"name":"位置便利","score":9.2,"count":2929},{"name":"清洁程度","score":9,"count":2929},{"name":"服务态度","score":9.2,"count":2929},{"name":"设施体验","score":8.8,"count":2929}],"distribution":[{"stars":5,"label":"非常棒","count":2319},{"stars":4,"label":"值得赞","count":756},{"stars":3,"label":"一般般","count":127},{"stars":2,"label":"有些差","count":31},{"stars":1,"label":"糟透了","count":38}],"tags":[{"name":"近机场","count":212,"positive":true},{"name":"服务热心","count":182,"positive":true},{"name":"性价比高","count":103,"positive":true}],"extra":{"source_id":"10052156","rating_scale":10,"rating_label":"好"},"prov":{"hash":"0x3b9f2c07d41e8a65","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/fliggy/reviews — Fliggy hotel reviews

ID: raw.fliggy.reviews. Docs: https://qovia.ai/docs/api-reference/raw.fliggy.reviews/
Guest reviews of a Fliggy hotel, newest first, up to 100 per page, paginated with cursor. Each review has its score (10-point scale), text, time, reviewer nickname and id (also for anonymous reviews that carry one), IP region, check-in month, room type, trip type, sub-scores, photos and the hotel's reply. A page past the end or an unknown hotel returns an empty, unbilled list.
Price: $0.001500 per successful call. Status: live.
Parameters:
- hotel_id (required; string): Fliggy hotel ID (shid, 5–15 digits), e.g. 10052156
- cursor (optional; integer; default 1; min 1; max 200): Page number, from 1
Example request: curl -G "https://api.qovia.ai/v1/raw/fliggy/reviews?hotel_id=10052156" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"rid":"524657647","rating":10,"text":"环境好，服务周到，最主要价格也实惠，推荐入住","created_at":"2026-10-20T11:32:04+08:00","author":{"name":"青山依旧1410276752","uid":"3350595353","anonymous":false},"metrics":{"likes":0,"replies":0},"extra":{"ip_location":"宁夏","check_in":"2026-09-27","room_type":"标准双床房","trip_type":["商务出行"],"dimensions":[{"name":"位置便利","score":10},{"name":"清洁程度","score":10},{"name":"服务态度","score":10},{"name":"设施体验","score":10}],"photos":[],"videos":[],"merchant_reply":null,"origin":null}},{"rid":"488818437","rating":10,"text":"房间干净，空间也很大","created_at":"2026-04-01T13:54:13+08:00","author":{"name":"匿名用户","uid":"2261334455","anonymous":true},"metrics":{"likes":0,"replies":1},"extra":{"ip_location":"浙江","check_in":"2026-03-30","room_type":"青蒲大床房","trip_type":[],"dimensions":[{"name":"位置便利","score":10}],"photos":[],"videos":[],"merchant_reply":{"text":"亲爱的客人，非常感谢您的肯定！…","created_at":"2026-04-01T14:52:00+08:00"},"origin":null}}],"cursor":2,"has_more":true}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

## Cili Juxing

### GET /v1/raw/cljx/star_search — Cljx creator search

ID: raw.cljx.star_search. Docs: https://qovia.ai/docs/api-reference/raw.cljx.star_search/
Search Kuaishou creators on the Cljx (磁力聚星) marketplace by name keyword, content category and sort order. Returns followers, expected plays, expected CPM, engagement and completion rates and quotes in CNY. Paged, up to 50 per page.
Price: $0.001500 per successful call. Status: live.
Parameters:
- keyword (optional; string; min length 1; max length 50): Creator nickname keyword; leave out to browse by category and sort
- tag_id (optional; string): Top-level content category ID, such as 673 food, 677 lifestyle, 695 comedy
- sub_ids (optional; string): Second-level category IDs, comma-separated; needs tag_id
- sort_by (optional; integer; one of 3, 1, 2, 20, 21, 22, 23, 24, 25, 26, 27, 42; default 3): Sort field: 3 default, 2 followers, 20 expected plays, 21 expected CPM, 22 engagement rate, 23 completion rate, 24 follower gain, 25 follower growth rate, 42 deeply connected users, 1 price; live creators also have 26 expected viewers, 27 peak concurrent viewers
- sort_order (optional; integer; one of 0, 1, 2; default 0): Sort direction: 1 ascending, 2 descending; must be 0 when sort_by is 3 (default order), and 1 or 2 for any other sort_by
- star_type (optional; integer; one of 1, 4; default 1): 1 short-video creators, 4 live-stream creators
- page (optional; integer; default 1; min 1; max 50): Page number; the response's cursor is the next page
- page_size (optional; integer; default 20; min 1; max 50): Items per page
Example request: curl -G "https://api.qovia.ai/v1/raw/cljx/star_search?keyword=%E7%BE%8E%E9%A3%9F" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_clj_88eb28227df2","star_id":"2132268","user_id":"2613731401","uid_hash":"fdcfe7f3850d","name":"美食","gender":"男","avatar":"https://p1-ad.adukwai.com/uhead/AB/2026/01/14/13/BMjAyNjAxMTQxMz…","followers":245327,"kwai_id":"LG15877565014","follower_growth":2000,"follower_growth_rate":0.0082,"content_tags":["三农"],"mcn":null,"expected_play":7859,"expected_cpm":127,"interaction_rate":0,"completion_rate":0,"prices":[{"type":"直播按小时","price_cny":1000},{"type":"直播按天","price_cny":6000}],"live_price_cny":1000,"live":{"expected_viewers":23331,"max_viewers":5091,"expected_cpm":43,"interaction_rate":2.5528},"prov":{"hash":"0x8204dadd692da227","ts":"2026-10-20T12:00:00+08:00","source":"live"}},{"id":"soc_clj_55e6c9ee38bc","star_id":"2952902","user_id":"3212801650","uid_hash":"008324ac2aba","name":"美食","gender":"女","avatar":"https://p1-ad.adukwai.com/uhead/AB/2026/09/14/21/BMjAyNjA5MTQyMT…","followers":23091,"kwai_id":null,"follower_growth":99,"follower_growth_rate":0.0043,"content_tags":["美食"],"mcn":null,"expected_play":51,"expected_cpm":19608,"interaction_rate":0.00431,"completion_rate":0.45354,"prices":[{"type":"直播按小时","price_cny":1000},{"type":"直播按天","price_cny":3500}],"live_price_cny":1000,"live":null,"prov":{"hash":"0x76677a1e123c5689","ts":"2026-10-20T12:00:00+08:00","source":"live"}}],"cursor":2,"has_more":true,"total":1000}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/cljx/hot_stars — Cljx creator charts

ID: raw.cljx.hot_stars. Docs: https://qovia.ai/docs/api-reference/raw.cljx.hot_stars/
Cljx's official creator charts (reach, rising stars, value for money, top picks; live-commerce and popular streamers) in chart order, with rank changes, platform indices and quotes. One whole chart per call, no paging.
Price: $0.001500 per successful call. Status: live.
Parameters:
- board (optional; integer; one of 105, 104, 5, 106, 7, 8; default 105): Chart: 105 reach, 104 rising stars, 5 value for money, 106 top picks (short-video creators); 7 sales power, 8 popular hosts (live-stream creators, needs star_type=4)
- star_type (optional; integer; one of 1, 4; default 1): 1 short-video creators, 4 live-stream creators (charts 7 and 8)
- tag_id (optional; integer; min 1; max 9999): Top-level content category ID, such as 670 beauty; leave out for all
Example request: curl -G "https://api.qovia.ai/v1/raw/cljx/hot_stars" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"board":{"id":105,"name":"传播力表现榜","description":"根据达人近期传播力指数进行排序，通过个人作品数、个人作品完播率、个人作品播放量中位数、个人作品互动率等维度对达人进行综合评估和筛选","generated_at":"2026-10-19T10:00:00+08:00"},"items":[{"rank":1,"id":"soc_clj_688e219ccd50","star_id":"8646245","user_id":"5188613547","uid_hash":"8d7793c6d107","name":"相约在冬季","gender":"女","avatar":"https://p1-ad.adukwai.com/uhead/AB/2026/08/22/20/BMjAyNjA4MjIyMD…","followers":100133,"rank_change":{"direction":"same","by":0},"times_on_board":61,"follower_growth":52191,"content_tags":["生活"],"indices":{"star":89.9,"spreading":94.2,"develop":98.6,"cost_effective":76.4},"scores":{"spread":81.6,"conversion":0,"cost_effective":70.6,"fan_growth":83.4,"sell_goods":0,"popularity":0},"expected_play":9440,"expected_cpm":106,"play_median":617171,"completion_rate":0.53788,"interaction_rate":0.10587,"prices":[{"type":"1-20秒视频","price_cny":null},{"type":"21-60秒视频","price_cny":1000}],"live_price_cny":1000,"live":{"expected_viewers":1247,"max_viewers":221,"expected_cpm":802,"interaction_rate":0.3311},"prov":{"hash":"0xb52daa318c2610d2","ts":"2026-10-20T12:00:00+08:00","source":"live"}},{"rank":2,"id":"soc_clj_d4ecd1ee0a99","star_id":"4857086","user_id":"1660852705","uid_hash":"30b6e30e4ea8","name":"秦观南：长命百岁","gender":"女","avatar":"https://p1-ad.adukwai.com/uhead/AB/2024/05/30/12/BMjAyNDA1MzAxMj…","followers":1223469,"rank_change":{"direction":"same","by":0},"times_on_board":109,"follower_growth":234320,"content_tags":["二次元"],"indices":{"star":89.2,"spreading":93.6,"develop":97.2,"cost_effective":82},"scores":{"spread":85.8,"conversion":0,"cost_effective":82.9,"fan_growth":84.9,"sell_goods":0,"popularity":0},"expected_play":188432,"expected_cpm":53,"play_median":1220345,"completion_rate":0.37012,"interaction_rate":0.12684,"prices":[{"type":"1-20秒视频","price_cny":8000},{"type":"21-60秒视频","price_cny":10000}],"live_price_cny":1000,"live":null,"prov":{"hash":"0xcd99380a9f019ed9","ts":"2026-10-20T12:00:00+08:00","source":"live"}}],"cursor":null,"has_more":false,"total":5}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/cljx/star_profile — Cljx creator profile

ID: raw.cljx.star_profile. Docs: https://qovia.ai/docs/api-reference/raw.cljx.star_profile/
Creator overview: profile, content tags, 30/90-day follower growth, quotes per video length, expected plays and CPE, chart rank, audience tags and brand-deal record.
Price: $0.001500 per successful call. Status: live.
Parameters:
- star_id (required; string): Cili Juxing creator ID (starId)
- star_type (optional; integer; one of 1, 4; default 1): 1 short-video creators, 4 live-stream creators
Example request: curl -G "https://api.qovia.ai/v1/raw/cljx/star_profile?star_id=4857086" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_clj_d4ecd1ee0a99","star_id":"4857086","user_id":"1660852705","uid_hash":"30b6e30e4ea8","name":"秦观南：长命百岁","gender":"女","avatar":"https://p4-ad.adukwai.com/uhead/AB/2024/05/30/12/BMjAyNDA1MzAxMj…","followers":1222796,"kwai_id":null,"profile_url":"https://www.kuaishou.com/profile/3x4xjp26vizwic6","bio":null,"region":"浙江-宁波","verified":null,"identity":"小麦优质","follower_growth":{"d30":234320,"d90":328860},"follower_growth_rate":{"d30":0.2369,"d90":0.3676},"content_tags":{"first":"二次元","second":"二次元真人秀"},"content_forms":[],"industry_tags":[],"prices":[{"type":"1-20秒视频","price_cny":8000},{"type":"21-60秒视频","price_cny":10000}],"live_price_cny":null,"expected_play":188432,"expected_cpe":0,"interaction_rate":0,"weekly_posts":4,"live":null,"hot_rank":{"board":"传播力表现榜","rank":2},"audience_tags":{"feature":["女性观众为主，占比71.8%","18-23岁为主，占比30.1%"],"device":["安卓设备为主，占比78.2%","设备价格在1000-2000的观众居多，占比48.2%"],"area":["三线城市观众居多，占比30.4%","河南、广东、河北的观众居多"]},"orders":{"accept_rate":1,"complete_rate":0.5,"completed":1,"advertiser_industries":["社交通讯"]},"contact":null,"prov":{"hash":"0x30f7ba145e64cd66","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/cljx/star_base — Cljx creator basics

ID: raw.cljx.star_base. Docs: https://qovia.ai/docs/api-reference/raw.cljx.star_base/
Creator basics: name, bio, region, followers and growth, MCN, content tags, industries worked with, quotes, credit score and activity flags. Lighter than star_profile and includes the MCN.
Price: $0.001500 per successful call. Status: live.
Parameters:
- star_id (required; string): Cili Juxing creator ID (starId)
- star_type (optional; integer; one of 1, 4; default 1): 1 short-video creators, 4 live-stream creators
Example request: curl -G "https://api.qovia.ai/v1/raw/cljx/star_base?star_id=8646245" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_clj_688e219ccd50","star_id":"8646245","user_id":"5188613547","uid_hash":"8d7793c6d107","name":"相约在冬季","gender":"女","avatar":"https://p1-ad.adukwai.com/uhead/AB/2026/08/22/20/BMjAyNjA4MjIyMD…","followers":100133,"profile_url":"https://www.kuaishou.com/profile/3xgscnx7wrpfavq","bio":"喜欢每个粉丝宝宝\n感谢快手官方给予推流\n卡15回\n不活跃不回","region":null,"follower_growth_rate":1.0485,"mcn":null,"content_tags":{"first":"情感","second":"情感（其他）"},"content_forms":[],"identity":"潜力达人","industries":[{"name":"工具软件","share":1}],"prices":[{"type":"1-20秒视频","price_cny":null},{"type":"21-60秒视频","price_cny":1000}],"credit_score":null,"active":true,"live_active":true,"prov":{"hash":"0x0fe46a5321c08248","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/cljx/star_index — Cljx creator indices

ID: raw.cljx.star_index. Docs: https://qovia.ai/docs/api-reference/raw.cljx.star_index/
The platform's six creator indices (overall, growth, reach, appeal, commercial, value for money) with score, peer average, percentile and rank, plus the underlying growth, median plays, completion, engagement and CPM metrics. Takes the Kuaishou user id, not the star id.
Price: $0.001500 per successful call. Status: live.
Parameters:
- user_id (required; string): Kuaishou user ID (userId; the user_id in star_search results)
- star_type (optional; integer; one of 1, 4; default 1): 1 short-video creators, 4 live-stream creators
Example request: curl -G "https://api.qovia.ai/v1/raw/cljx/star_index?user_id=5188613547" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_clj_db4c5b56284d","user_id":"5188613547","uid_hash":"8d7793c6d107","star_type":1,"updated_at":"2026-10-16","active_within_3_days":false,"indices":{"star":{"value":89.88,"avg":null,"percentile":1,"rank":3},"develop":{"value":98.6,"avg":68.23,"percentile":1,"rank":6},"spreading":{"value":94.2,"avg":65.76,"percentile":1,"rank":1},"appeal":{"value":97,"avg":69.85,"percentile":1,"rank":2},"business":{"value":81,"avg":60.59,"percentile":0.99,"rank":112},"cost_effective":{"value":76.42,"avg":73.9,"percentile":0.59,"rank":3358}},"metrics":{"follower_growth":52191,"follower_growth_rate":1.0485,"active_fans_ratio_change":0.23,"posts":59,"play_median":617171,"completion_rate":0.53788,"interaction_rate":0.10609,"quality_fans":72444,"active_fans_ratio":0.78,"fans_interaction_rate":0.26,"cooperation_index":90,"completed_orders":3,"commercial_posts":3,"commercial_play_median":12176,"commercial_completion_rate":0.11465,"commercial_interaction_rate":0.0086,"expected_cpm":106,"cpc":0,"cpe":136.957},"prov":{"hash":"0x39dca6b60ae21132","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/cljx/star_audience — Cljx creator audience

ID: raw.cljx.star_audience. Docs: https://qovia.ai/docs/api-reference/raw.cljx.star_audience/
Follower and viewer profiles: gender, age, activity, province, city, city tier, phone brand and price, interests and audience groups, each with share (fraction) and TGI.
Price: $0.001500 per successful call. Status: live.
Parameters:
- star_id (required; string): Cili Juxing creator ID (starId)
- star_type (optional; integer; one of 1, 4; default 1): 1 short-video creators, 4 live-stream creators
Example request: curl -G "https://api.qovia.ai/v1/raw/cljx/star_audience?star_id=8646245" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_clj_5c38dacb3c03","star_id":"8646245","star_type":1,"fans":{"gender":[{"label":"男性","share":0.313758,"tgi":53},{"label":"女性","share":0.686242,"tgi":164}],"age":[{"label":"18-23","share":0.29023,"tgi":178},{"label":"24-30","share":0.214588,"tgi":136}],"activity":[{"label":"超高活","share":0.402549,"tgi":153},{"label":"高活","share":0.342346,"tgi":131}],"province":[{"label":"河南","share":0.12502,"tgi":201},{"label":"山东","share":0.096168,"tgi":133}],"city":[{"label":"重庆","share":0.020197,"tgi":117},{"label":"保定","share":0.015578,"tgi":178}],"city_tier":[{"label":"firstline","share":0.0174662,"tgi":31},{"label":"newfirstline","share":0.103149,"tgi":75}],"device_brand":[{"label":"华为","share":0.2824,"tgi":104},{"label":"vivo","share":0.205984,"tgi":106}],"device_price":[{"label":"1000以内","share":0.039243,"tgi":116},{"label":"1000-2000","share":0.469507,"tgi":116}],"interests":[{"label":"游戏直播","share":0.741155,"tgi":199},{"label":"商品售卖及推荐","share":0.667001,"tgi":92}],"groups":[{"label":"小镇青年","share":0.303898,"tgi":183},{"label":"小镇中年","share":0.217227,"tgi":122}]},"viewers":{"gender":[{"label":"男性","share":0.407986,"tgi":71},{"label":"女性","share":0.592014,"tgi":137}],"age":[{"label":"18-23","share":0.372717,"tgi":280},{"label":"24-30","share":0.184057,"tgi":153}],"activity":[{"label":"超高活","share":0.463711,"tgi":192},{"label":"高活","share":0.288226,"tgi":113}],"province":[{"label":"河南","share":0.111206,"tgi":167},{"label":"广东","share":0.094889,"tgi":112}],"city":[{"label":"重庆","share":0.019883,"tgi":110},{"label":"邯郸","share":0.012884,"tgi":147}],"city_tier":[{"label":"firstline","share":0.0189411,"tgi":40},{"label":"newfirstline","share":0.093515,"tgi":74}],"device_brand":[{"label":"华为","share":0.223885,"tgi":79},{"label":"vivo","share":0.196913,"tgi":100}],"device_price":[{"label":"1000以内","share":0.0347596,"tgi":93},{"label":"1000-2000","share":0.425606,"tgi":98}],"interests":[],"groups":[{"label":"小镇青年","share":0.324198,"tgi":202},{"label":"小镇中年","share":0.186774,"tgi":102}]},"prov":{"hash":"0x305fbc16d183df15","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/cljx/star_works — Cljx creator content performance

ID: raw.cljx.star_works. Docs: https://qovia.ai/docs/api-reference/raw.cljx.star_works/
Content performance: recent personal and sponsored videos (plays, likes, comments, shares) and the 30/90-day organic and sponsored median plays, completion, engagement, average interactions and expected CPM.
Price: $0.001500 per successful call. Status: live.
Parameters:
- star_id (required; string): Cili Juxing creator ID (starId)
- star_type (optional; integer; one of 1, 4; default 1): 1 short-video creators, 4 live-stream creators
Example request: curl -G "https://api.qovia.ai/v1/raw/cljx/star_works?star_id=8646245" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_clj_f2fc57c18eb6","star_id":"8646245","star_type":1,"personal_works":[{"id":"soc_kua_970a2743c002","src":"social","platform":"kuaishou","lang":"zh-CN","text":"#男神","author":{"star_id":"8646245","user_id":"5188613547","uid_hash":"8d7793c6d107"},"metrics":{"plays":49,"likes":17,"comments":8,"shares":2},"extra":{"source_id":"212820520216","url":"https://video.kuaishou.com/short-video/3xmtjjhbshc3cwk","cover":"https://p5-ad.adukwai.com/upic/2026/10/20/12/BMjAyNjEwMjAxMjAwNT…","published_at":"2026-10-20T12:01:06+08:00","is_commercial":false}}],"ad_works":[{"id":"soc_kua_3ec1bfb5f626","src":"social","platform":"kuaishou","lang":"zh-CN","text":"又被制裁了 #心动日常","author":{"star_id":"8646245","user_id":"5188613547","uid_hash":"8d7793c6d107"},"metrics":{"plays":1137138,"likes":4615,"comments":322,"shares":1574},"extra":{"source_id":"209799404938","url":"https://video.kuaishou.com/short-video/3xwv7ckey6jpzb2","cover":"https://p5-ad.adukwai.com/upic/2026/09/23/17/BMjAyNjA5MjMxNzAxMT…","published_at":"2026-09-23T17:01:30+08:00","is_commercial":true,"industry":"传媒资讯-工具类软件"}}],"report":{"expected_play":9440,"expected_cpm":106,"weekly_posts":25,"organic":{"d30":{"posts":59,"play_median":617171,"completion_rate":0.53788,"interaction_rate":0.10609,"avg_duration_s":6.2392,"avg_likes":43331,"avg_comments":1509,"avg_shares":20695},"d90":{"posts":143,"play_median":554021,"completion_rate":0.55696,"interaction_rate":0.09493,"avg_duration_s":7.67801,"avg_likes":33230,"avg_comments":1270,"avg_shares":16488}},"commercial":{"d30":{"posts":1,"play_median":12176,"completion_rate":0.15514,"interaction_rate":0.02185,"avg_duration_s":8.833,"avg_likes":219,"avg_comments":38,"avg_shares":9,"conversion_click_rate":0.000492773,"cpe":175},"d90":{"posts":3,"play_median":12176,"completion_rate":0.11465,"interaction_rate":0.0086,"avg_duration_s":6.755,"avg_likes":120,"avg_comments":24,"avg_shares":7,"conversion_click_rate":0.00166383,"cpe":136.957}},"live":{"expected_viewers":1247,"max_viewers":221,"expected_cpm":802,"interaction_rate":0.3311,"weekly_sessions":10}},"prices":[{"type":"1-20秒视频","price_cny":null},{"type":"21-60秒视频","price_cny":1000}],"prov":{"hash":"0xf6290e34f30fb78e","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/cljx/star_commerce — Cljx creator commerce

ID: raw.cljx.star_commerce. Docs: https://qovia.ai/docs/api-reference/raw.cljx.star_commerce/
Video commerce: 30/90-day selling videos, orders, GMV, GPM, average order value, product impressions, visits and conversion (CNY), plus the selling videos and their products. Creators without commerce data return an empty, unbilled result.
Price: $0.001500 per successful call. Status: live.
Parameters:
- star_id (required; string): Cili Juxing creator ID (starId)
Example request: curl -G "https://api.qovia.ai/v1/raw/cljx/star_commerce?star_id=34907" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_clj_dc33a51b592b","star_id":"34907","user_id":"896519214","uid_hash":"81531bce9b52","d30":{"videos":5,"orders":2,"gmv_cny":12998,"gpm_cny":14.71,"avg_order_value_cny":6499,"product_impressions":133233,"product_visits":7839,"conversion_rate":0.0003},"d90":null,"videos":[{"id":"soc_kua_4d0bb6927e8b","src":"social","platform":"kuaishou","lang":"zh-CN","text":"本月见 #K100 #新品  #手机 #数码好物","author":{"star_id":"34907","user_id":"896519214","uid_hash":"81531bce9b52"},"metrics":{"plays":1420,"likes":6},"extra":{"source_id":"212712450033","url":"https://video.kuaishou.com/short-video/3xac6r7swgtyt92","cover":"https://p5-ad.adukwai.com/upic/2026/10/19/10/BMjAyNjEwMTkxMDUyMj…","published_at":"2026-10-19T10:55:20+08:00","gmv_cny":0,"products":[{"item_id":"27091750631214","title":"【预约发布会】新品手机 REDMI K100 双芯魔王 万级续航","cover":"https://p1-ec.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-…","price_cny":9999,"sales":0}]}}],"prov":{"hash":"0x6d0e386c50cfa11c","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/cljx/star_top_works — Cljx creator top videos

ID: raw.cljx.star_top_works. Docs: https://qovia.ai/docs/api-reference/raw.cljx.star_top_works/
The creator's representative videos with plays, likes, comments, shares, sponsored flag and hit markers; optionally organic traffic only.
Price: $0.001500 per successful call. Status: live.
Parameters:
- star_id (required; string): Cili Juxing creator ID (starId)
- organic_only (optional; boolean; default false): When true, count organic traffic only (paid promotion excluded)
Example request: curl -G "https://api.qovia.ai/v1/raw/cljx/star_top_works?star_id=8646245" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_kua_61d41495a80c","src":"social","platform":"kuaishou","lang":"zh-CN","text":"大家都选离自己近的人 那我怎么办 我离所有人都那么远","author":{"star_id":"8646245"},"metrics":{"plays":6162,"likes":717,"comments":66,"shares":87},"extra":{"source_id":"212771344098","url":"https://video.kuaishou.com/short-video/3x5gmpazuau365g","cover":"https://p5-ad.adukwai.com/upic/2026/10/19/21/BMjAyNjEwMTkyMTAzNT…","published_at":"2026-10-19T21:04:10+08:00","is_commercial":false,"contains_paid":false,"hot":{"quality":false,"quantity":false,"quality_and_quantity":false}},"prov":{"hash":"0xdff8cb646ab5302e","ts":"2026-10-20T12:00:00+08:00","source":"live"}},{"id":"soc_kua_bc3054193d2a","src":"social","platform":"kuaishou","lang":"zh-CN","text":"好无力啊 唉","author":{"star_id":"8646245"},"metrics":{"plays":30405,"likes":2016,"comments":135,"shares":661},"extra":{"source_id":"212754908623","url":"https://video.kuaishou.com/short-video/3xbmhxitcbfyqki","cover":"https://p5-ad.adukwai.com/upic/2026/10/19/18/BMjAyNjEwMTkxODMzNT…","published_at":"2026-10-19T18:34:07+08:00","is_commercial":false,"contains_paid":false,"hot":{"quality":false,"quantity":false,"quality_and_quantity":false}},"prov":{"hash":"0x1362448d9e50adbe","ts":"2026-10-20T12:00:00+08:00","source":"live"}}],"cursor":null,"has_more":false}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/cljx/star_stats — Cljx creator video stats

ID: raw.cljx.star_stats. Docs: https://qovia.ai/docs/api-reference/raw.cljx.star_stats/
30- or 90-day organic and sponsored video stats: posts, average duration, average likes, comments and shares, median plays, completion and engagement; sponsored adds CPM, CPE and expected CPM with change, plus visitor counts.
Price: $0.001500 per successful call. Status: live.
Parameters:
- star_id (required; string): Cili Juxing creator ID (starId)
- organic_only (optional; boolean; default false): When true, count organic traffic only (paid promotion excluded)
- window_days (optional; integer; one of 30, 90; default 30): Period in days
- traffic_days (optional; integer; one of 7, 15, 30; default 7): Traffic period in days
Example request: curl -G "https://api.qovia.ai/v1/raw/cljx/star_stats?star_id=8646245" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_clj_df54213a12f5","star_id":"8646245","window_days":30,"traffic_days":7,"organic_only":false,"organic":{"posts":59,"avg_duration_s":6.2392,"avg_likes":43331,"avg_comments":1509,"avg_shares":20695,"play_median":617171,"completion_rate":0.53788,"interaction_rate":0.10609},"commercial":{"posts":1,"avg_duration_s":8.833,"avg_likes":219,"avg_comments":38,"avg_shares":9,"play_median":12176,"completion_rate":0.15514,"interaction_rate":0.02185,"conversion_click_rate":0.000492773,"cpm":86.2352,"cpe":175,"expected_cpm":106,"expected_cpm_change":-0.51,"expected_play":9440,"expected_play_change":1.0495},"visitors":12639216,"deep_visitors":2017322,"prov":{"hash":"0xc0bbe739c7adccd7","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/cljx/star_orders — Cljx creator brand deals

ID: raw.cljx.star_orders. Docs: https://qovia.ai/docs/api-reference/raw.cljx.star_orders/
30- or 90-day brand-deal record: acceptance and completion rates, completed orders and the industries worked with by orders and by views. Creators with no deals return an empty, unbilled result.
Price: $0.001500 per successful call. Status: live.
Parameters:
- star_id (required; string): Cili Juxing creator ID (starId)
- window_days (optional; integer; one of 30, 90; default 30): Period in days
Example request: curl -G "https://api.qovia.ai/v1/raw/cljx/star_orders?star_id=8646245" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_clj_0ae09bc72acd","star_id":"8646245","window_days":30,"accept_rate":1,"complete_rate":1,"completed_orders":1,"industries_by_orders":[{"industry":"工具类软件","share":1}],"industries_by_views":[{"industry":"工具类软件","share":1}],"prov":{"hash":"0x1754294fe1627499","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/cljx/star_fans_trend — Cljx creator follower trend

ID: raw.cljx.star_fans_trend. Docs: https://qovia.ai/docs/api-reference/raw.cljx.star_fans_trend/
30- or 90-day follower growth and growth rate, with daily follower counts and daily net change.
Price: $0.001500 per successful call. Status: live.
Parameters:
- star_id (required; string): Cili Juxing creator ID (starId)
- window_days (optional; integer; one of 30, 90; default 30): Period in days
Example request: curl -G "https://api.qovia.ai/v1/raw/cljx/star_fans_trend?star_id=8646245" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_clj_753fcb77f1a7","star_id":"8646245","window_days":30,"follower_growth":52191,"follower_growth_rate":1.0485,"followers_by_day":[{"date":"2026-09-20","followers":49777},{"date":"2026-09-21","followers":50898}],"growth_by_day":[{"date":"2026-09-21","delta":1121},{"date":"2026-09-22","delta":1519}],"prov":{"hash":"0x0eda42564b592dc5","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

## Huahuo

### GET /v1/raw/huahuo/creator_search — Huahuo creator search

ID: raw.huahuo.creator_search. Docs: https://qovia.ai/docs/api-reference/raw.huahuo.creator_search/
Search Bilibili creators on the Huahuo (花火) marketplace by nickname or mid. Returns followers and growth, average and median plays, engagement, 30/90/180-day upload counts, quotes per deal type (CNY), CPM/CPC and MCN. Up to 20 results, no paging.
Price: $0.001500 per successful call. Status: live.
Parameters:
- keyword (required; string; min length 1; max length 50): Bilibili creator nickname or mid
Example request: curl -G "https://api.qovia.ai/v1/raw/huahuo/creator_search?keyword=%E8%80%81%E7%95%AA%E8%8C%84" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_hua_8ac527ee462a","mid":"546195","uid_hash":"fff53ab53fc7","nickname":"老番茄","avatar":"https://i0.hdslb.com/bfs/face/bc5ca101313d4db223c395d64779e76eb3…","gender":"男","region":{"province":"上海","city":"上海"},"partition":{"name":"游戏","sub":"单机游戏"},"followers":20853367,"follower_growth":67435,"follower_growth_rate_pct":0.3,"avg_plays":4859047,"play_median":3784176,"interaction_rate":0.0799,"videos":{"d30":4,"d90":11,"d180":25},"hot_video_rate":1,"commercial_videos":107,"prices":[{"type":"定制视频","price_cny":723300,"discount_price_cny":723300},{"type":"植入视频","price_cny":592900,"discount_price_cny":592900}],"cpm":157.98,"cpc":141.56,"cpe":null,"tags":["游戏实况"],"cooperation_modes":["线下探查拍摄","小剧场"],"score":77.5,"magnetic_level":7,"traffic_split":{"pc":0.075,"app":0.5492},"live":{"level":40,"avg_hourly_viewers_30d":73217},"mcn":{"id":"331257408","name":"上海超电文化传播有限公司"},"prov":{"hash":"0x29ac38ac36c40272","ts":"2026-10-20T12:00:00+08:00","source":"live"}},{"id":"soc_hua_7d2f49a0865c","mid":"1792835265","uid_hash":"1baac66c8a6c","nickname":"一只千年老番茄","avatar":"https://i0.hdslb.com/bfs/face/d4dc1847ed7cba4da2c0a0f8da4530adca…","gender":"男","region":{"province":"湖北","city":"武汉"},"partition":{"name":"游戏","sub":"手机游戏"},"followers":31849,"follower_growth":0,"follower_growth_rate_pct":0,"avg_plays":11291,"play_median":10937,"interaction_rate":0.088,"videos":{"d30":1,"d90":1,"d180":5},"hot_video_rate":0,"commercial_videos":0,"prices":[],"cpm":0,"cpc":0,"cpe":null,"tags":["游戏实况"],"cooperation_modes":[],"score":0,"magnetic_level":0,"traffic_split":{"pc":0.0054,"app":0.848},"live":null,"mcn":null,"prov":{"hash":"0x753960722c0800a6","ts":"2026-10-20T12:00:00+08:00","source":"live"}}],"cursor":null,"has_more":false,"total":2}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/huahuo/creator_portrait — Huahuo creator portrait

ID: raw.huahuo.creator_portrait. Docs: https://qovia.ai/docs/api-reference/raw.huahuo.creator_portrait/
Creator portrait: profile and tags, quotes, average plays, likes, comments, saves, danmaku and engagement, PC/app split, follower and viewer profiles (gender, age, device, region, interests), content and duration mix, top videos, MCN and business contacts.
Price: $0.001500 per successful call. Status: live.
Parameters:
- mid (required; string): Bilibili creator mid
- mcn_id (optional; string; default "0"): MCN ID; usually left out
Example request: curl -G "https://api.qovia.ai/v1/raw/huahuo/creator_portrait?mid=5294454" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_hua_69d53ef708c4","mid":"5294454","uid_hash":"064ef3e32322","nickname":"逗比的雀巢","avatar":"https://i0.hdslb.com/bfs/face/e56d8c14d3b74b4e32fbaf2ac4af119328…","gender":"男","region":{"province":"四川","city":"成都"},"partition":{"name":"生活","sub":"搞笑"},"followers":11429893,"bio":"没有ins 商务合作 加微信 NSHOUSE888 某博@逗比的雀大巢  \n编导 剪辑 摄影 有意者联系v zyn_123456231","total_likes":98643676,"videos":152,"tags":["搞笑表演"],"occupation_tags":["摄影师"],"brand_categories":["3C及电器","食品饮料"],"prices":[{"type":"定制视频","price_cny":1200000,"discount_price_cny":1200000},{"type":"深度定制","price_cny":1400000,"discount_price_cny":1400000}],"magnetic_level":7,"updated_at":"2026-10-18","averages":{"plays":14075049,"likes":1011502,"comments":24142,"saves":282479,"danmaku":20570,"interaction_rate":0.112},"play_median_30d":9852535,"cpm":84.66,"traffic_split":{"pc":0.1144,"app":0.741},"fans_profile":{"gender":[{"label":"男","pct":80.91},{"label":"女","pct":19.09}],"age":[{"label":"0~17岁","pct":19.25},{"label":"18~24岁","pct":47.19}],"device":[{"label":"苹果","pct":26.29},{"label":"小米","pct":19.06}],"province":[{"label":"广东","pct":11.75},{"label":"江苏","pct":8.53}],"interest_tags":[{"label":"瓶子君152","score":925},{"label":"纯度","score":900}],"categories":["游戏","动画"],"sub_categories":["单机游戏","手机游戏"]},"audience_profile":{"gender":[{"label":"男","pct":77.32},{"label":"女","pct":22.68}],"age":[{"label":"0~17岁","pct":24.87},{"label":"18~24岁","pct":40.8}],"device":[{"label":"苹果","pct":20.38},{"label":"华为","pct":19.06}],"province":[{"label":"广东","pct":11.65},{"label":"江苏","pct":8.03}],"interest_tags":[{"label":"瓶子君152","score":1075},{"label":"黄金之风","score":800}],"categories":["游戏","动画"],"sub_categories":["单机游戏","手机游戏"]},"fans_vs_visitors":[{"label":"粉丝","pct":33.73},{"label":"游客","pct":66.27}],"content_mix":{"partitions":[{"label":"生活","pct":100}],"durations":[{"label":"5-10min","pct":80},{"label":"3-5min","pct":20}]},"city_tiers":[{"label":"一线","pct":13.63},{"label":"新一线","pct":21.86}],"cooperation_modes":["口播广告","小剧场"],"top_videos":{"by_plays":{"bvid":"BV1rz7569EWw","title":"找到了10年前跪舔b站的视频","cover":"https://i0.hdslb.com/bfs/archive/61b59b6e7ba5d34592401ac162e800e…","duration_s":439,"plays":23839992,"likes":null,"comments":null,"saves":null,"danmaku":null,"interaction_rate":null},"by_interaction":{"bvid":"BV1rz7569EWw","title":"找到了10年前跪舔b站的视频","cover":"https://i0.hdslb.com/bfs/archive/61b59b6e7ba5d34592401ac162e800e…","duration_s":439,"plays":null,"likes":2006497,"comments":28483,"saves":559878,"danmaku":33347,"interaction_rate":0.1587}},"honor":{"bilibili_top100":true,"year":2025},"mcn":{"id":"2140010221","name":"雀立盛熙"},"contact":null,"prov":{"hash":"0xaffbd7166ecfd5be","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/huahuo/fans_trend — Huahuo follower growth

ID: raw.huahuo.fans_trend. Docs: https://qovia.ai/docs/api-reference/raw.huahuo.fans_trend/
Follower growth and growth rate (percent) over 7/30/90/180/365 days, plus daily follower counts for the last `days` days (up to 366).
Price: $0.001500 per successful call. Status: live.
Parameters:
- mid (required; string): Bilibili creator mid
- days (optional; integer; default 90; min 1; max 366): How many recent days of daily follower counts to return
Example request: curl -G "https://api.qovia.ai/v1/raw/huahuo/fans_trend?mid=5294454" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_hua_7b524f58d1bc","mid":"5294454","uid_hash":"064ef3e32322","growth":{"d7":9845,"d30":51860,"d90":313658,"d180":891729,"d365":1594520},"growth_rate_pct":{"d7":0.09,"d30":0.46,"d90":2.82,"d180":8.46,"d365":16.21},"followers_by_day":[{"date":"2025-10-18","followers":9835373},{"date":"2025-10-19","followers":9836929}],"prov":{"hash":"0xc7f1f585d4b54206","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/huahuo/video_highlights — Huahuo video highlights

ID: raw.huahuo.video_highlights. Docs: https://qovia.ai/docs/api-reference/raw.huahuo.video_highlights/
30/90/180-day upload count, hot and viral video counts and rates, high-engagement rate, and whether each beats the peer median. No uploads in the window returns an empty, unbilled result.
Price: $0.001500 per successful call. Status: live.
Parameters:
- mid (required; string): Bilibili creator mid
- day_range (optional; integer; one of 1, 2, 3; default 3): Period: 1 last 30 days, 2 last 90 days, 3 last 180 days
Example request: curl -G "https://api.qovia.ai/v1/raw/huahuo/video_highlights?mid=5294454" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_hua_a7040259a4f2","mid":"5294454","uid_hash":"064ef3e32322","window_days":180,"videos":5,"videos_above_median":false,"hot":{"count":5,"rate":1,"above_median":true},"explode":{"count":5,"rate":1,"above_median":true},"high_interaction":{"rate":0,"above_median":false},"prov":{"hash":"0x378a8eaa30a35a0d","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/huahuo/representative_works — Huahuo representative videos

ID: raw.huahuo.representative_works. Docs: https://qovia.ai/docs/api-reference/raw.huahuo.representative_works/
The creator's representative videos (personal or sponsored) with plays, likes, comments, danmaku, interactions and rate, duration, publish time and sponsor brand.
Price: $0.001500 per successful call. Status: live.
Parameters:
- mid (required; string): Bilibili creator mid
- kind (optional; integer; one of 1, 2; default 1): 1 personal videos, 2 sponsored videos
Example request: curl -G "https://api.qovia.ai/v1/raw/huahuo/representative_works?mid=5294454" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"items":[{"id":"soc_bil_eeed5efddfb3","src":"social","platform":"bilibili","lang":"zh-CN","text":"不该让爷爷看b站的","author":{"uid_hash":"064ef3e32322","mid":"5294454"},"metrics":{"plays":19121289,"likes":1789873,"comments":42957,"danmaku":33507,"interactions":4470975},"extra":{"source_id":"BV1xuPYzcEdo","aid":"116187019222644","url":"https://www.bilibili.com/video/BV1xuPYzcEdo","cover":"https://i1.hdslb.com/bfs/archive/bec46259e40b2044b103c673b4efbca…","published_at":"2026-03-07T16:50:37+08:00","duration_s":506,"interaction_rate_pct":23.38,"kind":"内容稿件"},"prov":{"hash":"0x0daa34a33525d61a","ts":"2026-10-20T12:00:00+08:00","source":"live"}},{"id":"soc_bil_3a9e8272004d","src":"social","platform":"bilibili","lang":"zh-CN","text":"加入了galgame青训营","author":{"uid_hash":"064ef3e32322","mid":"5294454"},"metrics":{"plays":12026831,"likes":910000,"comments":24177,"danmaku":21622,"interactions":2095291},"extra":{"source_id":"BV1qT1jBQEqE","aid":"115473953919185","url":"https://www.bilibili.com/video/BV1qT1jBQEqE","cover":"https://i0.hdslb.com/bfs/archive/de427d89967fdaa6cceb0bfea610b6a…","published_at":"2025-11-01T18:32:38+08:00","duration_s":511,"interaction_rate_pct":17.42,"kind":"内容稿件"},"prov":{"hash":"0x77bf268dc60b8d24","ts":"2026-10-20T12:00:00+08:00","source":"live"}}],"cursor":null,"has_more":false}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.

### GET /v1/raw/huahuo/video_trend — Huahuo video performance

ID: raw.huahuo.video_trend. Docs: https://qovia.ai/docs/api-reference/raw.huahuo.video_trend/
Recent videos on one metric (plays, likes, comments or danmaku): min, max and median, with each video's value and hot, viral, high-engagement and Huahuo-deal flags.
Price: $0.001500 per successful call. Status: live.
Parameters:
- mid (required; string): Bilibili creator mid
- metric (optional; integer; one of 3, 4, 5, 6; default 3): Metric: 3 plays, 4 likes, 5 comments, 6 danmaku
Example request: curl -G "https://api.qovia.ai/v1/raw/huahuo/video_trend?mid=5294454" -H "Authorization: Bearer $QOVIA_KEY"
Example response (the "data" field): {"id":"soc_hua_0c8b094e2970","mid":"5294454","uid_hash":"064ef3e32322","metric":"plays","min":8860994,"max":23839992,"median":12117293,"videos":[{"id":"soc_bil_4875e17197dc","src":"social","platform":"bilibili","lang":"zh-CN","text":"唯一能和她跨年的方式😭","author":{"uid_hash":"064ef3e32322","mid":"5294454"},"metrics":{"plays":11077853},"extra":{"source_id":"BV1K6iMBREnR","aid":"115813138896214","url":"https://www.bilibili.com/video/BV1K6iMBREnR","cover":"https://i2.hdslb.com/bfs/archive/c82fff89cc33db3a3ba591ba8de38d0…","published_at":"2025-12-31T16:08:27+08:00","flags":{"spark":false,"hot":true,"explode":true,"high_interaction":false}}}],"prov":{"hash":"0x35ed7072319a52fb","ts":"2026-10-20T12:00:00+08:00","source":"live"}}
Error codes: scope_denied, endpoint_unavailable, invalid_params, rate_limited, too_many_unbilled, insufficient_balance, upstream_busy, upstream_timeout, upstream_error, upstream_rejected, not_found, reservation_expired.