中Get startedTop up
Get startedTop upSign in / Sign upConsole
中EN
Skip to content
Cljx creator charts
raw.cljx.hot_stars

Cljx creator charts

LiveBeta: the endpoint and its response fields may still change
GEThttps://api.qovia.ai/v1/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.

Typical uses: Tracking trends and topics, monitoring keywords and following competitors.

Price
$0.0015 / call$1.5 per 1k · fixed price
Billing
Charged only for successful, non-empty resultsthe charge is in meta.charged_usd
Scope
raw:cljxThe API key needs this scope
Rate limit
NoneNo per-account or per-endpoint request limit

Parameters

Sent as query parameters

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

boardinteger · enum

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)

Default105One of105 · 104 · 5 · 106 · 7 · 8
star_typeinteger · enum

1 short-video creators, 4 live-stream creators (charts 7 and 8)

Default1One of1 · 4
tag_idinteger

Top-level content category ID, such as 670 beauty; leave out for all

Range1–9999
Combined constraints (JSON Schema)
{
  "allOf": [
    {
      "if": {
        "required": [
          "board"
        ],
        "properties": {
          "board": {
            "enum": [
              7,
              8
            ]
          }
        }
      },
      "then": {
        "required": [
          "star_type"
        ],
        "properties": {
          "star_type": {
            "const": 4
          }
        }
      },
      "else": {
        "properties": {
          "star_type": {
            "const": 1
          }
        }
      }
    }
  ]
}

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
codeHTTPBillingDescription
scope_denied403Not chargedThis API key lacks the scope the endpoint requires.
endpoint_unavailable503Not chargedThe endpoint is not available right now (no data source connected yet, or no price configured); nothing ran.
invalid_params400Not chargedThe 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: ….
insufficient_balance402Not chargedThe balance cannot pay for this call; top up first.
upstream_busyRetryable503RefundedThe data source is busy or cooling down; refunded. Retry after Retry-After.
upstream_timeout504RefundedThe data source timed out; refunded.
upstream_error502 / 503RefundedThe data source failed; refunded.
upstream_rejected400RefundedThe data source rejected these parameters (well-formed, but not accepted); refunded.
not_found404RefundedThe data source has no such item (deleted, or the ID does not exist); refunded.
reservation_expired504RefundedThe 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.

Every error code
Call it from your browser

Needs an account with a balance; playground calls are billed like API calls.

Try in the playgroundCreate an API key