raw.tiktok.videoTikTok video detail
Coming soonBeta: the endpoint and its response fields may still changeFree quota applies
GET
https://api.qovia.ai/v1/raw/tiktok/videoMetadata and engagement metrics for one video.
- Price at launch
- $0.0015 / call$1.5 per 1k$1 per 1k after 5M a month
- Billing
- Charged only for successful, non-empty resultsfree quota first
- Scope
raw:tiktokThe API key needs this scope- Rate cap
- 50 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 query parameters
Only these parameters are accepted; any other one returns 400.
video_idTikTok video ID
Example
7301234567890123456
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.
Errors
| 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.