TikTok · Profiles

TikTok Profile Region Scraper API

The TikTok Profile Region endpoint is one API call: send an account handle with your HProxy key and get back a clean, structured JSON object. Resolve which region a TikTok account actually posts from, plus its language signal and creation date, straight from the handle. 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.
Get your API keyTikTok API reference
  • 0.15¢ per call
  • $1.49 per 1,000
  • Takes an account handle
  • Errors and timeouts are not charged

On TikTok

Profiles2Posts and media5Transcripts1Comments3Search and trends5Shopping4Followers and audience3

Profiles

TikTokFacebookYouTubeInstagramLinkedInTwitter / XRedditThreadsTwitchBlueskySpotifyTruth SocialKomiLinkbioLinkmeLinktreePillarSnapchatSoundCloud

The call

One GET, and the profile region 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-region?handle=tiktok" \
  -H "X-API-Key: hpx_your_key_here"
Response200 OK · JSON
{
  "handle": "@handle",
  "region": "DE",
  "language": "de",
  "createdAt": "2021-04-02"
}

What comes back

The TikTok profile region object.

region
The account's declared region code.
language
Primary content language signal.
createdAt
Account creation date where exposed.

What it takes

Parameters.

handlestringRequiredtiktok

Account handle or @username.

trimbooleantrue

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

How it works

Scraping TikTok profile region, in three steps.

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

Create a free accountEvery TikTok endpoint
  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 region endpoint earns its keep.

  • Route campaigns by a creator's real market, not their bio.
  • Filter influencer lists down to a target country.
  • Detect accounts misrepresenting where they post from.

TikTok profile region questions

Answered before you ask.

The reference

Send one authenticated HTTPS request to the TikTok Profile Region endpoint with an account handle and your HProxy API key. Resolve which region a TikTok account actually posts from, plus its language signal and creation date, straight from the handle. 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 region 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.

Docs and AI

Connect your scraper to an AI, any time.

The whole Scraper API is published as markdown, so an assistant reads every endpoint, every parameter and a real response without a key and writes your integration. And because a scrape is one GET that answers in JSON, an agent can run the scraper itself, on its own schedule, with your key.

Read the scraper docsSet up your assistant

Claude, ChatGPT, Cursor, Gemini, Copilot, Windsurf, Perplexity, Ollama and any assistant that speaks MCP.

The API as markdown

Paste /llms/scraper-api.txt into Claude, ChatGPT, Cursor or Copilot: every endpoint and the whole catalog, in one file. No key and no account to read it.

Open the markdown

An agent can call it

One GET with your key returns structured JSON, so an agent scrapes on its own schedule. No browser to drive, no parser to keep alive between runs.

See the endpoints

MCP server and CLI

Built by us for the free tools and hosted at mcp.hproxy.com: the proxy list, the checker and the IP lookup as tools in Claude, ChatGPT, Cursor or any assistant that speaks MCP. Nothing to install, no key.

Add it to your assistant

API docs

Every scraper endpoint documented end to end, with the parameters it takes and the response it really returns.

Read the docs

Profiles elsewhere

The same data on 18 other platforms.

One key, one JSON shape, one balance. Move sideways without learning a second API.

Profile Scraper API
Facebook Profile17 endpoints on FacebookYouTube Channel13 endpoints on YouTubeInstagram Profile11 endpoints on InstagramLinkedIn Profile6 endpoints on LinkedInTwitter / X Profile6 endpoints on Twitter / XReddit Subreddit Details5 endpoints on RedditThreads Profile5 endpoints on ThreadsTwitch Profile4 endpoints on TwitchBluesky Profile3 endpoints on BlueskySpotify Artist3 endpoints on SpotifyTruth Social Profile3 endpoints on Truth SocialKomi Page1 endpoint on KomiLinkbio Page1 endpoint on LinkbioLinkme Profile1 endpoint on LinkmeLinktree Page1 endpoint on LinktreePillar Page1 endpoint on PillarSnapchat Profile1 endpoint on SnapchatSoundCloud Artist1 endpoint on SoundCloud

More from TikTok

23 TikTok endpoints, one key.

The TikTok catalog
TikTok ProfileProfilesTikTok User Audience DemographicsFollowers and audienceTikTok VideoPosts and mediaTikTok Video TranscriptTranscriptsTikTok Profile VideosPosts and mediaTikTok Live StatusPosts and mediaTikTok Video CommentsCommentsTikTok Comment RepliesCommentsTikTok User FollowingFollowers and audience

Every platform

The same key works on all 23.

The whole catalog

More on the TikTok Profile Region API

What the TikTok Profile Region endpoint returns

Resolve which region a TikTok account actually posts from, plus its language signal and creation date, straight from the handle. The JSON object carries region, language and createdAt. Nothing is summarised away on our side, so what you read in the response is what the TikTok profile region page itself holds.

What you send to the TikTok Profile Region API

The call takes an account handle. Required: handle. Optional: trim. 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, YouTube Channel, Instagram Profile, LinkedIn Profile, Twitter / X Profile, Reddit Subreddit Details, Threads Profile, Twitch Profile, Bluesky Profile, Spotify Artist, Truth Social Profile, Komi Page, Linkbio Page, Linkme Profile, Linktree Page, Pillar Page, Snapchat Profile 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 region 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.

Get startedSee every scraperTalk to us