TikTok API Quickstart

From signup to your first creator search in about a minute.

1. Sign up

A free Tokfluence account can create an API key. Free: 50 credits a month, shared by the app, the API and MCP, no rollover. For more, open Billing and start a Developer plan subscription, which includes a larger monthly credit grant that resets on your billing anniversary.

2. Create an API key

Head to API keys and click Create key. Copy the token from the green banner immediately — only the SHA-256 digest is stored on our side, so we can't show it to you again later.

Treat tokens like passwords

Tokens have full access to your account's API quota. Don't commit them to git. Rotate any key that leaks.

3. Make your first call

Search the creator index for fitness creators with at least 50K followers in the US:

bash

curl "https://developers.tokfluence.com/v1/creators/search?query=fitness&min_followers=50000&regions[]=US" \
  -H "Authorization: Bearer $TOKEN"

You should get back a JSON payload with up to 20 creators and a meta block describing pagination.

A search call costs 1 credit, plus 1 per profile with contact details it returns. This page costs 1 plus the number of rows that carry an email or phone. meta.billing shows the count. To pay only for creators you can reach, add has_email=true; to browse without contact details at 1 credit a page, add has_email=false&has_phone=false.

4. Watch your credits

Every response includes an X-Credits-Remaining header. Cache aggressively if you're calling the same endpoints in a loop — a cache miss is not a failure, so it is not refunded; any call that does not end in 200, 201 or 204 is.

Want a runnable script? Try the per-endpoint examples on the Creators, Posts, and Campaigns pages.