POST

API health

24h health
Mostly down
  • Healthy / normal
  • Available
  • Limited
  • Mostly down
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

#
NameInTypeRequiredDefaultDescription
AuthorizationheaderstringYes-Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
platformbodystringYesdouyinPlatform identifier, fixed value.
actionbodystringYesproduct_searchCapability identifier, fixed value.
keywordbody.paramsstringYes-A Douyin product search phrase. Results form an independent product pool and do not establish that any specified creator promoted or sold those items.
pagebody.paramsintegerNo-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_tokenbody.paramsstringNo-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

#
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": "美食"
  }
}'

OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.

Response example

#
Captured October 24, 2026 at 19:16 (UTC) by calling this API with the parameters in the code sample above. results and count are that call's real response with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2. id, billing and quota differ on every call, so only their shape is shown.
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"    }  ],  "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.

FieldMeaning
next_page_tokenPage 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_idStable Douyin Mall product ID.
promotion_idKeeps the platform's own meaning
titleTitle. null when the platform has no titles (for example text-only posts).
urlLink to the record on the platform.
image_urlImage link. Capabilities with several images may return an image_urls array.
white_image_urlKeeps the platform's own meaning
price_cnyDisplayed product price in yuan.
price_cny_minorKeeps the platform's own meaning
price_labelKeeps the platform's own meaning
monthly_salesKeeps the platform's own meaning
good_review_ratioKeeps the platform's own meaning
sales_trendKeeps the platform's own meaning
category_pathKeeps the platform's own meaning
category_idsProduct category ID path, in the same order as category_path (product_search).
category_depthKeeps the platform's own meaning
shop_idDouyin Mall shop ID.
shop_nameDouyin Mall shop name.
shop_logo_urlKeeps the platform's own meaning
shop_scoreKeeps the platform's own meaning
commission_rate_percentKeeps the platform's own meaning
commission_cnyKeeps the platform's own meaning
cooperating_creator_countKeeps the platform's own meaning
tagsArray of tags. An empty array, not null, when there are none.
source_keywordThe search term this row matched.
search_rankKeeps the platform's own meaning
recommend_reasonThe recommendation reason shown on the product search result (product_search); absent when there is none.
platformSource 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.

Errors

Our own visit stats are always on. Google Analytics loads only if you choose “Allow analytics”. Privacy policy