logo
EN

Douyin Shop Product List Scraper

Enter a Douyin Shop ID and a target product count to collect product titles, price text, links, and shop information.

Developer
Pricing
From $0.07 / 10 records
Last updated
2026-11-12

Overview

Reviewing a Douyin shop one product page at a time makes it difficult to see the overall assortment. This app brings listing titles, price text, and product links together in a product catalog that you can search and compare. It provides a starting point for examining how a shop presents its range, without manually assembling a list from individual pages.

Product information stays alongside its shop details and collection time. Titles retain their original wording, including packaging, specifications, and selling points when present. Product IDs and links help you locate individual items, while the collected rows provide a working reference for later classification and review.

Data notes

Data comes from the specified Douyin shop’s product listing and is returned in ascending collection-time order. Prices remain original text and should not be treated as final checkout amounts. Displayed counts also retain their original wording and may refer to favorites, so they should not be summed as sales.

Category, Shop name, and Displayed count may be null. Some rows may also lack a Product ID or Product title. A No-data flag of “No” does not guarantee complete information: inspect the individual values before using a row in comparisons. Blank values are missing information, not evidence that a product has no category or no activity.

Example results

A row normally represents one product in the shop listing. These examples show rows with product information present; the product titles remain in their original language.

Product IDProduct titlePrice textShop ID
3627198054584690156【一颗大™】串收樱桃番茄现摘水果爆汁小西红柿车厘串茄净重198g/盒59.965581140
3723352744359231647【一颗大™】串收樱桃番茄甄选礼盒西红柿自然熟1kg/2kg顺丰京东39.965581140
3689257000585265330【一颗大™】串收樱桃番茄散串组合酸甜爆汁水小西红柿39.965581140

Other fields include Product URL, Shop URL, Crawl time, and Displayed count.

Use cases

  • To organize an assortment, group Product title by category, specification, or packaging, then use Product URL to check the individual item.
  • To compare price distributions, first check that Price text contains comparable numeric values. Use Product title to distinguish sizes or packs before combining prices in an analysis.
  • For periodic shop reviews, compare Crawl time, Product ID, and Product title across collections. Review rows with missing IDs separately rather than assuming they identify the same product.

Scope and boundaries

One shop per run; request 1–500 products. Actual results may be higher or lower. Fetch protection capacity is 100 pages / 2000 records; reaching this capacity may leave results incomplete. Some records may have missing information.

  • Good for
  • When you need a product catalog for a specific Douyin shop.
  • When you need to compare shop assortments and displayed prices.
  • Do not use for
  • When you need orders, transaction details, or directly aggregatable sales counts.
  • When you need complete variants, inventory, or final prices after discounts.

Failure handling

Failure and retry behavior declared by the developer. We recommend including it in your system prompt when integrating.

  1. 1If results are empty or incomplete, check the Shop ID and inspect both the no-data flag and individual field values.
  2. 2If submission is uncertain or status checking times out, check the existing task before submitting again; every new run creates a new task and incurs a start fee.
  3. 3For authentication failures, ask the publisher to check credentials and access permissions; changing the Shop ID will not resolve them.
  4. 4Partial success retains the available results. Check what is missing before collecting again; a new run incurs another start fee.

Input

Parameters required to call this App, generated from the input.schema in manifest.json.

  • Shop IDshop_idRequiredstring
    The Douyin Shop ID to collect. Enter one ID, 1–512 characters long, rather than a full URL.
    Example65581140
  • Target product countcrawl_countRequiredinteger
    The number of products you would like to collect, from 1 to 500. Actual results may be higher or lower.
    Range1–500Example1

Output

Field structure of a single record, generated from the output.schema in manifest.json.

  • Categorycategorystring
    Original product category text; may be null.
  • Crawl timecrawl_timestring
    Original collection time text with no specified time zone; may be null.
    Example2026-11-12T15:00:17
  • Record time valuecreated_atinteger
    The original createdAt integer. Its time unit and time zone are unspecified; may be null.
    Example1794466817997
  • Price textpricestring
    Original product price text. Currency and discount treatment are unspecified; may be null.
    Example59.9

Sample data

Generated from output.schema. Fields without a sample value use structural placeholders.

output.example
{
  "category": "<category>",
  "crawl_time": "2026-11-12T15:00:17",
  "created_at": 1794466817997,
  "price": "59.9",
  "product_title": "【一颗大™】串收樱桃番茄现摘水果爆汁小西红柿车厘串茄净重198g/盒",
  "product_url": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=3627198054584690156",
  "root_url": "https://haohuo.jinritemai.com/views/shop/index?id=65581140",
  "sale_count": "<sale_count>",
  "shop_id": "65581140",
  "shop_name": "<shop_name>",
  "spu_id": "3627198054584690156",
  "task_meta_item": "65581140",
  "task_meta_no_data": false
}

Integration

This App can be integrated via MCP, API, SDK, or file export. All channels share the same capabilities and pricing. Every request authenticates with the Authorization: Bearer header using an API key (long-lived, created in the Data Hub Console); MCP clients can also sign in with OAuth, no key required. More options such as CLI and Skill are on the way. This App runs asynchronously and can be canceled midway: After you cancel, the run stops. Records already delivered are kept and billed.

With the MCP (Model Context Protocol), you can call this App directly from AI clients like Claude and Cursor. Pick your client and auth mode, then copy the config below.

Client config

Replace the value after Bearer with your long-lived API key. Works in any client, CI, or headless environment.

mcpServers config
{
  "mcpServers": {
    "octoparse_datahub": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=hello_moto/dyshop-shop-product-list",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

Let AI set it up for you

Don't want to edit configs by hand? Copy the install prompt and paste it into any AI client. It will complete the setup its own way. (By default it guides you through signing in, and never asks you to send your API key in the chat.)

detail.access.mcp.composeHint

Pricing

Start one collection task

Charged once per submitted run, regardless of how many records are returned.

$0.0001/ run
returned 10 products

Charged by the number of records successfully returned. Failed runs are not charged. Billed in units of 10 records; any partial unit is rounded up to 10 records.

$0.07/ 10 records

Multiple billing events accumulate independently. See each item for details. Failed runs are not charged.

View credits

Try it now

Fill in the parameters and run. Results come from a real call.

Example
Parameters are validated against input.schema before submission
From $0.07 / 10 records