API Platform

Build with TikTok Shop product data

Call product search and category endpoints with a scoped Ecomblade API key. Use the returned marketplace data in internal tools, analysis pipelines, and research workflows.

Start free Overview

Authentication and access

Get API access

API Platform access requires an eligible Ecomblade plan. Create a key in the authenticated API Platform, save the secret when it is shown, and send it as a Bearer token. Keys can be revoked from the same workspace.

GET/api/v1/products/searchProduct search · platform, query, country, page=1, sort?

GET/api/v1/products/categoryCategory products · platform, categoryId, country, page=1

Example request

curl --get 'https://api.ecomblade.com/api/v1/products/search?platform=tiktok&query=wireless+earbuds&page=1&country=ID' \
  --header 'Authorization: Bearer $ECOMBLADE_API_KEY'

Data returned by the API

Example response

Responses contain normalized product fields plus marketplace-specific data. Depending on the source, useful fields include product identity, URLs, images, price, currency, ratings, reviews, sales and revenue signals, store details, and pagination state.

JSON

{
  "success": true,
  "data": {
    "region": "id",
    "items": [
      {
        "itemId": "prod-10001",
        "name": "Wireless Noise-Cancelling Earbuds",
        "slug": "wireless-noise-cancelling-earbuds",
        "url": "https://marketplace.example/products/prod-10001",
        "brand": "Example Audio",
        "image": "https://cdn.example.com/products/prod-10001.jpg",
        "shopId": "shop-501",
        "shopName": "Example Audio Official",
        "price": 475000,
        "originalPrice": 625000,
        "discount": 25,
        "currency": "IDR",
        "sold": 1280,
        "monthlySold": 340,
        "totalSold": 4620,
        "revenue": 608000000,
        "monthlyRevenue": 161500000,
        "totalRevenue": 2194500000,
        "listingDate": "2026-01-15T00:00:00.000Z",
        "reviews": 894,
        "marketplaceData": {
          "tiktok": {
            "rating": 4.8,
            "like": 920,
            "comment": 415,
            "stock": 680,
            "stockValue": 323000000,
            "location": "Jakarta"
          }
        }
      }
    ],
    "hasFullAccess": true,
    "isLimited": false
  }
}

Useful marketplace signals

Errors and usage limits

Invalid parameters, expired or revoked credentials, plan access, rate limits, upstream parsing, and exhausted pages return explicit HTTP error responses. Clients should check the response status, respect Retry-After when present, and avoid assuming that every marketplace returns identical optional fields.

Available regions

Indonesia

Access TikTok Shop product search and category data for Indonesia using country code ID.

Explore

Malaysia

Access TikTok Shop product search and category data for Malaysia using country code MY.

Explore

the Philippines

Access TikTok Shop product search and category data for the Philippines using country code PH.

Explore

Singapore

Access TikTok Shop product search and category data for Singapore using country code SG.

Explore

Thailand

Access TikTok Shop product search and category data for Thailand using country code TH.

Explore

Vietnam

Access TikTok Shop product search and category data for Vietnam using country code VN.

Explore

Frequently asked questions

Which endpoints support TikTok Shop?

Ecomblade exposes GET /api/v1/products/search and GET /api/v1/products/category for TikTok Shop. Marketplace-specific query parameters are documented in the authenticated API Platform.

Get API access

Choose an eligible plan to create API keys and connect marketplace data to your workflow.

Get API accessNo credit card required.