Docs · TikTok Shop store products
TikTok Shop store products
A US TikTok Shop store's products with prices, ratings and sales, 20 per page, plus the store's totals.
https://api.lurkapi.com/v1/tiktok/shop/productsWhen to use this
Use it to audit a brand's TikTok Shop catalog: every product it sells with price, discount, rating, reviews and lifetime sales, and the store's own followers, rating and sales. Products come in the store page's order, best sellers first.
Pass the store's URL (https://www.tiktok.com/shop/store/<name>/<id>, or its shop.tiktok.com/us/store/… form) or its seller id, which every TikTok Shop product carries as seller.id.
Pagination. 20 products per page. Pass the response's cursor back as cursor (with the same url) for more; has_more is false at the end.
US stores only. An unknown store returns 404 not_found.
Parameters
All parameters go in the query string.
| Parameter | Description |
|---|---|
urlstringrequired | The store's URL, e.g. https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079, or its numeric seller id.
|
cursorstringoptional | The cursor from the previous response, to get the next page. |
Example request
Replace YOUR_API_KEY with your key, or set LURKAPI_KEY for the code. Get a free key.
curl "https://api.lurkapi.com/v1/tiktok/shop/products?url=https%3A%2F%2Fwww.tiktok.com%2Fshop%2Fstore%2Fgoli-nutrition%2F7495794203056835079" \
-H "x-api-key: YOUR_API_KEY"const params = new URLSearchParams({
url: "https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079",
});
const res = await fetch(`https://api.lurkapi.com/v1/tiktok/shop/products?${params}`, {
headers: { "x-api-key": process.env.LURKAPI_KEY },
});
const data = await res.json();
if (!data.success) throw new Error(`${data.code}: ${data.error}`);
console.log(data.products);import os
import requests
res = requests.get(
"https://api.lurkapi.com/v1/tiktok/shop/products",
params={
"url": "https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079",
},
headers={"x-api-key": os.environ["LURKAPI_KEY"]},
timeout=60,
)
data = res.json()
if not data["success"]:
raise RuntimeError(f"{data['code']}: {data['error']}")
print(data["products"])Example response
A real response from this endpoint, captured from the live API and trimmed to a couple of items. Strings over 96 characters (mostly signed media URLs) are cut short and end in ….
Show the example response (2 KB)Hide
{
"success": true,
"credits_remaining": 999983,
"credits_charged": 1,
"shop": {
"id": "7495794203056835079",
"name": "Goli Nutrition",
"url": "https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079",
"logo": "https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx…",
"label": "OFFICIAL SHOP",
"rating": 4.6,
"review_count": 411591,
"sold_count": 5793965,
"follower_count": 601249,
"video_count": 5357,
"product_count": 52,
"tiktok_user_id": "6990310143721063429"
},
"products": [
{
"id": "1729527313880355335",
"title": "Goli Ashwagandha & Vitamin D Gummy - Mixed Berry, KSM-66, Vegan, Plant B…",
"url": "https://shop.tiktok.com/us/pdp/ashwagandha-gummies-by-goli-ksm-66-mixed-…",
"image": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx…",
"price": {
"currency": "USD",
"amount": "19.47",
"original_amount": "24.7",
"discount": "21%"
},
"rating": 4.5,
"review_count": 94576,
"sold_count": 1305268,
"seller": {
"id": "7495794203056835079",
"name": "Goli Nutrition"
}
},
{
"id": "1731194857673101831",
"title": "Goli Zero Sugar Best Seller Trio – Daily Gut & Wellness Support with Pre…",
"url": "https://shop.tiktok.com/us/pdp/zero-sugar-best-seller-trio-goli-ashwagan…",
"image": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx…",
"price": {
"currency": "USD",
"amount": "49.37",
"original_amount": "74.1",
"discount": "33%"
},
"rating": 4.4,
"review_count": 48871,
"sold_count": 1037584,
"seller": {
"id": "7495794203056835079",
"name": "Goli Nutrition"
}
}
],
"has_more": true,
"cursor": "20_WzM3NTMwLDU3MDAwMDAwLDE3NDczMzM3MDQzMDAsIjE3MzExNzM3MDM0NzU5NTgyNzkiXQ=="
}Response fields
Every field of a successful response. [] marks a list: a[].b is the b of each item in a. nullable fields can be null; optional fields can be missing.
Show all 34 fieldsHide
| Field | Type | Description |
|---|---|---|
| success | true | Always true here; errors have success: false. |
| credits_remaining | number | Your balance after this call. On anonymous playground calls: free tries left today. |
| credits_charged | number | Credits this call cost; 0 on free endpoints. On anonymous playground calls: tries used (1). |
| shop | object | The store. |
| shop.id | string | Seller id. |
| shop.name | string | Store name. |
| shop.url | string | The store on tiktok.com. |
| shop.logo | stringnullable | Store logo URL; null if none. |
| shop.label | stringnullable | TikTok's badge for the store, e.g. OFFICIAL SHOP; null if none. |
| shop.rating | numbernullable | Store rating out of 5; null when unavailable. |
| shop.review_count | numbernullable | Product reviews across the store. |
| shop.sold_count | numbernullable | Lifetime items sold across the store. |
| shop.follower_count | numbernullable | Store followers. |
| shop.video_count | numbernullable | Videos featuring the store's products. |
| shop.product_count | numbernullable | Products on sale. |
| shop.tiktok_user_id | stringnullable | Numeric id of the brand's official TikTok account; null if none. |
| products | object[] | Products, in the store page's order. |
| products[].id | string | TikTok Shop product id. Pass it to TikTok Shop product for variants, description and specifications. |
| products[].title | string | Product name. |
| products[].url | string | The product on shop.tiktok.com. |
| products[].image | stringnullable | Main product image URL; null if none. |
| products[].price | object | Logged-out US storefront price; checkout discounts and shipping can differ. |
| products[].price.currency | stringnullable | Currency code, e.g. USD; null when unavailable. |
| products[].price.amount | stringnullable | Lowest variant sale price as a decimal string, e.g. 19.47; null when unavailable. |
| products[].price.original_amount | stringnullable | Price before discount as a decimal string; null without a discount. |
| products[].price.discount | stringnullable | Discount as TikTok shows it, e.g. 21%; null without one. |
| products[].rating | numbernullable | Product rating out of 5; null without reviews. |
| products[].review_count | numbernullable | Product reviews; null when unavailable. |
| products[].sold_count | numbernullable | Lifetime items sold; null when unavailable. |
| products[].seller | object | The store selling it. |
| products[].seller.id | string | Seller id. Pass it as url to TikTok Shop store products for the whole catalog. |
| products[].seller.name | stringnullable | Store name; null when unavailable. |
| has_more | boolean | The store has more products after this page. |
| cursor | stringnullable | Pass as cursor for the next page. null on the last page. |
Pagination
Pass the response's cursor back as cursor, with the other parameters unchanged, for the next page. It's null on the last page. Each page costs 1 credit.
let cursor = null;
for (let page = 1; page <= 5; page++) {
const params = new URLSearchParams({ url: "https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079" });
if (cursor) params.set("cursor", cursor);
const res = await fetch(`https://api.lurkapi.com/v1/tiktok/shop/products?${params}`, {
headers: { "x-api-key": process.env.LURKAPI_KEY },
});
const data = await res.json();
if (!data.success) throw new Error(`${data.code}: ${data.error}`);
console.log(data.products);
cursor = data.cursor;
if (!cursor) break; // last page
}Caching and freshness
Responses are cached for up to 15 minutes, so a repeat call within that window can return the same data. It still costs 1 credit.
Errors
Errors return { success: false, error, code, docs } with the HTTP status below. Validation errors, 401/402/429 rejections and 5xx failures are free; not_found is charged (how charging works). All error codes.
| Status | Code | Meaning |
|---|---|---|
| 401 | missing_api_key | No API key. Send it in the x-api-key header. |
| 401 | invalid_api_key | The key is unknown or was revoked. |
| 402 | insufficient_credits | Not enough credits for this call. Buy a pack or wait for tomorrow's top-up. |
| 403 | account_suspended | This account is suspended. Contact support@lurkapi.com. Never charged. |
| 404 | not_found | The endpoint, or the thing you asked for (ad, post, subreddit), doesn't exist. Charged when the platform was checked. |
| 405 | method_not_allowed | Endpoints take GET with query params. |
| 429 | rate_limited | Too many calls at once. Wait for the retry-after seconds, then retry. |
| 500 | internal_error | Something broke on our side. Retry; 5xx errors are free. |
| 502 | upstream_error | The platform didn't give a usable answer. Retry; 5xx errors are free. |
| 503 | upstream_busy | All our connections to the platform are busy. Retry in a few seconds; 5xx errors are free. |
| 504 | upstream_timeout | The platform took over 30 seconds to answer (90 for web pages). Retry; timeouts are free. |
Use it in Claude
Once LurkAPI is connected to Claude, this endpoint is the tiktok_shop_products tool. Ask in plain English, for example:
Use LurkAPI's tiktok_shop_products with url "https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079" and summarize what you find.Claude calls tiktok_shop_products with arguments like these, and each call costs 1 credit:
{
"url": "https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079"
}Tool results are compact to save tokens: no nulls or empty lists, one URL per image or video, transcripts as plain text unless you pass timestamps=true. A result over 45,000 characters comes in parts: its _note gives the offset for the rest, and later parts are free for 15 minutes. trim=false returns the full response.
From the blog
All posts
· 5 min read
Is web scraping legal? The social media cases so far
In the US, scraping public pages while logged out is likely not hacking. Scrapers get sued over terms they accepted, fake accounts and, now, bot checks.

· 4 min read
How to see followers on Snapchat (and why the tab may be missing)
Tap your Bitmoji, then View All under Friends & Followers, then Followers. No Followers tab means you don’t have a Public Profile.

· 5 min read
Why youtube-transcript-api gets blocked on servers, and what works
YouTube sends cloud IPs a bot check, so youtube-transcript-api raises RequestBlocked. Cookies are off in 1.2.4; use residential proxies or a hosted API.