A pay-per-request TikTok scraper API powered by the Machine Payments Protocol (MPP) and Apify.

AI agents and clients pay in Tempo/PathUSD stablecoins on each request — no subscriptions, no API keys.

# User scrape
GET /api/tiktok/user?handle=@charlidamelio&limit=10

# Hashtag scrape
GET /api/tiktok/hashtag?tag=fyp&limit=20

# Single video
GET /api/tiktok/video?url=https://www.tiktok.com/@user/video/123456789

# Search
GET /api/tiktok/search?q=funny+cats&limit=10

1. Client makes a normal HTTP request
2. Server responds with 402 Payment Required + payment instructions
3. Client pays with Tempo/PathUSD (stablecoin)
4. Client retries with Authorization header containing payment proof
5. Server verifies payment → returns TikTok data + receipt

bun install

cp .env.example .env

Edit .env:

APIFY_TOKEN=apify_api_your_token_here
RECIPIENT_ADDRESS=0xYourWalletAddress
PORT=3000

• APIFY_TOKEN — get at apify.com
• RECIPIENT_ADDRESS — your EVM wallet address for receiving payments

# Development (hot reload)
bun run dev

# Production
bun run start

In src/index.ts, update:

testnet: false,

And update RECIPIENT_ADDRESS in .env to your mainnet wallet.

MIT