API TikTok Dettagli del creator dello Shop

Q: Quale dato mostra la reale portata di un creator?

avg_views, le visualizzazioni medie del creator. I follower si possono comprare o gonfiare, mentre le visualizzazioni medie sono molto più difficili da gonfiare, quindi riflettono quante persone raggiunge davvero un post di questo creator. Leggilo insieme a sold_count per capire se quella portata si traduce in vendite.

POST

Stato di salute dell'API

Operatività nelle ultime 24 ore: 14%
Tempo medio nelle ultime 24 ore: 5.58 s

Buono / normale
Disponibile
Limitato
Quasi del tutto inattivo

Quasi del tutto inattivo

Ultime 24 ore

Ultimi 30 giorni

Valuta un creator di TikTok Shop tramite handle. Ottieni categorie, follower, numero di video, prodotti promossi, unità vendute e visualizzazioni medie. country sceglie il mercato dello Shop, non la nazionalità del creator. Vendite private, commissioni e acquirenti non vengono mostrati.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su tiktok e action impostato su shop_creator. 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.

TikTok Shop creator details cerca il profilo TikTok Shop di un creator tramite username e restituisce nome, avatar, paese, categorie, follower, numero di video, numero di prodotti promossi, vendite e visualizzazioni medie. Venditori e agenzie la usano per valutare i creator affiliati prima di inviare campioni o offrire una commissione e per confrontare i candidati in base all'attività di vendita e non solo alla dimensione del pubblico.

Imposta country sul mercato dello shop che ti interessa, come codice regione; il valore predefinito è US e si riferisce al mercato TikTok Shop, non alla nazionalità del creator. Dai più peso a avg_views che a follower_count: i totali dei follower si possono falsificare, mentre le visualizzazioni medie sono difficili da falsificare. product_count e sold_count mostrano se il creator vende davvero. username è l'handle del creator; la @ iniziale è facoltativa e un URL del profilo non funziona.

Prompt per l'AI

Aiutami a scrivere uno script di raccolta dei dati con l'endpoint TikTok Dettagli del creator dello Shop di EveryInfra (tiktok/shop_creator).

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 tiktok e action su shop_creator, e inserisci i parametri in params.
- Parametri obbligatori:
  - username: Handle TikTok pubblico, anche con la @ iniziale. Non passare token secUid di Douyin né URL completi del profilo. In followers restituisce il numero di follower.
- Parametri facoltativi:
  - country: Codice della regione di mercato per le azioni shop_search e shop_creator; il valore predefinito è US o us. Non filtra per nazionalità del creator né per area geografica dei contenuti sulla piattaforma.
- Restituisce un oggetto. Campi principali: id, username, url, name, text, avatar_url, country, categories, follower_count, video_count, product_count, sold_count; 13 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=tiktok.
- Esempio di corpo della richiesta:
{
  "platform": "tiktok",
  "action": "shop_creator",
  "params": {
    "username": "dealswithty"
  }
}
- 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ì	`tiktok`	Identificativo della piattaforma, valore fisso.
`action`	body	`string`	Sì	`shop_creator`	Identificativo della funzionalità, valore fisso.
`username`	body.params	`string`	Sì	-	Handle TikTok pubblico, anche con la `@` iniziale. Non passare token `secUid` di Douyin né URL completi del profilo. In `followers` restituisce il numero di follower; in `shop_creator` recupera i dettagli e-commerce del creator per un mercato specifico.
`country`	body.params	`string`	No	-	Codice della regione di mercato per le azioni `shop_search` e `shop_creator`; il valore predefinito è `US` o `us`. Non filtra per nazionalità del creator né per area geografica dei contenuti sulla piattaforma. Consulta il catalogo per i mercati supportati.

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": "tiktok",
  "action": "shop_creator",
  "params": {
    "username": "dealswithty"
  }
}'

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": "tiktok",  "action": "shop_creator",  "results": {    "id": "dealswithty",    "username": "dealswithty",    "url": "https://www.tiktok.com/@dealswithty",    "name": "•••",    "text": "Inquiries: •••\n\nCheck out showcase for the best deals on tiktok\n👇🏼",    "avatar_url": "https://p19-common-sign.tiktokcdn-us.com/•••",    "country": "US",    "categories": [      {        "id": "•••",        "name": "•••"      },      {        "id": "•••",        "name": "•••"      },      {        "id": "•••",        "name": "•••"      }    ],    "platform": "tiktok"  },  "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
`id`	ID univoco del record sulla piattaforma. È univoco solo all'interno di una piattaforma; gli ID possono ripetersi tra piattaforme diverse.
`username`	Username (@handle).
`url`	Link al record sulla piattaforma.
`name`	Nome dell'oggetto stesso, per le funzionalità relative ad account, prodotti e attività.
`text`	Testo del contenuto senza HTML, restituito per intero e mai troncato (su alcune piattaforme i risultati degli elenchi contengono solo un estratto; lo indicano le note sui campi della piattaforma).
`avatar_url`	Link all'immagine dell'avatar. Alcune piattaforme restituiscono URL CDN con dimensioni specifiche, che possono scadere.
`country`	Paese o regione: nome completo o codice ISO a seconda della piattaforma, non normalizzato.
`categories`	Mantiene il significato attribuito dalla piattaforma
`follower_count`	Follower. null significa non reso noto, non 0.
`video_count`	Mantiene il significato attribuito dalla piattaforma
`product_count`	Mantiene il significato attribuito dalla piattaforma
`sold_count`	Mantiene il significato attribuito dalla piattaforma
`avg_views`	Mantiene il significato attribuito dalla piattaforma
`platform`	Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok).

FAQ

Cosa cambia `country`?

Sceglie, tramite codice regione, il mercato TikTok Shop di cui leggi i dati del creator; il valore predefinito è US. Non descrive la nazionalità del creator e non filtra i video per regione. Per confrontare un creator tra più mercati, fai una chiamata per ogni country e conserva il codice con ciascun risultato.

Quale dato mostra la reale portata di un creator?

avg_views, le visualizzazioni medie del creator. I follower si possono comprare o gonfiare, mentre le visualizzazioni medie sono molto più difficili da gonfiare, quindi riflettono quante persone raggiunge davvero un post di questo creator. Leggilo insieme a sold_count per capire se quella portata si traduce in vendite.

In cosa è diverso da TikTok Details?

TikTok Details legge il profilo generale: bio, verifica e conteggi dell'account. Shop creator details legge il lato vendite per un mercato dello shop: prodotti promossi, vendite, categorie e visualizzazioni medie. Entrambi accettano lo stesso handle, con o senza @, quindi puoi usarli in parallelo.

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