# agdata TikTok Scraper

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

Scrapes TikTok videos by user profile, hashtag, or keyword search and returns structured JSON results, billed per call in USDC on Base.

## Facts

- Endpoint: POST https://agdata.shveik.dev/mpp/tiktok
- Price: $0.0136/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agdata-tiktok-scraper-f2d30734
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sRudhLcGayGqMYYqjuhat

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 agdata-tiktok-scraper-f2d30734 -d '<json body>'
```

Example prompt: Pull the latest 10 TikTok videos from the profile 'charlidamelio' and give me the structured data — titles, view counts, links, whatever you can get.

## When to prefer this

Choose this endpoint when an AI agent needs TikTok data (by profile, hashtag, or keyword) without managing API keys, accounts, or subscriptions — it's purpose-built for agent workflows with pay-per-call USDC billing via x402, making it ideal for on-demand or low-volume scraping tasks without upfront commitment.

## Known failure modes

- TikTok rate limiting or blocking may cause empty or partial results
- Invalid or private username returns no profile results
- Hashtag with no public content returns empty array
- Payment failure via x402 results in 402 response before data is returned
- Limit out of range (below 1 or above 20) is clamped silently

## How this service works

Web scraping API for AI agents: extract public data from Instagram, TikTok, and Google Maps as clean structured JSON, billed pay-per-result in USDC on Base via the x402 exact scheme. An agent-native alternative to web-scraping platforms like Apify, Bright Data, and ScraperAPI — no API keys, no accounts, no subscriptions: the agent just pays per call.

## Output

A structured JSON array of TikTok video records matching the query, including metadata such as video URLs, captions, author info, view/like counts, and timestamps — up to the requested limit (max 20).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "enum": [
    "profile",
    "hashtag",
    "search"
   ],
   "type": "string",
   "description": "profile=user's videos, hashtag=videos under a tag, search=keyword→videos"
  },
  "limit": {
   "type": "integer",
   "default": 5,
   "maximum": 20,
   "minimum": 1,
   "description": "max results returned (clamped to this range)"
  },
  "query": {
   "type": "string",
   "description": "username (profile), hashtag without #, or search keywords"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

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