Overview

The TokPortal API lets you programmatically create geo-targeted social media accounts (TikTok, Instagram, YouTube), configure and schedule video content, and manage your entire workflow — all from code.

Every feature available in the TokPortal UI is also available through the API, so you can fully automate account creation, content scheduling, analytics, and more.

Base URL

All API requests are made to:

https://app.tokportal.com/api/ext

Key Concepts

• Multi-platform — Manage TikTok, Instagram, and YouTube accounts from a single API.
• Credit-based billing — Operations consume credits. The same credit balance is shared between the API and the web UI. See Credits & Pricing for details.
• Full feature parity — Anything you can do in the dashboard, you can do via the API: create accounts, upload videos, schedule posts, configure warming, pull analytics, and more.

Response Format

All responses return JSON.

Success responses wrap the payload in a data key:

{
  "data": {
    "email": "you@example.com",
    "credits": 1250
  }
}

Error responses return an error object with a machine-readable code, a human-readable message, and optional details:

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Not enough credits to complete this operation.",
    "details": {
      "required": 50,
      "available": 12
    }
  }
}

See Errors for the full list of error codes.

Authentication

Include your API key in the X-API-Key header on every request. See Authentication for details.

Quick Example

Verify your API key and check your account info with a single call:

curl -X GET https://app.tokportal.com/api/ext/me \
  -H "X-API-Key: tok_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Response:

{
  "data": {
    "email": "you@example.com",
    "credits": 1250,
    "plan": "pro",
    "created_at": "2025-09-15T10:30:00Z"
  }
}

What's Next

Topic	Description
Authentication	API key setup and security best practices
Credits & Pricing	Credit costs per operation and balance endpoints
Errors	Full error code reference
Rate Limits & Pagination	Throttling, pagination, and idempotency