API Douyin Capacità di conversione dei creator Xingtu

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

Leggi i dati di conversione che Xingtu mostra per i video su commissione Xingtu di un creator Douyin negli ultimi 7, 30 o 90 giorni: video correlati, riproduzioni mediane, clic sui componenti e tasso di clic, CPC, GPM, vendite medie, prodotti promossi e relative categorie. La maggior parte dei valori sono intervalli espressi con le diciture di Xingtu, come 500-1000, mentre quelli aperti, come "10% o più", sono in cinese. Solo i creator con ordini Xingtu nella finestra hanno dati; gli altri restituiscono un risultato vuoto, che non viene addebitato.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su douyin e action impostato su xingtu_conversion_ability. Prezzo $1.6 per 1.000 richieste ($0.001597 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.

Prompt per l'AI

Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Douyin Capacità di conversione dei creator Xingtu di EveryInfra (douyin/xingtu_conversion_ability).

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 xingtu_conversion_ability, e inserisci i parametri in params.
- Parametri obbligatori:
  - douyin_id: L'ID Douyin visibile del creator (unique_id, da creator_search) o il creator_id Xingtu di 19 cifre restituito da xingtu_creator_search.
- Parametri facoltativi:
  - time_window: Periodo dei dati Xingtu: 7d, 30d (predefinito) o 90d, contato a ritroso da oggi. Non è il periodo della classifica di xingtu_creator_rankings. (valori consentiti: 30d / 7d / 90d)
- Restituisce un oggetto. Campi principali: creator_id, time_window (Periodo dei dati (xingtu_conversion_abi…), related_video_count (Video usati da Xingtu per i dati di con…), video_play_median (Mediana delle riproduzioni di quei vide…), component_click_count_range (Intervallo dei clic sul componente, nel…), component_click_rate_range (Intervallo del tasso di clic sul compon…), cpc_range_cny (Intervallo del costo per clic in yuan (…), gpm_range_cny (Intervallo del GPM in yuan, cioè vendit…), average_sales_range_cny (Intervallo delle vendite medie in yuan…), product_count (Prodotti promossi dal creator nel perio…), product_price_range_cny (Fascia di prezzo di quei prodotti in yu…), categories (In xingtu_conversion_ability, le catego…).
- Esempio di corpo della richiesta:
{
  "platform": "douyin",
  "action": "xingtu_conversion_ability",
  "params": {
    "douyin_id": "XiaoZhenlla"
  }
}
- Prezzo: $1.6 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ì	`xingtu_conversion_ability`	Identificativo della funzionalità, valore fisso.
`douyin_id`	body.params	`string`	Sì	-	L'ID Douyin visibile del creator (`unique_id`, da `creator_search`) o il `creator_id` Xingtu di 19 cifre restituito da `xingtu_creator_search`. Un creator non presente su Xingtu produce un risultato vuoto, che non viene addebitato.
`time_window`	body.params	`string (enum)`	No	-	Periodo dei dati Xingtu: `7d`, `30d` (predefinito) o `90d`, contato a ritroso da oggi. Non è il periodo della classifica di `xingtu_creator_rankings`.Valori consentiti`30d7d90d`

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": "xingtu_conversion_ability",
  "params": {
    "douyin_id": "XiaoZhenlla"
  }
}'

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": "xingtu_conversion_ability",  "results": {    "creator_id": …,    "time_window": …,    "related_video_count": …,    "video_play_median": …,    "component_click_count_range": …,    "component_click_rate_range": …,    "cpc_range_cny": …,    "gpm_range_cny": …,    "average_sales_range_cny": …,    "product_count": …,    "product_price_range_cny": …,    "categories": …,    "platform": …  },  "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
`creator_id`	Mantiene il significato attribuito dalla piattaforma
`time_window`	Periodo dei dati (xingtu_conversion_ability): 7d, 30d o 90d, come richiesto.
`related_video_count`	Video usati da Xingtu per i dati di conversione nel periodo (xingtu_conversion_ability).
`video_play_median`	Mediana delle riproduzioni di quei video (xingtu_conversion_ability).
`component_click_count_range`	Intervallo dei clic sul componente, nella formulazione di Xingtu (xingtu_conversion_ability), ad esempio 500-1000; gli intervalli aperti come «meno di 500» sono in cinese.
`component_click_rate_range`	Intervallo del tasso di clic sul componente (xingtu_conversion_ability), ad esempio 2%-5%; gli intervalli aperti come «10% o più» sono in cinese.
`cpc_range_cny`	Intervallo del costo per clic in yuan (xingtu_conversion_ability), ad esempio 6-8.
`gpm_range_cny`	Intervallo del GPM in yuan, cioè vendite ogni mille riproduzioni (xingtu_conversion_ability), ad esempio 10-30.
`average_sales_range_cny`	Intervallo delle vendite medie in yuan (xingtu_conversion_ability), ad esempio 2000-5000; assente quando il creator nasconde le vendite su Xingtu.
`product_count`	Prodotti promossi dal creator nel periodo (xingtu_conversion_ability).
`product_price_range_cny`	Fascia di prezzo di quei prodotti in yuan (xingtu_conversion_ability), ad esempio 2000-5000; le decine di migliaia possono essere scritte con l'unità cinese che vale 10.000.
`categories`	In xingtu_conversion_ability, le categorie di prodotti promosse: [{name, share (da 0 a 1), sales_range_cny}], solo quando il creator ha promosso prodotti. In xingtu_touch_distribution, le categorie di contenuti da cui provengono gli utenti connessi, fino a tre livelli: [{name, touch_count, subcategories (stessa struttura)}].
`platform`	Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok).

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