Douyin Monthly Product Sales

Douyin → Douyin Monthly Product Sales → dataset=douyin

Document ID: agent.dataset.douyin

Authenticated runtime tools and each query response are authoritative for tenant scope and current data coverage.

Query capabilities

Time grain: month
Entity types: productshop
Filter fields: product_idshop_idbrandcategory_l1_idcategory_l1category_l2_idcategory_l2category_l3_idcategory_l3category_l4_idcategory_l4shop
Searchable value fields: brandcategory_l1category_l2category_l3category_l4shop
Exact reference formats: douyin_product_id

Minimal call

This is an executable request shape; adjust its scope to the user's question.

query_metrics

{
  "dataset": "douyin",
  "group_by": [
    "brand"
  ],
  "limit": 10,
  "metrics": [
    "gmv"
  ],
  "order_by": [
    {
      "dir": "desc",
      "field": "gmv"
    }
  ],
  "task_query": "查看抖音最近一个完整月的品牌销售额排名",
  "time": {
    "last_complete_months": 1
  }
}

Credit consumption pricing

Loading active pricing; this page has no fallback prices.

Query Patterns

aggregate_drilldown

Aggregate and product drilldown

Query a category scope, then rank products under the same filters.

brand_share

Brand share

Compute brand share from two atomic GMV results.

category_product_ranking

Category product ranking

Rank exact product IDs within a resolved category.

shop_name_performance

Shop performance by name

Resolve a shop name and query monthly metrics.

Fields and capabilities

product_ididentifier: Stable Douyin product identifier intended for exact filtering and paired with product_url.
aggregate-select · group-by · aggregate-filter=eq,in
titleattribute: Product title recorded for the month; intended for output, not title search.
aggregate-select · group-by · requires-group-by=product_id
product_urlattribute: Douyin product-detail URL supplied by the upstream record and paired with product_id.
aggregate-select · group-by · requires-group-by=product_id
shop_ididentifier: Stable Douyin shop identifier intended for exact filtering; a verified shop_url is not currently available.
aggregate-select · group-by · aggregate-filter=eq,in
branddimension: Brand name recorded by the upstream Douyin data; the current source does not provide a matching brand_id.
aggregate-select · group-by · aggregate-filter=eq,neq,in,not_in,contains · search
category_l1_ididentifier: Identifier of category_l1 in the upstream Douyin category hierarchy; it may be missing.
aggregate-select · group-by · aggregate-filter=eq,in
category_l1dimension: Level-1 category name in the upstream Douyin hierarchy, paired with category_l1_id.
aggregate-select · group-by · aggregate-filter=eq,neq,in,not_in,contains · search
category_l2_ididentifier: Identifier of category_l2 in the upstream Douyin category hierarchy; it may be missing.
aggregate-select · group-by · aggregate-filter=eq,in
category_l2dimension: Level-2 category name in the upstream Douyin hierarchy, paired with category_l2_id.
aggregate-select · group-by · aggregate-filter=eq,neq,in,not_in,contains · search
category_l3_ididentifier: Identifier of category_l3 in the upstream Douyin category hierarchy; it may be missing.
aggregate-select · group-by · aggregate-filter=eq,in
category_l3dimension: Level-3 category name in the upstream Douyin hierarchy, paired with category_l3_id.
aggregate-select · group-by · aggregate-filter=eq,neq,in,not_in,contains · search
category_l4_ididentifier: Identifier of category_l4 in the upstream Douyin category hierarchy; it may be missing.
aggregate-select · group-by · aggregate-filter=eq,in
category_l4dimension: Level-4 category name in the upstream Douyin hierarchy, paired with category_l4_id.
aggregate-select · group-by · aggregate-filter=eq,neq,in,not_in,contains · search
shopdimension: Shop name recorded by Douyin and paired with shop_id; it may change over time.
aggregate-select · group-by · aggregate-filter=eq,neq,in,not_in,contains · search
monthtime: Calendar month to which the product record belongs, formatted as YYYY-MM; the public dataset grain is monthly.
aggregate-select · group-by
gmvmeasure: Planned sales-amount metric; currency, discount treatment, and source-snapshot aggregation rules must be confirmed before runtime activation.
aggregate-select
unitsmeasure: Planned units-sold metric; whether the source snapshot is incremental or cumulative must be confirmed before runtime activation.
aggregate-select
aspmeasure: Planned weighted average selling price; its formula and currency must be confirmed before runtime activation.
aggregate-select

Known unavailable fields

brand_idunavailable: Required to pair with brand, but the current Douyin source does not provide a brand identifier.
shop_urlunavailable: Required to pair with shop_id, but the current Douyin source does not provide a verified canonical shop URL.
specificationunavailable: Required product specification attributes are not present in the current Douyin source.

Limitations

Data is partitioned by calendar month.
Product filtering supports exact product_id only; names, aliases, product URLs, and fuzzy search are not supported.
Shops accept an exact shop_id or a shop name aligned with search_values.
Reviews, traffic, inventory, causal explanations, and other platform data are not provided.
YoY, MoM, share, contribution, and cross-period set differences are computed by the Agent from atomic query results.
Metric definitions, coverage volume, refresh timing, and access entitlement are pending upstream confirmation.
The current release contains only the first four days of 2026-06 and is incomplete.