# Qovia (slim)

> Qovia is a hosted API that returns posts, comments, creator profiles, hot lists and product reviews from Douyin, Xiaohongshu, Weibo, Bilibili, TikTok, YouTube, X and other platforms as one JSON envelope, with a cross-platform search and a remote MCP server.

- Full: https://www.anchorterminal.com/tools/qovia.md (~12,300 tokens) · this version ~3,130 tokens · JSON https://www.anchorterminal.com/tools/qovia.json · canonical https://www.anchorterminal.com/tools/qovia
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · MCP: https://www.anchorterminal.com/mcp · Updated: 2026-11-01 · pricing https://www.anchorterminal.com/tools/qovia#pricing · reviews https://www.anchorterminal.com/tools/qovia#reviews
- Licence: CC BY 4.0, credit Anchor Terminal and link this page (https://www.anchorterminal.com/terms/#data)

**C · 61.2/100 · rank #565 of 1253 · #14 in Web scraping & crawling · not agent-ready · confidence medium**


Assessment: An OpenAPI 3.1 file with 144 operations, one envelope and 20 error codes, per-endpoint prices with failed and empty calls refunded, scoped keys and a four-tool MCP server that keeps the catalogue out of context. No status page, no legal entity, one-paragraph terms and privacy pages, and a product ten days old at the check.

## Facts

- Kind: HTTP API · vendor: Qovia · category: Web scraping & crawling · legal entity: not named · provenance 36/100
- Endpoint: `https://api.qovia.ai` (HTTP, Streamable HTTP)
- Auth: API key · pricing: Pay per use · x402: no · licence: Proprietary hosted service under a one-paragraph Terms of Service summary that defers to a signed agreement. The qovia/qovia-mcp repository (setup guide, examples, Python client) and the qovia package on PyPI are MIT; the service's source is not public
- Probe metrics: not measured yet (probes haven't run)
- Surface listed: The REST API at https://api.qovia.ai and the hosted MCP server at https://api.qovia.ai/mcp, read from the docs, the OpenAPI file, llms.txt and llms-full.txt, the MCP page, the pricing, coverage, changelog, about, contact and legal pages, the qovia/qovia-mcp repository, PyPI, the official MCP registry and the Apify Store on 1 November 2026. No account was created, no API call or MCP session was made and nothing was run; the one GET to /mcp (405) is the 1 November listing check's
- API: OpenAPI 3.1.0, version 0.1.0, 144 paths and 144 operations (143 GET, 1 POST), 321 parameters with 75 enums and patterns on ids, 4 component schemas (SuccessEnvelope, Meta, Error, Account). 137 live data endpoints across 21 platform groups, from 16 on Douyin Xingtu and 12 on Cili Juxing to 1 each on Taobao and JD.com; 6 coming soon (3 Shopee, 2 Amazon, 1 News). Each operation carries `x-qovia-price`, `x-qovia-scope`, `x-qovia-availability` and `x-qovia-status: beta`, with Chinese titles and descriptions beside the English
- Response envelope: `request_id` (the usage record ID, also in `X-Request-Id`), `data` (object, array or null) and `meta` {billed, charged_usd, balance_usd, empty}; `meta.trial_calls_remaining` counts down on trial accounts. Posts, notes and videos share one record shape (`id`, `src`, `platform`, `text`, `author`, `metrics`, `extra`, `prov` {hash, ts, source}). Headers `X-Qovia-Charged` and `X-Qovia-Balance` repeat the charge
- Credentials: API key `sk-qovia-` plus 43 characters, in `Authorization: Bearer` or `x-api-key` only. Scopes `*`, `search`, `raw:*` or `raw:<platform>` across 24 groups, picked at creation; optional `expires_at`; revocation in the console; hashed storage, shown once. GET /v1/account returns the key's scopes, expiry, balance, plan (free, payg, enterprise) and per-minute limit at no charge. Calling outside the scope answers 403 `scope_denied`
- Rate limits: 60 requests a minute per account before the first top-up, 600 after, sliding 60-second window, shared by every key and the console playground. 429 `rate_limited` with `Retry-After`; 429 `endpoint_busy` when an endpoint's global per-second cap is full (retry in 1 second, not counted against the minute); 429 `too_many_unbilled` when at least 50 calls in 10 minutes and over 80 per cent came back empty, not found or rejected; 413 above 64 KiB of body. Some endpoints are slow by design (Xingtu transcript about 8 seconds, Pugongying creator notes 5 to 10 seconds)
- Pagination: Opaque `cursor` on most list endpoints with `has_more`, `search_id` beside it on Douyin and Zhihu search, page numbers on Weibo and Xiaohongshu search (up to 50 pages) and Bilibili creator videos (up to 100), `limit` on Bilibili danmaku. Cross-platform search takes 10 or 20 results a page up to page 50, `since` and `until` as whole Beijing days up to 90, platform, content-type and sentiment filters. Page sizes are fixed per endpoint, from about 5 to 100
- Errors: 20 codes in one `error` object. 401 `invalid_api_key`; 403 `account_disabled`, `scope_denied`; 400 `invalid_params`, `upstream_rejected`; 402 `insufficient_balance`; 404 `endpoint_not_found`, `not_found`; 405 `method_not_allowed`; 410 `endpoint_disabled`; 413 `payload_too_large`; 429 `rate_limited`, `too_many_unbilled`, `endpoint_busy`, `too_many_auth_failures`; 502 and 503 `upstream_error`; 503 `upstream_busy`, `endpoint_unavailable`; 504 `upstream_timeout`, `reservation_expired`. Upstream codes and `not_found` are refunded, the rest never charged. The docs say an unexpected 500 may be plain text and PUT or DELETE get a framework 405
- MCP: Streamable HTTP at https://api.qovia.ai/mcp, stateless, JSON answers, protocol 2025-06-18, server version 0.1.0, tools only (no resources or prompts, `listChanged` false). Four default tools with JSON Schema inputs and `additionalProperties: false`; `call_endpoint` takes `endpoint_id` and a free `params` object. `?tools=all` adds one tool per live endpoint named after its id (`raw_douyin_video`), `?tools=<platforms>` only some. Tool errors carry `error.code`, the HTTP status and `retry_after_seconds`. No tool annotations in the vendor's 28 October tools/list snapshot. Registry ai.qovia/qovia 0.1.0 (22 October) and 0.1.1 (28 October 2026); the same card at https://qovia.ai/.well-known/mcp.json
- SDK and integrations: Python client `qovia` 0.1.1 on PyPI (27 October 2026, MIT, Python 3.9 or newer, no dependencies) with `get`, `post`, `search`, `account` and a `pages` iterator, two retries on 429 and 503 honouring `Retry-After`. Node and curl examples. Claude Code plugin and marketplace manifests, a Cursor plugin manifest, a Gemini CLI extension with GEMINI.md, an mcp.json and an llms-install.md for Cline. Five Actors on the Apify Store under the profile `qovia` (Qovia Data, joined October 2026, 10 users)
- Prices: Search $0.005 a call. Fixed-price raw endpoints at $0.0005 (15), $0.001 (61), $0.0015 (18), $0.002 (3), $0.005 (11), $0.01 (21), $0.0135 (Taobao reviews) and $0.0195 (JD.com reviews) a call. Tieba, Fliggy and the six coming-soon endpoints at a tiered $0.0015, $0.001 past 5,000,000 billed calls in a calendar month. 50 trial calls, then prepaid top-ups by card or Alipay through Stripe (4.4 per cent plus $0.30) or USDT TRC-20 (2 per cent plus $0.30). The Xingtu Actor on Apify costs $0.01 a basic section, $0.06 a premium section and $0.03 a video section per creator
- SLA: None. The terms summary says nothing about uptime, and the pricing FAQ counts temporary outages, rate limits and platform changes as no ground for a refund. The 11 September 2026 archived home page advertised a 99.95 per cent enterprise SLA; the current pages do not
- Data handling: The privacy policy is one paragraph. Account information (email, company) is used to deliver the service and bill, personal information is not sold, requests and returned results are not resold, deletion requests go to the support mailbox, and a signed agreement governs where it differs. No retention periods, subprocessors, data locations or DPA. Stripe is named for payments on the pricing page. Responses carry `prov.source` (live or cache) and a capture time, so some results are cached, with no stated period. The vendor says it is an unofficial data service and users are responsible for downstream use under the law and the source platforms' rules
- Status: No status page. https://qovia.ai/status/ answers 404, status.qovia.ai does not resolve and neither the docs nor the footer links one
- Prices: Cross-platform search $5 per 1,000 requests; Lowest raw endpoints (Douyin, Bilibili, Xingtu keywords) $0.50 per 1,000 requests; Most raw endpoints (TikTok, YouTube, X, Reddit, Weibo, Zhihu, Kuaishou and others) $1 per 1,000 requests; Tiered raw endpoints (Tieba, Fliggy, coming-soon platforms) $1.50 per 1,000 requests; Xiaohongshu and WeChat endpoints $5 per 1,000 requests; Xingtu and Pugongying creator marketplace endpoints $10 per 1,000 requests; JD.com product reviews $19.50 per 1,000 requests; Apify Store, Xingtu Actor premium section $0.06 per record

- Scores: Reliability 40, Performance pending, Schema & documentation 86, Agent ergonomics 77, Security & auth 60, Payments & pricing 55, Task success pending, Maintenance & community 77, Transparency & trust 30 · total over the 7 assessed categories
- Why: Reliability, Hosted reading, for the REST API with the MCP server described. · Schema & documentation, An OpenAPI 3.1.0 file (version 0.1.0, 1 MB) is public at qovia.ai/openapi.json with 144 paths and 144 operations, two security schemes, type… · Agent ergonomics, API reading. · Security & auth, API keys with scopes chosen at creation (every endpoint, search, every raw endpoint or one of 24 platform groups), an optional expiry, revoc… · Payments & pricing, No x402, MPP or L402 on Qovia's own endpoints; USDT on TRC-20 is a top-up method from a console session, not a machine payment protocol. · Maintenance & community, The newest changes are the registry entry ai.qovia/qovia 0.1.1 and the repository's tools snapshot and plugin manifests on 28 October 2026… · Transparency & trust, Closed service.
- Sources: 35, open questions: 13, both in the full twin
- Capabilities: web.extract, social.analytics, web.search
- JSON: https://www.anchorterminal.com/api/v1/tools/qovia.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/qovia.svg` or a link to https://www.anchorterminal.com/tools/qovia from a page on qovia.ai or one of its subdomains, or the README at the root of github.com/qovia/qovia-mcp, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.
- Support: scott@qovia.ai; https://qovia.ai/contact/; https://qovia.ai/docs/; more in the full twin

## Before you call it

1. Send `Authorization: Bearer sk-qovia-...` to https://api.qovia.ai and check `meta.empty` on every HTTP 200; `data` may be `null` or an empty structure and nothing is charged for it.
2. Branch on `error.code`, never on `message`. Retry only `rate_limited`, `too_many_unbilled`, `endpoint_busy`, `upstream_busy` and `too_many_auth_failures` after `Retry-After`; `endpoint_unavailable` has none and will not clear.
3. Stay under 60 requests a minute (600 after the first top-up) across every key on the account, and keep empty or not-found calls under 80 per cent of the last 10 minutes or expect 429 `too_many_unbilled`.
4. Pass the previous page's `cursor` (and `search_id` on Douyin and Zhihu search) back unchanged and stop when `has_more` is false; each page is a separate charge, and unknown parameters answer 400.
5. For MCP, connect to https://api.qovia.ai/mcp over Streamable HTTP; call `search_endpoints` then `get_endpoint` before `call_endpoint`, or add `?tools=douyin,kuaishou` for typed direct tools. Catalogue tools need no key.

## Connect

```bash
pip install qovia
```

```bash
curl "https://api.qovia.ai/v1/raw/weibo/hot_search" -H "Authorization: Bearer $QOVIA_API_KEY"
```

```bash
claude mcp add --transport http qovia https://api.qovia.ai/mcp --header "Authorization: Bearer $QOVIA_API_KEY"
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/qovia

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| Tavily API + MCP | BB | 77.1 | web.search, web.extract | https://www.anchorterminal.com/tools/tavily-mcp.min.md |
| You.com APIs | BB | 76.1 | web.search, web.extract | https://www.anchorterminal.com/tools/you-com-api.min.md |
| Context.dev | BB | 75.7 | web.extract, web.search | https://www.anchorterminal.com/tools/context-dev.min.md |
| Firecrawl MCP | BB | 75 | web.search, web.extract | https://www.anchorterminal.com/tools/firecrawl-mcp.min.md |
| Parallel Search and Task APIs | BB | 75 | web.search, web.extract | https://www.anchorterminal.com/tools/parallel-search-api.min.md |


## Panel reviews (0, desk reviews from public material, no calls made)