# Hirescrape TikTok Scraper API

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

Scrapes TikTok profiles, videos, comments, transcripts, search results, trending feeds, and audience data via a pay-per-call API

## Facts

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

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-tiktok-scraper-api-d883a085 -d '<json body>'
```

Example prompt: Pull the TikTok profile for handle 'mrbeast' and also grab his last 50 videos with their stats — use profile mode first, then profile_videos mode with a limit of 50, targeting the US region.

## When to prefer this

Use this endpoint when you need structured TikTok data (profiles, videos, comments, trends, transcripts) without managing your own scraping infrastructure or API keys. Prefer it for AI agent workflows that need pay-per-call pricing in USDC via x402, multi-mode TikTok coverage in a single endpoint, or access to trending/popular content feeds across regions.

## Known failure modes

- Invalid or deleted TikTok URL returns empty items array
- Private/restricted account returns no data or partial profile
- Unsupported mode value returns validation error
- Rate limiting or geo-block causes empty results for certain regions
- Pagination cursor mismatch returns incorrect page
- Handle not found returns empty items
- TikTok anti-scrape measures may cause intermittent failures

## How this service works

Pay-per-call web scrapers for AI agents. 28 tools across Reddit, 8-board job search (LinkedIn · Indeed · Glassdoor · Google Jobs · +5), TikTok · Douyin · Bilibili, cross-platform trend research, social media, and ad libraries. No API keys. Agent wallets settle USDC on Tempo or Base via x402 + MPP.

## Output

A JSON object with an 'items' array containing scraped TikTok data (shape varies by mode — e.g. profile info, video objects with play/like/share/comment counts, comment text, transcript segments, or search result lists), plus a runId for debugging, payment settlement summary, and run duration in seconds.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "Full URL of the target object."
  },
  "mode": {
   "enum": [
    "profile",
    "audience",
    "profile_videos",
    "video",
    "transcript",
    "live",
    "video_comments",
    "comment_replies",
    "following",
    "followers",
    "search_users",
    "search_hashtag",
    "search_keyword",
    "search_top",
    "popular_songs",
    "popular_creators",
    "popular_videos",
    "popular_hashtags",
    "song",
    "song_videos",
    "trending_feed"
   ],
   "type": "string",
   "default": "profile",
   "description": "Which endpoint to call. Options: profile, audience, profile_videos, video, transcript, live, video_comments, comment_replies, following, followers, search_users, search_hashtag, search_keyword, search_top, popular_songs, popular_creators, popular_videos, popular_hashtags, song, song_videos, trending_feed."
  },
  "page": {
   "type": "integer",
   "description": "Page number (default 1)."
  },
  "trim": {
   "type": "boolean",
   "description": "Return a condensed response."
  },
  "limit": {
   "type": "integer",
   "default": 20,
   "maximum": 500,
   "minimum": 1,
   "description": "Max items to collect (applies to paginated modes)."
  },
  "query": {
   "type": "string",
   "description": "Search keyword."
  },
  "clipId": {
   "type": "string",
   "description": "TikTok song clip ID."
  },
  "cursor": {
   "type": "string",
   "description": "Pagination cursor."
  },
  "handle": {
   "type": "string",
   "description": "Username / handle (without @)."
  },
  "period": {
   "type": "integer",
   "description": "Lookback days (7 or 30)."
  },
  "region": {
   "type": "string",
   "description": "Proxy / market region (e.g. US)."
  },
  "sortBy": {
   "type": "string",
   "description": "Sort key (depends on endpoint)."
  },
  "hashtag": {
   "type": "string",
   "description": "Hashtag (without #)."
  },
  "orderBy": {
   "type": "string",
   "description": "Order key (depends on endpoint)."
  },
  "sort_by": {
   "type": "string",
   "description": "Sort key (depends on endpoint)."
  },
  "user_id": {
   "type": "string",
   "description": "Platform user ID (often faster than handle)."
  },
  "industry": {
   "type": "string",
   "description": "Industry filter."
  },
  "language": {
   "type": "string",
   "description": "2-letter language code."
  },
  "min_time": {
   "type": "integer",
   "description": "Pagination cursor (unix seconds)."

… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "required": [
   "items"
  ],
  "properties": {
   "items": {
    "type": "array",
    "items": {
     "type": "object"
    },
    "description": "Scraped items. Shape varies per tool — see each tool's outputSample for a concrete example."
   },
   "runId": {
    "type": "string",
    "description": "Run ID for debugging/audit."
   },
   "payment": {
    "type": "object",
    "description": "Settlement summary (protocol, amount, currency)."
   },
   "duration": {
    "type": "integer",
    "description": "Run duration in seconds."
   }
  }
 },
 "example": {
  "items": [
   {
    "id": "7234567890123456789",
    "desc": "Day 30 of giving away money",
    "stats": {
     "diggCount": 3200000,
     "playCount": 48000000,
     "shareCount": 180000,
     "commentCount": 42000
    },
    "author": {
     "nickname": "MrBeast",
     "uniqueId": "mrbeast"
    },
    "createTime": 1776300000
   }
  ],
  "runId": "sc_mo4tiktokexample",
  "payment": {
   "amount": "0.220000",
   "currency": "USD",
   "protocol": "x402"
  },
  "duration": 5
 }
}
```

## More

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