Douyin Shop store products API

Read the products of one Douyin Mall shop by shop_id, page by page. Each row has title, price_cny and monthly_sales, plus shop_product_count and shop_page_count, for $8 per 1,000 calls.

  • shop_product_count is the number of products in the shop and shop_page_count is its page count.
  • shop_id comes from product_search or product_detail, not from a shop name.
  • Failed calls and empty results are not charged.

API health

24h health
Normal
  • Healthy / normal
  • Available
  • Limited
  • Mostly down
Normal

Last 24 hours

Last 30 days

  1. 1Request

    POST /api/v1/social
    {
      "platform": "douyin",
      "action": "shop_products",
      "params": {
        "shop_id": "84535208"
      }
    }
  2. 2JSON response

    {
      "results": [
        {
          "next_page_token": string,
          "product_id": string,
          "promotion_id": string,
          "title": string
        },
        …
      ]
    }
  3. 3Rows

    next_page_tokenproduct_idpromotion_idtitle
    stringstringstringstring
  4. 4CSV

    douyin-shop_products-sample.csv next_page_token,product_id,promotion_id,title,url,image_url,price_cny,price_cny_minor,monthly_sales,tags,shop_id,shop_product_count,shop_page_count,platform

A request with shop_id goes in, and one page of that shop's products comes back; each row in results is one product, listed as a field table and a CSV file.

What data you get

This endpoint has no public real sample yet. The table lists the fields, types and meanings that each row returns, with no values.

FieldTypeMeaning
next_page_tokenstringPage 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_idstringStable Douyin Mall product ID.
promotion_idstringKeeps the platform's own meaning
titlestringTitle. null when the platform has no titles (for example text-only posts).
urlstringLink to the record on the platform.
image_urlstringImage link. Capabilities with several images may return an image_urls array.
price_cnynumberDisplayed product price in yuan.
price_cny_minornumberKeeps the platform's own meaning
monthly_salesnumberKeeps the platform's own meaning
tagsarrayArray of tags. An empty array, not null, when there are none.
shop_idstringDouyin Mall shop ID.
shop_product_count—Keeps the platform's own meaning
shop_page_count—Keeps the platform's own meaning
platformstringSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).

Use cases

  • List every product in a shop

    Follow next_page_token page by page; the page with no next_page_token is the last one.

  • Estimate the size of a shop

    Read shop_product_count and shop_page_count to learn how many products the shop lists and how many pages it has, without paging through it.

  • Watch a competitor shop's prices

    Read the same shop on a schedule and compare the change in price_cny and monthly_sales per product.

  • Go deeper into a shop from a search

    Find a product with product_search, take its shop_id and read the other products of that shop here.

Doudian Open Platform vs EveryInfra

Here is how the Doudian Open Platform documentation and EveryInfra shop_products compare on whose shop is read.

ComparedDoudian Open PlatformEveryInfra
Whose shopThe documentation says the endpoint does a batch query of the shop product information of a merchant.shop_id names one Douyin Mall shop. The request holds only your EveryInfra API key and shop_id, and you read the products that shop shows publicly.

The Doudian Open Platform documentation is in Chinese. The table shows a translation, checked against the page on 2026-11-22. The update date comes from the page itself. Official sources: product/listV2: batch query of the product list (updated 2026-11-05)

Limits and gotchas

  • shop_id is required. It is the numeric ID of a Douyin Mall shop, not a shop name.
  • Paging: send page to fetch that page directly. To go on, pass the returned next_page_token back as page_token with the other parameters unchanged; a token works for 24 hours.
  • When you send both page and page_token, the token wins.
  • The last page has no next_page_token. For the page count, read shop_page_count.
  • shop_product_count and shop_page_count are the same on every row. They describe the whole shop, not the rows on this page.
  • monthly_sales is the product's sales over the last 30 days, not a number of buyers.

Pricing

You pay $0.008 per call, not per row, and each page is one call. Failed calls and empty results are not charged.

CallsCost
10,000$80.00
100,000$800.00
1,000,000$8,000.00

Totals use the list price per call.

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": "shop_products",
  "params": {
    "shop_id": "84535208"
  }
}'

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

API reference

See the parameters, response fields, errors and billing for shop_products, and copy the page or open it as Markdown for an AI assistant.

POST

AI prompt

#
Please help me write a data collection script with the EveryInfra Douyin Shop store products endpoint (douyin/shop_products).

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 shop_products, and put the parameters inside params.
- Required parameters:
  - shop_id: The numeric ID of a Douyin Mall shop, taken from the shop_id of a product_search or product_detail row. It is not a shop name.
- Optional parameters:
  - page: Page number starting at 1, with 10 products a page; the number of pages is the shop_page_count on each row. It reads that page directly as one call; when page_token is also sent, the token wins.
  - page_token: Page token for shop_products. Leave it out for the first page, then pass back the previous response's next_page_token exactly as received, keeping shop_id unchanged. Each page holds 10 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, price_cny (Displayed product price in yuan), price_cny_minor, monthly_sales, tags, shop_id (Douyin Mall shop ID), shop_product_count; 13 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=douyin.
- Example request body:
{
  "platform": "douyin",
  "action": "shop_products",
  "params": {
    "shop_id": "84535208"
  }
}
- Price: $8 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.
actionbodystringYesshop_productsCapability identifier, fixed value.
shop_idbody.paramsstringYes-The numeric ID of a Douyin Mall shop, taken from the shop_id of a product_search or product_detail row. It is not a shop name.
pagebody.paramsintegerNo-Page number starting at 1, with 10 products a page; the number of pages is the shop_page_count on each row. It reads that page directly as one call; when page_token is also sent, the token wins.
page_tokenbody.paramsstringNo-Page token for shop_products. Leave it out for the first page, then pass back the previous response's next_page_token exactly as received, keeping shop_id unchanged. Each page holds 10 products and is one call. Tokens last 24 hours; the last page has none.

Response example

#
No sample response is available for these parameters yet. This preview shows the response shape and fields from the API definition, with … as placeholders; it is not the result of a live call.
json
{  "id": "req_…",  "platform": "douyin",  "action": "shop_products",  "results": [    {      "next_page_token": …,      "product_id": …,      "promotion_id": …,      "title": …,      "url": …,      "image_url": …,      "price_cny": …,      "price_cny_minor": …,      "monthly_sales": …,      "tags": …,      "shop_id": …,      "shop_product_count": …,      "shop_page_count": …,      "platform": …    }  ],  "next_page_token": …,  "pagination": { … },  "count": …,  "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.
price_cnyDisplayed product price in yuan.
price_cny_minorKeeps the platform's own meaning
monthly_salesKeeps the platform's own meaning
tagsArray of tags. An empty array, not null, when there are none.
shop_idDouyin Mall shop ID.
shop_product_countKeeps the platform's own meaning
shop_page_countKeeps the platform's own meaning
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

FAQ

What does the Douyin shop products API return?

One page of a shop's products: product_id, promotion_id, title, url, image_url, price_cny, monthly_sales, tags and shop_id; each row also carries shop_product_count, shop_page_count and next_page_token.

Where do I get shop_id?

From the shop_id on a row returned by product_search or product_detail. It is the shop's numeric ID, not its name.

How do I know how many pages a shop has?

Read shop_page_count on any row, or keep paging until the response has no next_page_token.

What does it cost to read a shop?

Each page is one call at $0.008, or $8 per 1,000 calls. Failed calls and empty results are not charged.

You can call the other Douyin endpoints with the same EveryInfra API key.

Google Analytics needs consent. Privacy