Skip to contentLurkAPI
Skip to the playground
Docs · all pages

TikTok Shop store products

A US TikTok Shop store's products with prices, ratings and sales, 20 per page, plus the store's totals.

1 credit per callFresh within 15 minutes

TikTok Shop store products
5 free tries a day, no signup

A real response, captured from the live API.

When 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.

Example request

Copy one and replace YOUR_API_KEY with your API key (get one free). The code versions read the key from the LURKAPI_API_KEY environment variable instead.

Language

Parameters

Add them to the URL after a ?. Join several with &.

ParameterDescription
url
stringrequired
The store's URL, e.g. https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079, or its numeric seller id.
Example
https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079
cursor
stringoptional
The cursor from the previous response, to get the next page.

Example response

A real response, captured from the live API. Lists are trimmed to a couple of items, and long text such as media links is cut short with ….

Show the example response (2 KB)
{
  "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 in a successful response, and what it means. A name with [] belongs to each item of a list: products[].id is the id of every item in products. null means there's no value.

Show all 34 fields
FieldTypeDescription
successtrueAlways true here; errors have success: false.
credits_remainingnumberYour balance after this call. On anonymous playground calls: free tries left today.
credits_chargednumberCredits this call cost; 0 on free endpoints. On anonymous playground calls: tries used (1).
shopobjectThe store.
shop.idstringSeller id.
shop.namestringStore name.
shop.urlstringThe store on tiktok.com.
shop.logostringcan be nullStore logo URL; null if none.
shop.labelstringcan be nullTikTok's badge for the store, e.g. OFFICIAL SHOP; null if none.
shop.ratingnumbercan be nullStore rating out of 5; null when unavailable.
shop.review_countnumbercan be nullProduct reviews across the store.
shop.sold_countnumbercan be nullLifetime items sold across the store.
shop.follower_countnumbercan be nullStore followers.
shop.video_countnumbercan be nullVideos featuring the store's products.
shop.product_countnumbercan be nullProducts on sale.
shop.tiktok_user_idstringcan be nullNumeric id of the brand's official TikTok account; null if none.
productsobject[]Products, in the store page's order.
products[].idstringTikTok Shop product id. Pass it to TikTok Shop product for variants, description and specifications.
products[].titlestringProduct name.
products[].urlstringThe product on shop.tiktok.com.
products[].imagestringcan be nullMain product image URL; null if none.
products[].priceobjectLogged-out US storefront price; checkout discounts and shipping can differ.
products[].price.currencystringcan be nullCurrency code, e.g. USD; null when unavailable.
products[].price.amountstringcan be nullLowest variant sale price as a decimal string, e.g. 19.47; null when unavailable.
products[].price.original_amountstringcan be nullPrice before discount as a decimal string; null without a discount.
products[].price.discountstringcan be nullDiscount as TikTok shows it, e.g. 21%; null without one.
products[].ratingnumbercan be nullProduct rating out of 5; null without reviews.
products[].review_countnumbercan be nullProduct reviews; null when unavailable.
products[].sold_countnumbercan be nullLifetime items sold; null when unavailable.
products[].sellerobjectThe store selling it.
products[].seller.idstringSeller id. Pass it as url to TikTok Shop store products for the whole catalog.
products[].seller.namestringcan be nullStore name; null when unavailable.
has_morebooleanThe store has more products after this page.
cursorstringcan be nullPass as cursor for the next page. null on the last page.

Pagination

Results come in pages. For the next page, repeat the call with the same parameters and add the response's cursor as cursor. On the last page, cursor is null. Each page costs 1 credit.

The first five pages, in JavaScript
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_API_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}

Cost and freshness

Each call costs 1 credit. Calls turned away before they reach the platform (invalid parameters, a key or balance problem, a rate limit) are free, and so are 5xx errors. A not_found is charged, since the platform was checked. How charging works.

Answers are cached for up to 15 minutes. A repeat call within that time can return the same data, and costs the same.

Errors

A failed call returns success: false, an error message, a code your program can check, and a docs link. These are the errors this endpoint can return. All error codes.

StatusCodeMeaning
401missing_api_keyNo API key was sent. Put it in the x-api-key header.
401invalid_api_keyThis key doesn't exist or was revoked.
402insufficient_creditsNot enough credits for this call. Buy a pack, or wait for tomorrow's free top-up.
402over_max_creditsThis call would cost more than the max_credits you set. The error says what it needs; raise max_credits to allow it. Not charged.
403account_suspendedThis account is suspended. Email support@lurkapi.com. Not charged.
404not_foundWhat you asked for (a post, an ad, a subreddit) doesn't exist, or there's no endpoint at that path. Charged if the platform was checked.
405method_not_allowedEndpoints only take GET, with parameters in the URL.
429rate_limitedToo many calls in a short time. Wait as many seconds as the retry-after header says, then retry.
500internal_errorSomething broke on our side. Retry. Not charged.
502upstream_errorThe platform didn't send a usable answer. Retry. Not charged.
503upstream_busyAll our connections to the platform are busy. Retry in a few seconds. Not charged.
504upstream_timeoutThe platform took over 30 seconds to answer (90 for web pages). Retry. Not charged.

Use it in Claude

Connect LurkAPI to Claude and ask in plain English. This endpoint is the tiktok_shop_products tool. For example:

Ask Claude
Use LurkAPI's tiktok_shop_products tool with url "https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079", then summarize what you find.

Claude calls tiktok_shop_products with arguments like these, and each call costs 1 credit:

Tool arguments
{"url": "https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079"}

To save tokens, tool results leave out empty fields, keep one URL per image or video, and give 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 next part, and later parts are free for 15 minutes. Pass trim=false for the full response.

From the blog

All posts