search

Cross-domain search

Coming soonBetaFree quota applies

POSThttps://api.qovia.ai/v1/search

One query across social, e-commerce and web. Semantic + keyword retrieval with unified records, vectors and provenance.

Price at launch: $0.004 / call$4 per 1k$3 per 1k after 1M a month$2.5 per 1k after 10M a month
Billing: Charged only for successful, non-empty resultsfree quota first
Scope: searchThe API key needs this scope
Rate cap: 100 req/s globalAcross all users, plus your per-minute limit

Coming soon

The parameters and response format are settled, but no data source is connected yet. A call now gets 503 endpoint_unavailable and is not charged.

Parameters

Sent as a JSON body

Only these parameters are accepted; any other one returns 400.

querystringRequired

What to search for

Max 500 chars

Example通勤咖啡测评

domainsstring[]

Only these domains: social, ecommerce, web

Defaultsocial, ecommerce, webOne ofsocial · ecommerce · web

platformsstring[]

Only these platforms (slugs)

freshnessstring

How recent the results must be, 1h–90d

Default24hPattern^[0-9]+(h|d)$

formatenum

Output: records alone, or vectors+provenance to add vectors and provenance

Defaultvectors+provenanceOne ofrecords · vectors+provenance

limitinteger

Number of results

Default20Range1–100

curl https://api.qovia.ai/v1/search \
  -H "Authorization: Bearer $QOVIA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"通勤咖啡测评"}'

Replace $QOVIA_KEY with your API key

Example response200 OK

{
  "request_id": "00000000-0000-0000-0000-000000000000",
  "data": [
    {
      "id": "soc_xia_5c8a",
      "src": "social",
      "platform": "xiaohongshu",
      "lang": "zh-CN",
      "text": "早八人通勤咖啡测评｜这三家真的值",
      "author": {
        "uid_hash": "7be2a1",
        "followers": 56900
      },
      "metrics": {
        "likes": 3204,
        "comments": 517,
        "saves": 1188
      },
      "prov": {
        "hash": "0xf491d8d1",
        "ts": "2026-07-04T09:12:41+08:00"
      }
    }
  ],
  "meta": {
    "billed": true,
    "charged_usd": "0.004000",
    "used_free_quota": false,
    "free_quota_remaining": 0,
    "balance_usd": "9.996000",
    "empty": false
  }
}

Catalog sample, not live data

Response

A success is HTTP 200 with the shared envelope: request_id, data (this endpoint's data, see the example) and meta (the charge). An empty result is also 200, with meta.empty true, not charged, and data may be an empty structure or null.

The response envelope in detail

Errors

Errors this endpoint can return
code	HTTP	Billing	Description
`scope_denied`	403	Not charged	This API key lacks the scope the endpoint requires.
`endpoint_unavailable`	503	Not charged	The endpoint is not available right now (no data source connected yet, or no price configured); nothing ran.

Any request can also fail authentication: 401 invalid_api_key, 403 account_disabled, 429 too_many_auth_failures.

Every error code