API Douyin Pubblico del creator

Q: Cos'è la fascia di prezzo del dispositivo?

device_price_band, la dimensione predefinita, raggruppa i follower di un creator in base alla fascia di prezzo dei telefoni che usano. È utile quando devi abbinare il livello di prezzo di un prodotto al pubblico di un creator. Come per le altre dimensioni, ogni gruppo viene restituito come quota da 0 a 1 con il proprio TGI.

POST

Stato di salute dell'API

Operatività nelle ultime 24 ore: Normale

Buono / normale
Disponibile
Limitato
Quasi del tutto inattivo

Ultime 24 ore

Ultimi 30 giorni

Analizza i follower di un creator Douyin per fascia di prezzo del dispositivo, genere, età o provincia, con la quota di ogni fascia e il suo indice TGI. Le quote sono decimali tra 0 e 1, non percentuali, e le fasce non sono registri di acquirenti né singole persone.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su douyin e action impostato su creator_audience. Prezzo $0.56 per 1.000 richieste ($0.000556 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Sincrona. Per i job più lenti, aggiungi "mode": "async" al corpo della richiesta, recupera il job_id ed esegui il polling.

Douyin Creator audience mostra chi segue un creator, a partire dal suo user_id, secondo una dimension: fascia di prezzo del dispositivo (predefinita), genere, età o provincia. Ogni gruppo in audience_distribution riporta la quota di follower che rappresenta, e audience_tgi indica quanto quel gruppo è rappresentato rispetto alla media di Douyin. Brand e agenzie la usano per verificare che i follower di un creator corrispondano ai clienti che vogliono raggiungere prima di prenotare una campagna.

Le quote sono decimali da 0 a 1 e non percentuali, quindi 0.42 significa il 42% dei follower; non sono né numeri di follower né quote di acquirenti. Il TGI usa una scala separata ed è il valore da leggere per valutare l'affinità, perché un gruppo con una quota modesta può comunque essere fortemente sovrarappresentato. Per user_id, passa il secUid del creator, la lunga stringa che di solito inizia con MS4w, oppure l'intero link al profilo che lo contiene, come nell'esempio.

Prompt per l'AI

Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Douyin Pubblico del creator di EveryInfra (douyin/creator_audience).

Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su douyin e action su creator_audience, e inserisci i parametri in params.
- Parametri obbligatori:
  - user_id: Il secUid del creator Douyin, che di solito inizia con MS4w, usato per leggere la distribuzione del pubblico e gli indicatori TGI disponibili.
- Parametri facoltativi:
  - dimension: Seleziona la vista per segmento di follower di creator_audience: device_price_band (predefinito), gender, age o province. I valori della distribuzione sono quote decimali grezze da 0 a 1, non percentuali. (valori consentiti: age / device_price_band / gender / province)
- Restituisce un oggetto. Campi principali: user_id, audience_distribution, audience_tgi, dimension_code.
- Esempio di corpo della richiesta:
{
  "platform": "douyin",
  "action": "creator_audience",
  "params": {
    "user_id": "https://www.douyin.com/user/MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS"
  }
}
- Prezzo: $0.56 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Per decine o centinaia di target, aggiungi "mode": "async" al corpo: ricevi subito un job_id ed esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} per ottenere il risultato.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.

Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.

Parametri della richiesta

Nome	Posizione	Tipo	Obbligatorio	Predefinito	Descrizione
`Authorization`	header	`string`	Sì	-	Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice.
`platform`	body	`string`	Sì	`douyin`	Identificativo della piattaforma, valore fisso.
`action`	body	`string`	Sì	`creator_audience`	Identificativo della funzionalità, valore fisso.
`user_id`	body.params	`string`	Sì	-	Il `secUid` del creator Douyin, che di solito inizia con `MS4w`, usato per leggere la distribuzione del pubblico e gli indicatori TGI disponibili. Usa lo `user_id` ottenuto dalla ricerca dei creator, non un nickname, un ID Douyin breve o un identificatore di acquirente.
`dimension`	body.params	`string (enum)`	No	-	Seleziona la vista per segmento di follower di `creator_audience`: `device_price_band` (predefinito), `gender`, `age` o `province`. I valori della distribuzione sono quote decimali grezze da 0 a 1, non percentuali; il TGI resta un indice separato. Questo parametro non richiede record di singoli follower né dati sugli acquirenti.Valori consentiti`agedevice_price_bandgenderprovince`

Esempi di codice

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "douyin",
  "action": "creator_audience",
  "params": {
    "user_id": "https://www.douyin.com/user/MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS"
  }
}'

Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.

Esempio di risposta

json

{  "id": "req_…",  "platform": "douyin",  "action": "creator_audience",  "results": {    "user_id": "https://www.douyin.com/user/MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS",    "audience_distribution": [      {        "label": "2000~2999",        "value": 0.21259893463305227      },      {        "label": "5000~5999",        "value": 0.16836679678233302      },      {        "label": "1000~1999",        "value": 0.14285406198106493      }    ],    "audience_tgi": [      {        "label": "3000~3999",        "value": 121.50162156159308      },      {        "label": "7000~7999",        "value": 107.46785052961428      },      {        "label": "0~999",        "value": 34.04478663045582      }    ],    "dimension_code": "device_price_band",    "platform": "douyin"  },  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Campi della risposta

I dati di business si trovano in results. La tabella elenca i campi che un record può contenere; i valori che la piattaforma non mostra non vengono mai inventati.

Campo	Significato
`user_id`	ID univoco dell'utente sulla piattaforma.
`audience_distribution`	Mantiene il significato attribuito dalla piattaforma
`audience_tgi`	Mantiene il significato attribuito dalla piattaforma
`dimension_code`	Mantiene il significato attribuito dalla piattaforma
`platform`	Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok).

FAQ

Cos'è la fascia di prezzo del dispositivo?

device_price_band, la dimensione predefinita, raggruppa i follower di un creator in base alla fascia di prezzo dei telefoni che usano. È utile quando devi abbinare il livello di prezzo di un prodotto al pubblico di un creator. Come per le altre dimensioni, ogni gruppo viene restituito come quota da 0 a 1 con il proprio TGI.

Cosa aggiunge `audience_tgi` rispetto alla quota?

Il TGI confronta ogni gruppo con la media della piattaforma Douyin e si misura indipendentemente dalla quota. Un gruppo può essere una piccola fetta dei follower e avere comunque un TGI alto: significa che il creator attira quel gruppo più di quanto faccia Douyin nel complesso. Usa la quota per misurare le dimensioni di un gruppo e il TGI per valutare quanto è distintivo il pubblico.

Posso ottenere tutte e quattro le dimensioni in una sola chiamata?

No. Ogni chiamata restituisce una sola dimensione, scelta con dimension: device_price_band se ometti il parametro, oppure gender, age o province. Fai una chiamata per ogni dimensione che ti serve. dimension_code registra in ogni risposta quale dimensione contiene, così i risultati di chiamate separate restano etichettati quando li salvi insieme.

Errori e addebiti

401: Chiave mancante o non valida.
402: Saldo insufficiente. Effettua prima una ricarica.
422: Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
429: Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
503: Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
Risposta 200 vuota: Nessun dato. Nessun addebito.

Errori