TikTok Shop Creator Commerce Proof Graph

Map a TikTok Shop product to the creators and public showcase videos visibly promoting it. Each product row groups repeated creator appearances, totals the observed plays and likes, preserves video evidence, and emits explicit product-to-creator-to-video edges.

Accepted input

productUrls accepts TikTok Shop product page URLs and numeric product IDs. region selects the storefront used for both the product and showcase lookups. Qualification thresholds filter the creator nodes without changing the underlying evidence.

{
  "productUrls": ["https://shop.tiktok.com/us/pdp/1730927783781307026"],
  "region": "US",
  "minCreatorViews": 10000,
  "minCreatorVideos": 2,
  "includeVideoRows": true,
  "maxItems": 20
}

Response fields

Each row represents one submitted product:

• product contains the product ID, public product URL, name, seller, and shop when available.
• promotion contains observed creator and video counts, combined plays and likes, paid-label count, and the thresholds applied.
• creators contains deduplicated creator nodes with observed video totals, engagement, top video, and qualification status.
• edges connects the product, creator, and video using the relation showcase_observed.
• analysis reports the product-detail, showcase, and graph outcomes.
• provenance records the collection outcome for the row.

{
  "record_type": "creator_commerce_proof",
  "product": {
    "product_id": "1730927783781307026",
    "name": "Example serum",
    "seller_id": "7495516049083828882",
    "shop_name": "Example Beauty"
  },
  "promotion": {
    "status": "observed",
    "creator_count": 2,
    "qualified_creator_count": 1,
    "video_count": 3,
    "total_views": 48200,
    "total_likes": 3100,
    "labeled_video_count": 1,
    "thresholds": {
      "min_creator_views": 10000,
      "min_creator_videos": 2
    }
  },
  "edges": [
    {
      "product_id": "1730927783781307026",
      "creator_id": "6234567890123456789",
      "video_id": "7500167942269619486",
      "relation": "showcase_observed"
    }
  ],
  "analysis": {
    "detail": { "status": "ok" },
    "showcase": { "status": "ok" },
    "graph": { "status": "complete" }
  }
}

Evidence boundary

An edge indicates that a video was publicly associated with the product at collection time. It is not proof of a purchase or attributed sale. Engagement totals are the visible play and like counters on the collected videos.

Duplicate video IDs are counted once. Creator nodes are keyed by creator ID when available and otherwise by the public creator name. A product with a successful empty showcase response returns an observed graph with zero creators and zero videos; absence is not converted into a source error.

Behaviour on partial results

If part of a product record is unavailable, available identity or showcase evidence is retained and the row remains partial. Unavailable promotion arrays remain empty rather than being reported as zero observed promotion.

Video IDs, creator IDs, observed counters, timestamps, and evidence edges provide the durable evidence fields in each row.