TikTok Profile Scraper

Extract comprehensive TikTok creator profile data for AI agents and marketing automation systems.

What This Actor Does

This agent-ready actor scrapes TikTok creator profiles and returns structured JSON data including:

• Follower counts and growth trends
• Engagement rates and metrics
• Video statistics and performance
• Verification status and account type
• Bio and URL information

Perfect for influencer research, competitive analysis, and creator marketplace automation.

Input Parameters

All parameters are optional unless marked as required.

{
  "usernames": ["username1", "username2"],
  "proxyUrl": "http://proxy.example.com:8080",
  "useResidentialProxy": false,
  "maxRetries": 3,
  "timeout": 30000
}

Parameter Details

• usernames (array, required): TikTok usernames to scrape (without @)
• proxyUrl (string): HTTP proxy URL for requests. Residential proxies recommended for reliability
• useResidentialProxy (boolean): Enable residential proxy mode (higher cost, better success rate)
• maxRetries (number): How many times to retry failed requests (default: 3)
• timeout (number): Request timeout in milliseconds (default: 30000)

Output Schema

{
  "profiles": [
    {
      "username": "string",
      "userId": "string",
      "displayName": "string",
      "bio": "string",
      "profileUrl": "string",
      "avatarUrl": "string",
      "followers": "number",
      "following": "number",
      "videoCount": "number",
      "engagement": {
        "avgLikes": "number",
        "avgComments": "number",
        "avgShares": "number",
        "engagementRate": "number"
      },
      "isVerified": "boolean",
      "isPrivate": "boolean",
      "externalUrl": "string",
      "metrics": {
        "createdAt": "string (ISO 8601)",
        "lastActiveAt": "string (ISO 8601)",
        "niche": "string"
      }
    }
  ],
  "metadata": {
    "requestCount": "number",
    "successCount": "number",
    "failureCount": "number",
    "duration": "number (ms)"
  }
}

Agent Integration

MCP Server Compatibility

This actor outputs clean JSON that works seamlessly with MCP (Model Context Protocol) servers:

GET /api/scraper/tiktok
POST /api/scraper/tiktok/profiles

Use the profiles array directly in your AI agent workflows.

OpenClaw Integration

Deploy with OpenClaw for automated creator research:

actors:
  - id: P5hcSLm5RvTfy3hZQ
    name: tiktok-profile-scraper
    type: data-source
    mcp-compatible: true

Example API Call for Agent Use

curl -X POST https://api.apify.com/v2/acts/P5hcSLm5RvTfy3hZQ/runs?token=YOUR_TOKEN \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["tiktok"],
    "useResidentialProxy": true
  }'

Pricing

• Base cost: $0.004 per profile scraped
• Proxy costs: Additional $0.001-0.01 per request depending on proxy type
• Residential proxy: Up to $0.05 per request (high reliability)
• Datacenter proxy: $0.001-0.003 per request (fast, basic reliability)

User pays all proxy costs.

Error Handling

• Profile not found: Returns null with error message
• Proxy timeout: Automatically retries up to maxRetries times
• Rate limiting: Built-in backoff strategy
• Session errors: Automatically creates new session

Advanced Features

• Handles both public and private profiles
• Automatic proxy rotation
• Rate limit detection and adaptation
• JSON output validation
• Comprehensive error logging

Notes

• Requires valid TikTok proxy (HTTP or SOCKS5)
• Some data may be rate-limited; use residential proxies for better reliability
• Respects TikTok's terms of service
• Results are point-in-time snapshots

Support

For integration questions with agents and MCP servers, consult the full API documentation.