# TikTok Scraper (clockworks) via StableApify

> TikTok Scraper (clockworks) via StableApify is a paid API for AI agents from stableapify.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Starts an Apify actor run to scrape TikTok profiles, videos, hashtags, and posts by username, URL, or search query, returning a run ID and dataset token for result retrieval.

## Facts

- Endpoint: POST https://stableapify.dev/api/actors/clockworks/tiktok-scraper/call
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tiktok-scraper-clockworks-via-stableapify-3587258d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FRvE5so9nOxTY8a79DIDk

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 tiktok-scraper-clockworks-via-stableapify-3587258d -d '<json body>'
```

Example prompt: Scrape the TikTok profile and up to 100 videos for the user 'sarptecimer' — I need their follower count, heart count, and post metadata. Use 1024 MB memory and don't include email addresses.

## When to prefer this

Choose this endpoint when you need to extract structured TikTok data (profiles, videos, hashtags) at scale without managing your own scraping infrastructure. Prefer it over the apidojo/tiktok-scraper variant when the clockworks actor's feature set (URL-based scraping, username lookup, hashtag data) matches your use case and cost sensitivity matters at $0.01 per run start.

## Known failure modes

- Invalid username or URL returns an error or empty dataset
- Actor run may enter FAILED status if TikTok blocks the scrape
- Memory limit too low for large scrapes causes run failure
- Token expiry (valid ~30 days) prevents dataset retrieval if not fetched in time
- Rate limiting or account restrictions on TikTok side yield incomplete results
- Missing or malformed input fields return a 4xx error from the API

## How this service works

Start the "TikTok Scraper" Apify actor (clockworks/tiktok-scraper). Extract data from TikTok videos, hashtags, and users. Use URLs or search queries to scrape TikTok profiles, hashtags, posts, URLs, shares, followers, hearts, n…

## Output

Returns a JSON object with the actor run ID, run status (e.g. READY), actor ID, start timestamp, total cost in USD, the default dataset ID (for polling results), and a JWT bearer token used to authenticate subsequent dataset fetch calls.

## Example request

```json
{
 "input": {
  "username": "sarptecimer",
  "includeEmail": false
 },
 "options": {
  "memory": 1024,
  "maxItems": 100
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "resultsPerPage",
    "profileScrapeSections",
    "profileSorting",
    "excludePinnedPosts",
    "searchSection",
    "maxProfilesPerQuery",
    "videoSearchSorting",
    "videoSearchDateFilter",
    "scrapeRelatedVideos",
    "shouldDownloadVideos",
    "shouldDownloadCovers",
    "shouldDownloadSlideshowImages",
    "shouldDownloadAvatars",
    "shouldDownloadMusicCovers",
    "downloadSubtitlesOptions",
    "proxyCountryCode"
   ],
   "properties": {
    "hashtags": {
     "type": "array",
     "items": {
      "type": "string"
     },
     "description": "Just add one or more TikTok hashtags and the scraper will collect data about videos containing this hashtag: likes, users, followers and more. You can enter the hashtags one by one, or use the Bulk edit section to add a prepared list."
    },
    "postURLs": {
     "type": "array",
     "items": {
      "type": "string"
     },
     "description": "Add the URLs of tiktok videos you want to scrape. You can paste video URLs one by one, or use the Bulk edit section to add a prepared list."
    },
    "profiles": {
     "type": "array",
     "items": {
      "type": "string"
     },
     "description": "Add one or multiple TikTok usernames or user IDs you want to scrape. You can enter the usernames one by one, or use the Bulk edit section to add a prepared list."
    },
    "mostDiggs": {
     "type": "integer",
     "maximum": 9007199254740991,
     "minimum": 1,
     "description": "Optional charged filter. Scrapes only videos with less hearts than the number you add. Doesn't work with date filters"
    },
    "leastDiggs": {
     "type": "integer",
     "maximum": 9007199254740991,
     "minimum": 1,
     "description": "Optional charged filter. Scrapes only videos with no less hearts than the number you add. Doesn't work with date filters"
    },
    "searchQueries": {
     "type": "array",
     "items": {
      "type": "string"
     },
     "description": "Your keyword will apply to both videos and profiles. Use the Search sorting field below to specify whether you want your search to apply to top content, videos or users. As for your query's format, you can use any query that works on TikTok."
    },
    "searchSection": {
     "enum": [
      "",
      "/video",
      "/user"
     ],
     "type": "string",
     "default": "",
     "description": "By default, this scraper will sort the search results by wh
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tiktok-scraper-clockworks-via-stableapify-3587258d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stableapify.dev](https://www.zero.xyz/host/stableapify.dev/llms.txt)