# HireScrape TikTok Shop Scraper

> HireScrape TikTok Shop Scraper is a paid API for AI agents from hirescrape.com, paid per call via x402, $0.00225/call, status unknown (last checked 2026-09-14).

Scrapes TikTok Shop product listings and enables discovery by keyword, category, or shop ID.

## Facts

- Endpoint: POST https://hirescrape.com/api/tools/tiktok-shop
- Price: $0.00225/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hirescrape-com-6c41df15
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5ogzsZBEORvO8tFP2asyA

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability hirescrape-com-6c41df15 -d '<json body>'
```

Example prompt: Search TikTok Shop for trending skincare products in the beauty category and pull me the product names, prices, and shop details for the top results.

## When to prefer this

Use this endpoint when you need structured product data from TikTok Shop — including keyword-based product searches, category browsing, or shop-level inventory extraction — especially for e-commerce research, competitive analysis, or social commerce monitoring. Prefer over manual browsing when you need programmatic, structured output at scale.

## Known failure modes

- Invalid or missing keyword/category/shop ID returns an error or empty results
- TikTok Shop rate limiting or anti-bot detection may cause failed scrapes
- Private or restricted shops may not return data
- Category or shop ID not found returns empty result set
- Network timeout if TikTok platform is slow or unresponsive

## How this service works

TikTok Shop products + discovery by keyword/category/shop.

## Output

Returns a list of TikTok Shop product listings including product names, prices, descriptions, shop information, categories, and discovery metadata matching the input keyword, category, or shop query.

## Example request

```json
{
 "url": "https://shop.tiktok.com/search?q=skincare",
 "mode": "search",
 "query": "skincare",
 "region": "US"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "Full URL of the target object."
  },
  "mode": {
   "enum": [
    "search",
    "products",
    "product",
    "reviews",
    "showcase"
   ],
   "type": "string",
   "default": "search",
   "description": "Which endpoint to call. Options: search, products, product, reviews, showcase."
  },
  "page": {
   "type": "integer",
   "description": "Page number (default 1)."
  },
  "limit": {
   "type": "integer",
   "default": 20,
   "maximum": 500,
   "minimum": 1,
   "description": "Max items to collect (applies to paginated modes)."
  },
  "query": {
   "type": "string",
   "description": "Search keyword."
  },
  "cursor": {
   "type": "string",
   "description": "Pagination cursor."
  },
  "handle": {
   "type": "string",
   "description": "Username / handle (without @)."
  },
  "region": {
   "type": "string",
   "description": "Proxy / market region (e.g. US)."
  },
  "product_id": {
   "type": "string",
   "description": "Product ID."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "price": 29.99,
    "title": "Wireless Earbuds — Noise Cancelling",
    "rating": 4.6,
    "currency": "USD",
    "shop_name": "Audio Co.",
    "product_id": "1729958070036334569",
    "sold_count": 12400,
    "product_url": "https://www.tiktok.com/shop/pdp/1729958070036334569"
   }
  ],
  "runId": "bd_example",
  "payment": {
   "amount": "0.002250",
   "currency": "USD",
   "protocol": "x402"
  },
  "duration": 12
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hirescrape-com-6c41df15/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hirescrape.com](https://www.zero.xyz/host/hirescrape.com/llms.txt)