# TikTok Shop Store Products API. Products, page by page.

Products a store sells, best sellers first. We handle the proxies, blocks and platform changes.

[Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dtiktokshop.products)

## TikTok Shop Store Products API at a glance

Returns the products a public TikTok Shop store has on sale, best sellers first, from its storefront link or seller ID. Each has its title, price and price before discount, units sold, rating and review count, brand, main image and store, a page at a time.

GET `/v1/tiktokshop/products`

[Read the API reference](https://socialtap.dev/docs/reference/tiktokshop/products/index.md)

- **1 credit** per page, $0.75–$1.97 per 1,000 pages
- **23 typed fields** null when unknown
- **20** products per page, TikTok Shop's store order: best-selling first (units sold, most first)
- **`handle`** is all it needs, e.g. `https://shop.tiktok.com/us/store/goli-nutrition/7495794203056835079`

## Send one request. Get up to 20 products back.

Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free.

`$ npm install socialtap`

`handle = https://shop.tiktok.com/us/store/goli-nutrition/7495794203056835079`

[Open in playground](https://socialtap.dev/playground/?endpoint=tiktokshop.products)

cURL:

```shell
curl -G 'https://socialtap.dev/v1/tiktokshop/products' \
  --data-urlencode 'handle=https://shop.tiktok.com/us/store/goli-nutrition/7495794203056835079' \
  -H "x-api-key: $SOCIALTAP_API_KEY"
```

TypeScript SDK:

```typescript
import { SocialTap } from "socialtap";

const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY

const res = await client.tiktokshop.products.list({ handle: "https://shop.tiktok.com/us/store/goli-nutrition/7495794203056835079" });
console.log(res.data);
console.log(res.credits.charged, res.meta.request_id);
```

Node.js (fetch):

```javascript
const params = new URLSearchParams({
  handle: "https://shop.tiktok.com/us/store/goli-nutrition/7495794203056835079",
});
const res = await fetch(`https://socialtap.dev/v1/tiktokshop/products?${params}`, {
  headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, page, meta } = body;
console.log(data, meta.credits_charged);
```

Python (requests):

```python
import os

import requests

res = requests.get(
    "https://socialtap.dev/v1/tiktokshop/products",
    params={"handle": "https://shop.tiktok.com/us/store/goli-nutrition/7495794203056835079"},
    headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]},
)
body = res.json()
if not res.ok:
    raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
data, page, meta = body["data"], body["page"], body["meta"]
print(data, meta["credits_charged"])
```

Go (net/http):

```go
package main

import (
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"net/url"
	"os"
)

