## tiktokshop/shop-products

`GET /v1/tiktokshop/shop-products`

Every product a TikTok Shop store lists, with prices, sales counts and ratings. Paged by cursor.

*Shop products*

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | TikTok Shop store URL — e.g. `https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079` |
| `sort_by` | no | top or new_releases (default top) — e.g. `top` |
| `region` | no | Two-letter region code (default US) — e.g. `US` |
| `cursor` | no | Opaque cursor from the previous page |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. — e.g. `1` |

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/tiktokshop/shop-products?url=https%3A%2F%2Fwww.tiktok.com%2Fshop%2Fstore%2Fgoli-nutrition%2F7495794203056835079" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "cursor": null,
  "dropped": 0,
  "has_more": false,
  "items": [
    {
      "id": "example",
      "image": "https://example.com/example",
      "images": [
        "example"
      ],
      "platform": "example",
      "price": {
        "amount": 0,
        "currency": "example",
        "discount_fraction": 0,
        "formatted": "example",
        "original_amount": 0,
        "sku_id": "example"
      },
      "rating": 0,
      "review_count": 0,
      "seller_id": "example",
      "sold_count": 0,
      "title": "example",
      "url": "https://example.com/example"
    }
  ],
  "shop": {
    "followers": 0,
    "id": "example",
    "logo": "example",
    "name": "example",
    "products_count": 0,
    "rating": 0,
    "region": "example",
    "reviews_count": 0,
    "sold_count": 0,
    "url": "https://example.com/example",
    "videos_count": 0
  }
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/tiktokshop/shop-products#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/tiktokshop/shop-products.json)