One API to scrape
TikTok Shop product pages as JSON, by product ID, in six Southeast Asian markets.
Free trial credits. Catalog and estimates work immediately.
Need monthly sales and market share instead? TikTok Shop market data →
{
"items": [
{
"product_id": "<product_id>",
"country": "id"
}
]
}Your first TikTok Shop request
- 1
Get a key. Sign in and create an API key in the dashboard. New accounts get free trial credits.
- 2
Submit. POST your product IDs and countries to /v1/tiktok/pdp/bulk/submit, up to 2,000 per request. You get a job ID back.
- 3
Retrieve. Poll /v1/tiktok/pdp/bulk/retrieve/{job_id}; when it completes, download the results file from its download_url.
Fetch TikTok Shop product pages
curl -X POST https://api.magpieiq.com/scraping/v1/tiktok/pdp/bulk/submit \
-H "Authorization: Bearer $MAGPIE_API_KEY" -H "Content-Type: application/json" \
-d '{"items": [{"product_id": "<product_id>", "country": "id"}]}'
# -> {"job_id": "...", ...}
curl https://api.magpieiq.com/scraping/v1/tiktok/pdp/bulk/retrieve/<job_id> \
-H "Authorization: Bearer $MAGPIE_API_KEY"import os, time, requests
BASE = "https://api.magpieiq.com/scraping"
H = {"Authorization": f"Bearer {os.environ['MAGPIE_API_KEY']}"}
job = requests.post(f"{BASE}/v1/tiktok/pdp/bulk/submit", headers=H,
json={"items": [{"product_id": "<product_id>", "country": "id"}]}).json()
while True:
r = requests.get(f"{BASE}/v1/tiktok/pdp/bulk/retrieve/{job['job_id']}", headers=H).json()
if r.get("download_url") or r["status"] == "failed":
break
time.sleep(15)
if not r.get("download_url"):
raise SystemExit(f"job {job['job_id']} ended without results: {r}")
print(r["download_url"])TikTok Shop endpoints
Product page
/v1/tiktok/pdp/bulkProduct page data for each TikTok Shop product ID, collected after you submit.
product_idcountryWhat it costs, worked out
1,000 product pages, once
7,000credits
≈ $8.75
500 products every day for 30 days
105,000credits
≈ $131
100 products every week for a month
2,800credits
≈ $3.5
Dollar figures use the Tier 1 credit rate. Pay-as-you-go top-ups cost more per credit and larger packs cost less; the rate card has every pack.
Credits are deducted when you submit; items that fail are refunded.
Limits and processing
- Runs at any time without approval.
- Countries: id, my, sg, th, vn, ph — set per item.
- Up to 2,000 items per request, billed per item.
- Results arrive as a file at download_url once the job completes.
TikTok Shop API questions
Do I need a TikTok Shop seller account?
No. You need a Magpie API key. Sign-up is self-serve and includes free trial credits.
Where do I find a product ID?
It is the number at the end of a TikTok Shop product link, for example shop.tiktok.com/view/product/{product_id}.
Which markets are covered?
Indonesia, Malaysia, Singapore, Thailand, Vietnam and the Philippines. Set the country per item.
Can I monitor prices every day?
Yes. Submit the same product IDs on a schedule and compare the results between runs.
How is it billed?
In prepaid credits from one wallet shared with the Data API, per product. The rate card shows the current price.
Can I get monthly sales totals instead of raw pages?
Yes. The Data API serves monthly GMV, units and market share for TikTok Shop by brand, merchant and SKU, already cleaned and categorised.
Make your first TikTok Shop request today.
Free trial credits. Catalog and estimates work immediately.