API Douyin Ricerca prodotti
POST
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- Normale
- Buono / normale
- Disponibile
- Limitato
- Quasi del tutto inattivo
Normale
Ultime 24 ore
Ultimi 30 giorni
Trova fino a cinque prodotti di Douyin Mall per una parola chiave. Ottieni prezzo in CNY, vendite a 30 giorni, tasso di recensioni positive, negozio, tasso di commissione e numero di creator partner. Il numero di creator partner non indica che un determinato creator abbia venduto l'articolo. Quando la fonte principale non è disponibile, una fonte di riserva restituisce solo ID prodotto, titolo, link, immagine, prezzo in CNY e ID negozio. In quel caso mancano vendite, tasso di recensioni, nome del negozio, categoria, commissione e campi sui creator. I prezzi d'ingresso pari o inferiori a un decimo di yuan vengono esclusi.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su douyin e action impostato su product_search. Prezzo $13.33 per 1.000 richieste ($0.01333 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 Ricerca prodotti di EveryInfra (douyin/product_search).
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 product_search, e inserisci i parametri in params.
- Parametri obbligatori:
- keyword: Una frase di ricerca di prodotti su Douyin. I risultati formano un pool di prodotti indipendente e non dimostrano che un determinato creator abbia promosso o venduto quegli articoli.
- Parametri facoltativi:
- limit: Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 5. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. (predefinito: 5)
- Restituisce un elenco di record. Campi principali di ogni record: product_id (ID stabile del prodotto su Douyin Mall), promotion_id, title, url, image_url, white_image_url, price_cny (Prezzo del prodotto visualizzato, in yu…), price_cny_minor, price_label, monthly_sales, good_review_ratio, sales_trend; 26 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=douyin.
- Esempio di corpo della richiesta:
{
"platform": "douyin",
"action": "product_search",
"params": {
"keyword": "美食"
}
}
- Prezzo: $13.33 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ì | product_search | Identificativo della funzionalità, valore fisso. |
keyword | body.params | string | Sì | - | Una frase di ricerca di prodotti su Douyin. I risultati formano un pool di prodotti indipendente e non dimostrano che un determinato creator abbia promosso o venduto quegli articoli. |
limit | body.params | integer (1–5) | No | 5 | Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 5. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. I valori più alti restituiscono 422 prima di qualsiasi addebito. |
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": "product_search",
"params": {
"keyword": "美食"
}
}'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
#Acquisita il October 24, 2026 at 19:16 (UTC) chiamando questa API con i parametri dell'esempio di codice qui sopra. results e count sono la risposta reale di quella chiamata, da cui sono state rimosse le informazioni personali (nomi, handle, avatar, link ai profili, recapiti); l'elenco conserva i primi 2. id, billing e quota cambiano a ogni chiamata, quindi ne viene mostrata solo la struttura.
json
{ "id": "req_…", "platform": "douyin", "action": "product_search", "results": [ { "product_id": "3831023923881967796", "promotion_id": "3848090182540722407", "title": "新晒云南紫皮独头蒜红皮干蒜新鲜大蒜头农家日晒蒜香浓调味蔬菜", "url": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=3831023923881967796&origin_type=2631", "image_url": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/jpeg_m_884e7a0120de46a9b2ac8e21fab47fd3_sx_133438_www800-800", "price_cny": 6.5, "price_cny_minor": 650, "price_label": "到手价", "monthly_sales": 4923, "good_review_ratio": 85.41076487252124, "sales_trend": [ { "date": "20260925", "units": 66 }, { "date": "20260926", "units": 81 }, { "date": "20260927", "units": 117 } ], "category_path": [ "水果蔬菜", "蔬菜/豆制品", "蒜" ], "category_ids": [ "1000001991", "1000001994", "1000009708" ], "category_depth": 3, "shop_id": 22962988, "shop_name": "云南高原特色美食", "shop_logo_url": "https://p3-ecom-qualification-sign.ecombdimg.com/tos-cn-i-6vegkygxbk/70a8e9cd1a9547e8a8bed715d69eddfc~tplv-6vegkygxbk-s:750.image?lk3s=c9156bde&x-expires=1824403460&x-signature=wtJgFMyZAeSjYrd6OM%2Fm69cUIdU%3D", "shop_score": 78, "commission_rate_percent": 5, "commission_cny": 0.33, "cooperating_creator_count": 102, "tags": [ "消费券", "现货" ], "source_keyword": "美食", "search_rank": 1, "platform": "douyin" }, { "product_id": "3791042363200241770", "promotion_id": "3791047461418696801", "title": "《抢六罐》新货辣椒桂皮香叶白芷辣椒花椒家庭常用辣椒", "url": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=3791042363200241770&origin_type=2631", "image_url": "https://p9-aio.ecombdimg.com/obj/ecom-shop-material/png_m_0d2d9da52dd42997f1a21e04b363d33c_sx_2099503_www1080-1080", "price_cny": 9.9, "price_cny_minor": 990, "price_label": "到手价", "monthly_sales": 101785, "good_review_ratio": 88.52033748898124, "sales_trend": [ { "date": "20260925", "units": 2734 }, { "date": "20260926", "units": 2955 }, { "date": "20260927", "units": 2865 } ], "category_path": [ "水果蔬菜", "蔬菜/豆制品", "辣椒" ], "category_ids": [ "1000001991", "1000001994", "1000009718" ], "category_depth": 3, "shop_id": 235766548, "shop_name": "千梦优品供应链", "shop_logo_url": "https://p6-ecom-qualification-sign.ecombdimg.com/tos-cn-i-6vegkygxbk/5966b135e7fa4889aa95760454e408d4~tplv-6vegkygxbk-s:750.image?lk3s=c9156bde&x-expires=1824402090&x-signature=5pF%2BEMnDOYLOiqvL92G7bfe8Ti0%3D", "shop_score": 92, "commission_rate_percent": 30, "commission_cny": 2.97, "cooperating_creator_count": 4174, "tags": [ "高结算率", "消费券", "现货" ], "source_keyword": "美食", "search_rank": 2, "recommend_reason": "辣椒视频带货热推榜·第1名", "platform": "douyin" } ], "count": 5, "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 |
|---|---|
product_id | ID stabile del prodotto su Douyin Mall. |
promotion_id | Mantiene il significato attribuito dalla piattaforma |
title | Titolo. null quando la piattaforma non prevede titoli (ad esempio post di solo testo). |
url | Link al record sulla piattaforma. |
image_url | Link all'immagine. Le funzionalità con più immagini possono restituire un array image_urls. |
white_image_url | Mantiene il significato attribuito dalla piattaforma |
price_cny | Prezzo del prodotto visualizzato, in yuan. |
price_cny_minor | Mantiene il significato attribuito dalla piattaforma |
price_label | Mantiene il significato attribuito dalla piattaforma |
monthly_sales | Mantiene il significato attribuito dalla piattaforma |
good_review_ratio | Mantiene il significato attribuito dalla piattaforma |
sales_trend | Mantiene il significato attribuito dalla piattaforma |
category_path | Mantiene il significato attribuito dalla piattaforma |
category_ids | Percorso degli ID di categoria del prodotto, nello stesso ordine di category_path (product_search). |
category_depth | Mantiene il significato attribuito dalla piattaforma |
shop_id | ID del negozio su Douyin Mall. |
shop_name | Nome del negozio su Douyin Mall. |
shop_logo_url | Mantiene il significato attribuito dalla piattaforma |
shop_score | Mantiene il significato attribuito dalla piattaforma |
commission_rate_percent | Mantiene il significato attribuito dalla piattaforma |
commission_cny | Mantiene il significato attribuito dalla piattaforma |
cooperating_creator_count | Mantiene il significato attribuito dalla piattaforma |
tags | Array di tag. Se non ce ne sono, è un array vuoto, non null. |
source_keyword | Il termine di ricerca a cui corrisponde questa riga. |
search_rank | Mantiene il significato attribuito dalla piattaforma |
recommend_reason | Il motivo della raccomandazione mostrato nel risultato di ricerca del prodotto (product_search); assente quando non c'è. |
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.