All questionsTikTok

Does TikTok have a public API?

Not in the way most people mean. TikTok has no API that lets a developer or a business read any public account. The Research API is limited to approved academic and non-profit researchers. The Display API reads only the account that logged in to your app.

For public profiles, videos, comments, hashtags, and search, use a public data API. Openhandle has 28 TikTok endpoints behind one API key, with no application and no TikTok login.

Checked September 2026 · request and response run against the API · no affiliate links

GET /v1/tiktok/profiles/@username
curl "https://api.openhandle.dev/v1/tiktok/profiles/@pixel_orchard_tt_test" \
  -H "Authorization: Bearer $OPENHANDLE_API_KEY"
TypeScript SDK
import { OpenHandle } from '@openhandle/sdk';

const openhandle = new OpenHandle({ apiKey: process.env.OPENHANDLE_API_KEY! });
const response = await openhandle.tiktok.profile('pixel_orchard_tt_test').get();

console.log(response.data.metrics.followers); // 75120
200 OK
{
  "platform": "tiktok",
  "resource": "profile",
  "capturedAt": "2026-09-18T10:33:17Z",
  "source": "live",
  "data": {
    "id": "920000000001",
    "handle": "pixel_orchard_tt_test",
    "displayName": "Pixel Orchard",
    "isVerified": true,
    "isPrivate": false,
    "metrics": { "followers": 75120, "following": 411, "posts": 4 }
  }
}

Trimmed to the fields this question needs. The full profile has bio, links, avatar, region, and more. The example is a Test account, so you can run it on a free Test key.

TikTok’s official APIs, and who they are for

APIWho can use itWhat it reads
Research APIApproved academic and non-profit researchers, after an applicationPublic videos, comments, and profiles, for research
Display APIAny registered appOnly the account that logged in through your app
Content Posting APIAny registered appNothing. It uploads to the logged-in account
Commercial Content APIAny registered appAds and commercial content, not organic accounts

None of these read a creator, a competitor, or a hashtag at large for a commercial product. That is the gap a public data API fills.

What a public data API reads

  • Profiles. Followers, following, likes, bio, verification, and region for any public account.
  • Videos. Views, likes, comments, shares, and saves per video. A creator’s videos one page at a time.
  • Comments and replies. Threads under any public video, with authors.
  • Hashtags, sounds, and search. Posts for a hashtag or a sound. Search for profiles, videos, and hashtags by keyword.
  • Web and app combined. The web page and the app show different fields. Openhandle reads both and merges them.

What it never does

Openhandle is read-only and public-only. It never posts, likes, follows, or messages. Private accounts return PROFILE_PRIVATE. A metric TikTok hides is null, never 0. The public data notice lists every limit.

When this does not work

These answers are definitive. Store them, do not retry them.

SituationStatusCode
The account is private403PROFILE_PRIVATE
The account is deleted, banned, or never existed404PROFILE_NOT_FOUND
The identifier is malformed400INVALID_IDENTIFIER
403 Forbidden
{
  "error": {
    "code": "PROFILE_PRIVATE",
    "message": "This profile is private.",
    "requestId": "req_01j8…",
    "retryable": false
  }
}

Every new workspace starts with 100 free live requests, no card needed. A full synthetic Test dataset covers every TikTok endpoint at no charge.

Read next

More TikTok questions

Send your agent ahead.

Paste the prompt into your agent and it sets everything up. Or come yourself, it takes five minutes.

For agents