raw.xingtu.author_seeding_v2Douyin Xingtu creator search lift V2
https://api.qovia.ai/v1/raw/xingtu/author_seeding_v2Xingtu's search lift for a creator, returned as Xingtu answers: the average searches after viewing personal_avg_search_after_view_cnt with its peer percentile personal_avg_search_after_view_cnt_rank_percent, the search-after-view rate personal_avg_search_after_view_rate and the search-term CTR personal_search_word_ctr, plus modify_time and base_resp. Xingtu only publishes display values (such as "100 - 1,000" or "<0.02%"), returned as strings; the window is Xingtu's default and cannot be chosen. Fast: usually about 2 seconds. A creator without data (those fields missing, or only base_resp) answers empty. Only an answer with data is charged; an empty answer or an error is not.
Typical uses: Vetting creators, monitoring accounts and benchmarking competitors' accounts.
- Price
- $0.02536 / call$25.36 per 1k · fixed price
- Billing
- Charged only for successful, non-empty resultsthe charge is in meta.charged_usd
- Scope
raw:xingtuThe API key needs this scope- Rate cap
- Account limit onlyYour per-minute limit
Parameters
Only these parameters are accepted; any other one returns 400.
author_idXingtu creator ID (o_author_id)
Pattern^[0-9]{15,20}$Example
6790158034132795406
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. |
invalid_params | 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_limitedRetryable | 429 | Not charged | Over the account's per-minute limit (sliding 60-second window); wait for Retry-After. |
too_many_unbilledRetryable | 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. |
insufficient_balance | 402 | Not charged | The balance cannot pay for this call; top up first. |
upstream_busyRetryable | 503 | Refunded | The data source is busy or cooling down; refunded. Retry after Retry-After. |
upstream_timeout | 504 | Refunded | The data source timed out; refunded. |
upstream_error | 502 / 503 | Refunded | The data source failed; refunded. |
upstream_rejected | 400 | Refunded | The data source rejected these parameters (well-formed, but not accepted); refunded. |
not_found | 404 | Refunded | The data source has no such item (deleted, or the ID does not exist); refunded. |
reservation_expired | 504 | Refunded | The call took too long and was refunded automatically; no data is returned. |
Any request can also fail authentication: 401 invalid_api_key, 403 account_disabled, 429 too_many_auth_failures.
Needs an account with a balance; playground calls are billed like API calls.