TikTok · Profiles

TikTok Profile Scraper API

The TikTok Profile endpoint is one API call: send either a handle or an user ID with your HProxy key and get back a clean, structured JSON object. Pull a complete public TikTok profile by handle or user id: bio, follower and video counts, verification and every link in the bio. HProxy runs the proxies, sessions, anti-bot handling and parsing server-side, so there is no headless browser to babysit and no parser to keep fixing when TikTok changes its markup. You only ever touch the JSON.
  • 0.15¢ per call
  • $1.49 per 1,000
  • Takes either a handle or an user ID
  • Errors and timeouts are not charged

The call

One GET, and the profile comes back as JSON.

Your key goes in one header. 1 required parameter, and the answer is the object below it.

The full reference
curl "https://hproxy.com/api/v1/scrape/tiktok/profile?handle=tiktok" \
  -H "X-API-Key: hpx_your_key_here"
Response200 OK · JSON
{
  "id": "1092...",
  "username": "@handle",
  "displayName": "Real Name",
  "bio": "Founder. Building things.",
  "isVerified": true,
  "counts": { "followers": 90421, "following": 312, "posts": 1840 },
  "links": ["https://example.com"],
  "avatar": "https://.../avatar.jpg"
}

What comes back

The TikTok profile object.

bio / links
Public bio text and any linked URLs.
counts
Followers, following and post or video counts.
isVerified
Verification and account-type flags.
avatar
Profile image URL and display name.

What it takes

Parameters.

Send any one of handle, user_id. handle or user_id required

handlestringtiktok

Account handle or @username.

user_idstring1234567890

Identifier from a previous response.

trimbooleantrue

Return a slimmed-down payload (drops verbose fields).

cache_max_agestring1d

Accept a cached result up to this old (1d, 3d, 7d, 14d or 30d) and pay nothing for it. Omit for a live scrape. Allowed values: `1d`, `3d`, `7d`, `14d`, `30d`.

How it works

Scraping TikTok profile, in three steps.

You write one line. Proxies, anti-bot walls, rendering and parsing happen on our side.

  1. 1

    Create a free account

    Sign up and top up any amount. The balance pays for every HProxy product.
  2. 2

    Grab your API key

    One key from the dashboard authenticates every scraper.
  3. 3

    Call the endpoint

    Send the GET you need and read the JSON. That is the entire integration.

What people build with it

Where the TikTok profile endpoint earns its keep.

  • Enrich a CRM or lead list with live TikTok profile data.
  • Verify accounts and detect fakes at scale.
  • Track competitor profiles and bios for changes.

TikTok profile questions

Answered before you ask.

The reference

Send one authenticated HTTPS request to the TikTok Profile endpoint with either a handle or an user ID and your HProxy API key. Pull a complete public TikTok profile by handle or user id: bio, follower and video counts, verification and every link in the bio. No proxies, no headless browser and no parsing on your side. The response is ready-to-use JSON.

This endpoint is 0.15¢ per successful call, which is $1.49 per 1,000. It bills from your HProxy balance with no subscription and no monthly minimum. Errors are retried and never charged; a lookup whose target does not exist counts as a call.

The API only accesses publicly available TikTok data, the same pages anyone can open in a browser. You are responsible for using the data in line with applicable laws and TikTok's terms for your use case.

A structured JSON object with the full profile data TikTok exposes publicly. See the fields listed above. The schema is consistent across calls, so you integrate once and rely on it.

No. Every call runs on HProxy's own residential network behind the scenes, so requests look like real users. The proxy layer is already included in the per-call price.

More on the TikTok Profile API

What the TikTok Profile endpoint returns

Pull a complete public TikTok profile by handle or user id: bio, follower and video counts, verification and every link in the bio. The JSON object carries bio / links, counts, isVerified and avatar. Nothing is summarised away on our side, so what you read in the response is what the TikTok profile page itself holds.

What you send to the TikTok Profile API

The call takes either a handle or an user ID, and any one of handle and user_id satisfies it. Optional: handle, user_id, trim and cache_max_age. Your key travels in the X-API-Key header, the response is JSON, and the call is billed at 0.15¢, $1.49 per 1,000.

Profiles on other platforms

The same profiles data is available on 18 other platforms: Facebook Profile, Instagram Profile, LinkedIn Profile, Twitter / X Profile, Threads Profile, Twitch Profile, Bluesky Profile, Truth Social Profile, Snapchat Profile, Linkme Profile, YouTube Channel, Reddit Subreddit Details, Spotify Artist, Komi Page, Linkbio Page, Linktree Page, Pillar Page and SoundCloud Artist. They share this endpoint's JSON shape, its per-call billing and your one API key, so moving from TikTok to another network is a change of URL rather than a second integration.

Is scraping TikTok profile allowed?

The endpoint reads publicly available TikTok data, the same pages anyone can open in a browser without logging in. It does not touch private accounts or anything behind a password. How you then use the data is yours to keep lawful, under the rules that apply to you and to TikTok.

Ready when you are.

Your dashboard is ten seconds away. No sales call, no subscription, no minimum.