func main() {
	q := url.Values{}
	q.Set("handle", "https://shop.tiktok.com/us/store/goli-nutrition/7495794203056835079")
	req, err := http.NewRequest("GET", "https://socialtap.dev/v1/tiktokshop/products?"+q.Encode(), nil)
	if err != nil {
		log.Fatal(err)
	}
	req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer res.Body.Close()
	var body struct {
		Data  json.RawMessage `json:"data"`
		Page  json.RawMessage `json:"page"`
		Meta  map[string]any  `json:"meta"`
		Error *struct {
			Code    string `json:"code"`
			Message string `json:"message"`
		} `json:"error"`
	}
	if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
		log.Fatal(err)
	}
	if body.Error != nil {
		log.Fatalf("%s: %s", body.Error.Code, body.Error.Message)
	}
	fmt.Println(string(body.Data), body.Meta["credits_charged"])
}
```

200 OK:

```json
{
  "data": [
    {
      "approximate_fields": [
        "platform_specific.tiktokshop.rating"
      ],
      "attributes": [],
      "availability": null,
      "category": null,
      "category_id": null,
      "condition": null,
      "condition_label": null,
      "country_code": "US",
      "currency": "USD",
      "description": null,
      "id": "1729527313880355335",
      "max_price": 19.47,
      "media": [
        {
          "alt_text": null,
          "duration_ms": null,
          "expires_at": null,
          "height": 1500,
          "thumbnail_url": null,
          "type": "image",
          "url": "https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/2bc69aa9f6084480beee1bb4a8db3a69~tplv-fhlh96nyum-crop-webp:1500:1500.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=a6e80448&idc=useast5&from=2378011839",
          "width": 1500
        }
      ],
      "original_price": 24.7,
      "platform": "tiktokshop",
      "platform_specific": {
        "tiktokshop": {
          "brand": "Goli",
          "delivery_max_days": null,
          "delivery_min_days": null,
          "metrics": {
            "rating_distribution": null,
            "review_count": 94487,
            "sold_count": 1306510,
            "stock_count": null
          },
          "rating": 4.5,
          "shop": null,
          "variants": []
        }
      },
      "price": 19.47,
      "seller": {
        "avatar_url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/e7478d3e93d4487a9e772fa74e10f506~tplv-fhlh96nyum-resize-png:300:300.png?dr=12184&t=555f072d&ps=933b5bde&shp=905da467&shcp=d9d491bf&idc=useast5&from=2422056039",
        "display_name": "Goli Nutrition",
        "id": "7495794203056835079",
        "is_verified": true,
        "url": "https://shop.tiktok.com/us/store/goli-nutrition/7495794203056835079",
        "username": null
      },
      "shipping": {
        "fee": 0,
        "is_offered": true
      },
      "thumbnail_url": "https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/2bc69aa9f6084480beee1bb4a8db3a69~tplv-fhlh96nyum-crop-webp:1500:1500.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=a6e80448&idc=useast5&from=2378011839",
      "title": "Goli Ashwagandha & Vitamin D Gummy - Mixed Berry, KSM-66, Vegan, Plant Based, Non-GMO, Gluten-Free & Gelatin Free. America's #1 Ashwagandha Brand",
      "type": "product",
      "unknown_fields": [
        "attributes",
        "platform_specific.tiktokshop.variants"
      ],
      "url": "https://shop.tiktok.com/us/pdp/1729527313880355335"
    },
    {
      "approximate_fields": [
        "platform_specific.tiktokshop.rating"
      ],
      "attributes": [],
      "availability": null,
      "category": null,
      "category_id": null,
      "condition": null,
      "condition_label": null,
      "country_code": "US",
      "currency": "USD",
      "description": null,
      "id": "1731194857673101831",
      "max_price": 49.37,
      "media": [
        {
          "alt_text": null,
          "duration_ms": null,
          "expires_at": null,
          "height": 3000,
          "thumbnail_url": null,
          "type": "image",
          "url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/02f1b939f53d400998099bfad0f85a14~tplv-fhlh96nyum-crop-webp:3000:3000.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=a6e80448&idc=useast5&from=2378011839",
          "width": 3000
        }
      ],
      "original_price": 74.1,
      "platform": "tiktokshop",
      "platform_specific": {
        "tiktokshop": {
          "brand": "Goli",
          "delivery_max_days": null,
          "delivery_min_days": null,
          "metrics": {
            "rating_distribution": null,
            "review_count": 47921,
            "sold_count": 1043069,
            "stock_count": null
          },
          "rating": 4.5,
          "shop": null,
          "variants": []
        }
      },
      "price": 49.37,
      "seller": {
        "avatar_url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/e7478d3e93d4487a9e772fa74e10f506~tplv-fhlh96nyum-resize-png:300:300.png?dr=12184&t=555f072d&ps=933b5bde&shp=905da467&shcp=d9d491bf&idc=useast5&from=2422056039",
        "display_name": "Goli Nutrition",
        "id": "7495794203056835079",
        "is_verified": true,
        "url": "https://shop.tiktok.com/us/store/goli-nutrition/7495794203056835079",
        "username": null
      },
      "shipping": {
        "fee": 0,
        "is_offered": true
      },
      "thumbnail_url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/02f1b939f53d400998099bfad0f85a14~tplv-fhlh96nyum-crop-webp:3000:3000.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=a6e80448&idc=useast5&from=2378011839",
      "title": "Goli Zero Sugar Best Seller Trio – Daily Gut & Wellness Support with Pre, Post & Probiotics, Apple Cider Vinegar, Ashwagandha & L-Theanine Gummies",
      "type": "product",
      "unknown_fields": [
        "attributes",
        "platform_specific.tiktokshop.variants"
      ],
      "url": "https://shop.tiktok.com/us/pdp/1731194857673101831"
    },
    {
      "approximate_fields": [
        "platform_specific.tiktokshop.rating"
      ],
      "attributes": [],
      "availability": null,
      "category": null,
      "category_id": null,
      "condition": null,
      "condition_label": null,
      "country_code": "US",
      "currency": "USD",
      "description": null,
      "id": "1729587769570529799",
      "max_price": 58.47,
      "media": [
        {
          "alt_text": null,
          "duration_ms": null,
          "expires_at": null,
          "height": 1500,
          "thumbnail_url": null,
          "type": "image",
          "url": "https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/b0d9acd7ae184c8d89e2e498941485b6~tplv-fhlh96nyum-crop-webp:1500:1500.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=a6e80448&idc=useast5&from=2378011839",
          "width": 1500
        }
      ],
      "original_price": 74.1,
      "platform": "tiktokshop",
      "platform_specific": {
        "tiktokshop": {
          "brand": "Goli",
          "delivery_max_days": null,
          "delivery_min_days": null,
          "metrics": {
            "rating_distribution": null,
            "review_count": 71758,
            "sold_count": 866215,
            "stock_count": null
          },
          "rating": 4.7,
          "shop": null,
          "variants": []
        }
      },
      "price": 58.47,
      "seller": {
        "avatar_url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/e7478d3e93d4487a9e772fa74e10f506~tplv-fhlh96nyum-resize-png:300:300.png?dr=12184&t=555f072d&ps=933b5bde&shp=905da467&shcp=d9d491bf&idc=useast5&from=2422056039",
        "display_name": "Goli Nutrition",
        "id": "7495794203056835079",
        "is_verified": true,
        "url": "https://shop.tiktok.com/us/store/goli-nutrition/7495794203056835079",
        "username": null
      },
      "shipping": {
        "fee": 0,
        "is_offered": true
      },
      "thumbnail_url": "https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/b0d9acd7ae184c8d89e2e498941485b6~tplv-fhlh96nyum-crop-webp:1500:1500.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=a6e80448&idc=useast5&from=2378011839",
      "title": "3 Bottles of Goli Ashwagandha & Vitamin D Gummy - Mixed Berry, KSM-66, Vegan, Plant Based, Non-GMO, Gluten & Gelatin Free",
      "type": "product",
      "unknown_fields": [
        "attributes",
        "platform_specific.tiktokshop.variants"
      ],
      "url": "https://shop.tiktok.com/us/pdp/1729587769570529799"
    }
  ],
  "page": {
    "has_more": true,
    "next_cursor": "c1.EXAMPLE_CURSOR",
    "next_cursor_expires_at": "2026-10-26T12:00:00Z",
    "end_reason": null
  },
  "meta": {
    "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
    "platform": "tiktokshop",
    "source": "api",
    "is_cached": false,
    "credits_charged": 1,
    "latency_ms": 798,
    "fetched_at": "2026-10-25T12:00:00Z",
    "input": {
      "kind": "profile",
      "id": "7495794203056835079",
      "url": "https://shop.tiktok.com/us/store/goli-nutrition/7495794203056835079"
    },
    "credits_remaining": 9999,
    "client_request_id": null,
    "warnings": []
  }
}
```

Long arrays and strings are shortened here. Real responses are complete.

## One schema on 3 platforms.

The [response reference](https://socialtap.dev/docs/reference/tiktokshop/products/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/product/index.md).

- ### Null means unknown

  A field TikTok Shop doesn't show is null, never zero or an empty string, so a real zero always means zero.
- ### What it accepts

  A TikTok Shop shop: its storefront link (shop.tiktok.com/us/store/\<slug>/\<seller id>, www.tiktok.com/shop/store/\<slug>/\<seller id>) or its seller ID. US shops.
- ### Write one parser

  TikTok Shop, Amazon and Facebook Marketplace answer in these fields, so the code that reads one reads them all.

- **`platform`string**: Platform ID (tiktokshop, facebook, …).
- **`id`string**: Platform-native product or listing ID (string).
- **`url`string**: Canonical product page URL.
- **`type`string**: product: a catalog product a shop sells in many units, often in variants (TikTok Shop, Instagram and YouTube shopping); listing: a single item a person or business lists for sale (Facebook Marketplace). New values may be added; treat unknown values as product.
- **`title`string**: Product name or listing title, as the seller wrote it.
- **`description`string**: Description as plain text (paragraphs separated by blank lines); null when it has none or the source does not show it (lists and search results).
- **`category`string**: The platform's most specific category label (Bicycles, Vitamins & Supplements), as shown; not normalized across platforms.
- **`category_id`string**: The platform's ID of that category (what its category browsing and filters take).

Live data from 33 platforms.

[TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/index.md) · [Linkme](https://socialtap.dev/apis/linkme/index.md) · [Linktree](https://socialtap.dev/apis/linktree/index.md) · [Pillar](https://socialtap.dev/apis/pillar/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md)

## What teams build with the TikTok Shop Store Products API.

- ### Monitor a competitor's catalog, prices and discounts
- ### Rank a store's products by units sold
- ### List every product a store sells
- ### Collect product IDs for variant and stock data

## Good to know before you build.

- US stores only: TikTok Shop serves each market's storefronts only inside that market.
- A store is named by its seller ID or storefront link. A TikTok username returns invalid_input, because it names a creator, whose showcase lists the products they promote.
- Each item has what a product card shows. The description, specifications, category, variants and stock come from the TikTok Shop Product API.
- Units sold is TikTok Shop's own count across markets since the product was listed.

## 1 credit per page. Failed requests are free.

Buy credits once and spend them on any endpoint, on any platform.

[Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/tiktokshop/products/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md)

| Source | Price per successful page | Per 1,000 pages |
| --- | --- | --- |
| Any source | 1 credit | $0.75–$1.97 |

- Cache hits are free.
- Credits from packs and top-ups never expire.
- A monthly plan's credits are spent first, and what is left of them ends at each renewal.
- Prices exclude tax: sales tax is added at checkout where it applies.
- Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID.

## Questions about the TikTok Shop Store Products API.

More in the [API reference](https://socialtap.dev/docs/reference/tiktokshop/products/index.md).

**How much does the TikTok Shop Store Products API cost?**

A page of up to 20 products costs 1 credit. Every successful page is charged, empty pages included. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack.

**How do I get the next page?**

Repeat the same request with cursor set to page.next_cursor from the previous response, keeping the other parameters. When page.has_more is false there are no more pages. Cursors expire after 1 hour.

Other platforms

## Products on 2 more platforms.

- [Amazon Product API](https://socialtap.dev/apis/amazon/product/index.md) (1 credit · `GET /v1/amazon/product`)
- [Facebook Marketplace Listing API](https://socialtap.dev/apis/facebook/listing/index.md) (1 credit · `GET /v1/facebook/listing`)

More TikTok Shop

## TikTok Shop API. 4 endpoints, one key.

- [TikTok Shop Product API](https://socialtap.dev/apis/tiktokshop/product/index.md) (1 credit · `GET /v1/tiktokshop/product`)
- [TikTok Shop Search API](https://socialtap.dev/apis/tiktokshop/search_products/index.md) (1 credit / page · `GET /v1/tiktokshop/search_products`)
- [TikTok Shop Reviews API](https://socialtap.dev/apis/tiktokshop/reviews/index.md) (1 credit / page · `GET /v1/tiktokshop/reviews`)

## Try it on a link you already have.

Paste it in the playground, or copy the request into your code.

100free credits

- No credit card
- Failed requests are free
- Works on all 218 endpoints

[Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md)

---

[HTML version](https://socialtap.dev/apis/tiktokshop/products/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)
