Douyin Product search API
API health
- 24h health
- Mostly down
- Healthy / normal
- Available
- Limited
- Mostly down
Last 24 hours
Last 30 days
Search Douyin Mall products by keyword, up to 30 a page. Get CNY price, 30-day sales, positive review rate, shop, commission rate and number of partnering creators. Pass next_page_token back as page_token for the next page; products already returned are not repeated, and one keyword gives about 500 products at most. Each page is one call. The partnering creator count does not show that a specific creator sold the item. When the main source is unavailable, a backup source returns at most five products with no next page, and only product ID, title, link, image, CNY price and shop ID. Sales, review rate, shop name, category, commission and creator fields are then missing. Lead-in prices of a tenth of a yuan or less are left out.
Send POST https://api.everyinfra.com/api/v1/social with platform set to douyin and action set to product_search. Price $13.33 per 1,000 requests ($0.01333 per call). Failed calls and empty results are not charged. Synchronous. For slow jobs add "mode": "async" to the body, take the job_id and poll.
AI prompt
#Please help me write a data collection script with the EveryInfra Douyin Product search endpoint (douyin/product_search).
How the endpoint works:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to douyin and action to product_search, and put the parameters inside params.
- Required parameters:
- keyword: A Douyin product search phrase. Results form an independent product pool and do not establish that any specified creator promoted or sold those items.
- Optional parameters:
- page: Page number from 1 to 17, with up to 30 products a page. It reads that page directly as one call; when page_token is also sent, the token wins.
- page_token: Page token for product_search. Leave it out for the first page, then pass back the previous response's next_page_token exactly as received, keeping keyword unchanged. Each page holds up to 30 products and is one call.
- Returns a list of records. Main fields of each record: next_page_token (Page token (search / user_posts / comme…), product_id (Stable Douyin Mall product ID), promotion_id, title, url, image_url, white_image_url, price_cny (Displayed product price in yuan), price_cny_minor, price_label, monthly_sales, good_review_ratio; 27 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=douyin.
- Example request body:
{
"platform": "douyin",
"action": "product_search",
"params": {
"keyword": "美食"
}
}
- Price: $13.33 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.
Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.Request parameters
#| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
Authorization | header | string | Yes | - | Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository. |
platform | body | string | Yes | douyin | Platform identifier, fixed value. |
action | body | string | Yes | product_search | Capability identifier, fixed value. |
keyword | body.params | string | Yes | - | A Douyin product search phrase. Results form an independent product pool and do not establish that any specified creator promoted or sold those items. |
page | body.params | integer | No | - | Page number from 1 to 17, with up to 30 products a page. It reads that page directly as one call; when page_token is also sent, the token wins. Search ranking keeps shifting, so two neighbouring pages read by number can share a few products; use next_page_token to move forward without repeats. |
page_token | body.params | string | No | - | Page token for product_search. Leave it out for the first page, then pass back the previous response's next_page_token exactly as received, keeping keyword unchanged. Each page holds up to 30 products and is one call; products already returned are not repeated, and one keyword gives about 500 products at most. Tokens last 24 hours; the last page has none. |
Code samples
#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": "美食"
}
}'OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.
Response example
#{ "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" } ], "next_page_token": …, "pagination": { … }, "count": 5, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Response fields
#Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.
| Field | Meaning |
|---|---|
next_page_token | Page token (search / user_posts / comments / comment_replies / billboard_video_hot / billboard_low_fan_explosion / billboard_high_completion / billboard_account_search / music_search): pass it back unchanged as page_token to fetch the next page, keeping the other parameters the same; valid for 24 hours. Every row of a page carries the same value, which also appears at the top level of the response. Absent on the last page. Comment pages walk all top-level comments page by page. |
product_id | Stable Douyin Mall product ID. |
promotion_id | Keeps the platform's own meaning |
title | Title. null when the platform has no titles (for example text-only posts). |
url | Link to the record on the platform. |
image_url | Image link. Capabilities with several images may return an image_urls array. |
white_image_url | Keeps the platform's own meaning |
price_cny | Displayed product price in yuan. |
price_cny_minor | Keeps the platform's own meaning |
price_label | Keeps the platform's own meaning |
monthly_sales | Keeps the platform's own meaning |
good_review_ratio | Keeps the platform's own meaning |
sales_trend | Keeps the platform's own meaning |
category_path | Keeps the platform's own meaning |
category_ids | Product category ID path, in the same order as category_path (product_search). |
category_depth | Keeps the platform's own meaning |
shop_id | Douyin Mall shop ID. |
shop_name | Douyin Mall shop name. |
shop_logo_url | Keeps the platform's own meaning |
shop_score | Keeps the platform's own meaning |
commission_rate_percent | Keeps the platform's own meaning |
commission_cny | Keeps the platform's own meaning |
cooperating_creator_count | Keeps the platform's own meaning |
tags | Array of tags. An empty array, not null, when there are none. |
source_keyword | The search term this row matched. |
search_rank | Keeps the platform's own meaning |
recommend_reason | The recommendation reason shown on the product search result (product_search); absent when there is none. |
platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
Errors and billing
#- 401
- Missing or invalid key.
- 402
- Insufficient balance. Top up first.
- 422
- Invalid parameter name or value. Fix it using the suggestions in the error. No charge.
- 429
- Per-minute request limit reached. Wait for Retry-After, then try again.
- 503
- Could not complete. The held charge is returned to your balance. If the outcome is unknown, verify it before you retry.
- 200 empty
- No data. No charge.