DataNavoAPI / ANSWERS / DOUYIN

How do I use CPM when screening Xingtu creators?

How do I use CPM when screening Xingtu creators? Follow concrete contracts, examples and reviewable steps using Douyin.

LOCAL SIMULATIONAll displayed records are fictional fixtures. Live APIs, payments and external email are disabled.中文版 ↗
01

Answer

Start by inspecting the contracts and local samples for Douyin Xingtu creator search, Douyin Xingtu creator rate card. Establish the input for douyin.xingtu.creators.search, then check whether its creator object contains the fields your task needs.

Align the metric name, denominator, observation window and capture time first. Indices, reads, impressions, plays, engagement and cost are different measurements. A missing value means unavailable, not zero; likes cannot substitute for reads.

02

Relevant contracts

CapabilityObjectShapePagination
douyin.xingtu.creators.searchCreatoritemsExplicit cursor
douyin.xingtu.creators.rates.getCreator ratesitemNo cursor
03

Input contract

Inspect meanings, examples and conditional rules for the selected method. view and fields control the response without changing the TEST unit price.

  • Only send fields defined for this method; unknown fields are rejected before execution.
MethodFieldTypeRequirementMeaningEnum or boundExample
GETquerystringRequiredSearch terms, matched against creators' names—"美食"
GETfollowers_minintegerOptional / conditionalAt least this many followers1 … ∞—
GETfollowers_maxintegerOptional / conditionalAt most this many followers1 … ∞—
GETcpm_minintegerOptional / conditionalExpected cost per thousand views of an integrated video (ext.cpm_integrated) at least this, in yuan1 … ∞—
GETcpm_maxintegerOptional / conditionalExpected cost per thousand views of an integrated video (ext.cpm_integrated) at most this, in yuan: 50 is no more than 50 yuan a thousand views1 … ∞—
GETgenderstringOptional / conditionalOnly female or only male creators["female","male"]—
GETsortstringOptional / conditionalOrder: relevance, the platform's own ranking (the default); lowest_cpm, by expected CPM, lowest first. The platform orders by the figure in ext.cpm_promoted, so the order may differ from that of ext.cpm_integrated["relevance","lowest_cpm"]—
GETcursorstringOptional / conditionalThe `next_cursor` of the previous page. A new page is a new call.——
GETviewstringOptional / conditionalHow much of each item: compact (the most used fields, long text cut short), standard, or full (adds `ext`).["compact","standard","full"]—
GETfieldsarrayOptional / conditionalReturn only these fields of each item, by path (`author.name`).maxItems: 64—
04

Complete one verification

Run one local fixture for a listed capability and inspect the object structure. Then filter, classify or export according to the question. A local sample cannot replace evidence for a real-platform conclusion.

json
{
  "capability": "douyin.xingtu.creators.search",
  "method": "GET",
  "params": {
    "query": "美食"
  }
}
TRY THE CONTRACT

Clear inputs. Inspectable output.

Each click runs a local fixture. Advanced JSON inputs are checked against the selected method. Editing does not execute a request.

Copying does not execute. CLI quote is read-only and needs a local customer TEST key. Configure MCP in demo mode first. GET and POST batches both return only fictional local fixtures.

Download contract example (no execution) ↗

For TEST budgets, Key scopes or failure scenarios, open the account console. Customer sandbox ↗