TikTok scraper API
Every TikTok scraper endpoint: 23 actions returning structured JSON from $0.003 per call. No proxies, no captchas, no infrastructure.
All 23 TikTok endpoints, from $0.003 per call. Each is callable as GET https://hproxy.com/api/v1/scrape/tiktok/{action} (or POST with a JSON body) using a key with the scrape scope. No proxies, captchas or parsing to manage, it is all included in the price, and failed calls are never billed. See the full catalog for every platform, or the TikTok landing page for examples and use cases.
hproxy.com/api/v1/scrape/tiktok/profileTikTok Profile
Returns structured JSON for TikTok Profile. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.
| Parameter | Type | Required | Description |
|---|---|---|---|
x-api-key | string (header) | required | Your HProxy API key with the scrape scope. |
handle | string (query) | required | Account handle or @username. Send this or user_id. |
user_id | string (query) | required | Identifier from a previous response. Send this or handle. |
trim | boolean (query) | optional | Return a slimmed-down payload (drops verbose fields). |
cache_max_age | string (query) | optional | 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. |
curl "https://hproxy.com/api/v1/scrape/tiktok/profile?handle=tiktok" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/tiktok/profile-regionTikTok Profile Region
Returns structured JSON for TikTok Profile Region. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.
| Parameter | Type | Required | Description |
|---|---|---|---|
x-api-key | string (header) | required | Your HProxy API key with the scrape scope. |
handle | string (query) | required | Account handle or @username. |
trim | boolean (query) | optional | Return a slimmed-down payload (drops verbose fields). |
curl "https://hproxy.com/api/v1/scrape/tiktok/profile-region?handle=tiktok" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/tiktok/audienceTikTok User Audience Demographics
Returns structured JSON for TikTok User Audience Demographics. Billed $0.078 per successful call ($78.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.
| Parameter | Type | Required | Description |
|---|---|---|---|
x-api-key | string (header) | required | Your HProxy API key with the scrape scope. |
handle | string (query) | required | Account handle or @username. |
trim | boolean (query) | optional | Return a slimmed-down payload (drops verbose fields). |
curl "https://hproxy.com/api/v1/scrape/tiktok/audience?handle=tiktok" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/tiktok/videoTikTok Video
Returns structured JSON for TikTok Video. Billed $0.030 per successful call ($30.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.
| Parameter | Type | Required | Description |
|---|---|---|---|
x-api-key | string (header) | required | Your HProxy API key with the scrape scope. |
url | url (query) | required | Target URL (profile, post or video). |
get_transcript | boolean (query) | optional | Also include transcript in the response. |
region | string (query) | optional | Two-letter region/country code, e.g. US. |
trim | boolean (query) | optional | Return a slimmed-down payload (drops verbose fields). |
download_media | boolean (query) | optional | Return a direct media URL alongside the metadata. |
cache_max_age | string (query) | optional | 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. |
curl "https://hproxy.com/api/v1/scrape/tiktok/video?url=https://www.tiktok.com/@tiktok/video/7106594312292453675" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/tiktok/video-transcriptTikTok Video Transcript
Returns structured JSON for TikTok Video Transcript. Billed $0.033 per successful call ($33.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.
| Parameter | Type | Required | Description |
|---|---|---|---|
x-api-key | string (header) | required | Your HProxy API key with the scrape scope. |
url | url (query) | required | Target URL (profile, post or video). |
language | string (query) | optional | Two-letter language code, e.g. en. |
use_ai_as_fallback | string (query) | optional | The use ai as fallback parameter. |
curl "https://hproxy.com/api/v1/scrape/tiktok/video-transcript?url=https://www.tiktok.com/@tiktok/video/7106594312292453675" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/tiktok/profile-videosTikTok Profile Videos
Returns structured JSON for TikTok Profile Videos. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.
| Parameter | Type | Required | Description |
|---|---|---|---|
x-api-key | string (header) | required | Your HProxy API key with the scrape scope. |
handle | string (query) | required | Account handle or @username. |
user_id | string (query) | optional | Identifier from a previous response. |
max_cursor | string (query) | optional | Pagination token from the previous response. |
sort_by | string (query) | optional | Ordering to apply to the results. Allowed values: latest, popular. |
region | string (query) | optional | Two-letter region/country code, e.g. US. |
trim | boolean (query) | optional | Return a slimmed-down payload (drops verbose fields). |
curl "https://hproxy.com/api/v1/scrape/tiktok/profile-videos?handle=tiktok" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/tiktok/searchTikTok Keyword Search
Returns structured JSON for TikTok Keyword Search. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.
| Parameter | Type | Required | Description |
|---|---|---|---|
x-api-key | string (header) | required | Your HProxy API key with the scrape scope. |
query | string (query) | required | Search term or keyword. |
date_posted | string (query) | optional | Filter by date, as YYYY-MM-DD. Allowed values: yesterday, this-week, this-month, last-3-months, last-6-months, all-time. |
sort_by | string (query) | optional | Ordering to apply to the results. Allowed values: relevance, most-liked, date-posted. |
region | string (query) | optional | Two-letter region/country code, e.g. US. |
cursor | integer (query) | optional | Pagination token from the previous response. |
trim | boolean (query) | optional | Return a slimmed-down payload (drops verbose fields). |
curl "https://hproxy.com/api/v1/scrape/tiktok/search?query=coffee" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/tiktok/shop-searchTikTok Shop Search
Returns structured JSON for TikTok Shop Search. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.
| Parameter | Type | Required | Description |
|---|---|---|---|
x-api-key | string (header) | required | Your HProxy API key with the scrape scope. |
query | string (query) | required | Search term or keyword. |
page | integer (query) | optional | Pagination token from the previous response. |
region | string (query) | optional | Two-letter region/country code, e.g. US. |
curl "https://hproxy.com/api/v1/scrape/tiktok/shop-search?query=coffee" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/tiktok/live-statusTikTok Live Status
Returns structured JSON for TikTok Live Status. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.
| Parameter | Type | Required | Description |
|---|---|---|---|
x-api-key | string (header) | required | Your HProxy API key with the scrape scope. |
handle | string (query) | required | Account handle or @username. |
trim | boolean (query) | optional | Return a slimmed-down payload (drops verbose fields). |
curl "https://hproxy.com/api/v1/scrape/tiktok/live-status?handle=tiktok" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/tiktok/video-commentsTikTok Video Comments
Returns structured JSON for TikTok Video Comments. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.
| Parameter | Type | Required | Description |
|---|---|---|---|
x-api-key | string (header) | required | Your HProxy API key with the scrape scope. |
url | url (query) | required | Target URL (profile, post or video). |
cursor | integer (query) | optional | Pagination token from the previous response. |
trim | boolean (query) | optional | Return a slimmed-down payload (drops verbose fields). |
curl "https://hproxy.com/api/v1/scrape/tiktok/video-comments?url=https://www.tiktok.com/@tiktok/video/7106594312292453675" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/tiktok/followingTikTok User Following
Returns structured JSON for TikTok User Following. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.
| Parameter | Type | Required | Description |
|---|---|---|---|
x-api-key | string (header) | required | Your HProxy API key with the scrape scope. |
handle | string (query) | required | Account handle or @username. |
min_time | integer (query) | optional | Filter by date, as YYYY-MM-DD. |
trim | boolean (query) | optional | Return a slimmed-down payload (drops verbose fields). |
curl "https://hproxy.com/api/v1/scrape/tiktok/following?handle=tiktok" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/tiktok/followersTikTok User Followers
Returns structured JSON for TikTok User Followers. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.
| Parameter | Type | Required | Description |
|---|---|---|---|
x-api-key | string (header) | required | Your HProxy API key with the scrape scope. |
handle | string (query) | required | Account handle or @username. Send this or user_id. |
user_id | string (query) | required | Identifier from a previous response. Send this or handle. |
min_time | integer (query) | optional | Filter by date, as YYYY-MM-DD. |
trim | boolean (query) | optional | Return a slimmed-down payload (drops verbose fields). |
curl "https://hproxy.com/api/v1/scrape/tiktok/followers?handle=tiktok" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/tiktok/search-usersTikTok Search Users
Returns structured JSON for TikTok Search Users. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.
| Parameter | Type | Required | Description |
|---|---|---|---|
x-api-key | string (header) | required | Your HProxy API key with the scrape scope. |
query | string (query) | required | Search term or keyword. |
cursor | string (query) | optional | Pagination token from the previous response. |
trim | boolean (query) | optional | Return a slimmed-down payload (drops verbose fields). |
curl "https://hproxy.com/api/v1/scrape/tiktok/search-users?query=coffee" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/tiktok/search-hashtagTikTok Hashtag Search
Returns structured JSON for TikTok Hashtag Search. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.
| Parameter | Type | Required | Description |
|---|---|---|---|
x-api-key | string (header) | required | Your HProxy API key with the scrape scope. |
hashtag | string (query) | required | Hashtag to look up, without the # sign. |
region | string (query) | optional | Two-letter region/country code, e.g. US. |
cursor | integer (query) | optional | Pagination token from the previous response. |
trim | boolean (query) | optional | Return a slimmed-down payload (drops verbose fields). |
curl "https://hproxy.com/api/v1/scrape/tiktok/search-hashtag?hashtag=travel" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/tiktok/songTikTok Song Details
Returns structured JSON for TikTok Song Details. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.
| Parameter | Type | Required | Description |
|---|---|---|---|
x-api-key | string (header) | required | Your HProxy API key with the scrape scope. |
clipId | string (query) | required | Identifier from a previous response. |
cursor | integer (query) | optional | Pagination token from the previous response. |
curl "https://hproxy.com/api/v1/scrape/tiktok/song?clipId=1234567890" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/tiktok/song-videosTikTok Song Videos
Returns structured JSON for TikTok Song Videos. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.
| Parameter | Type | Required | Description |
|---|---|---|---|
x-api-key | string (header) | required | Your HProxy API key with the scrape scope. |
clipId | string (query) | required | Identifier from a previous response. |
cursor | integer (query) | optional | Pagination token from the previous response. |
curl "https://hproxy.com/api/v1/scrape/tiktok/song-videos?clipId=1234567890" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/tiktok/trendingTikTok Trending Feed
Returns structured JSON for TikTok Trending Feed. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.
| Parameter | Type | Required | Description |
|---|---|---|---|
x-api-key | string (header) | required | Your HProxy API key with the scrape scope. |
region | string (query) | required | Two-letter region/country code, e.g. US. |
trim | boolean (query) | optional | Return a slimmed-down payload (drops verbose fields). |
curl "https://hproxy.com/api/v1/scrape/tiktok/trending?region=US" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/tiktok/shop-productsTikTok Shop Products
Returns structured JSON for TikTok Shop Products. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.
| Parameter | Type | Required | Description |
|---|---|---|---|
x-api-key | string (header) | required | Your HProxy API key with the scrape scope. |
url | url (query) | required | Target URL (profile, post or video). |
cursor | string (query) | optional | Pagination token from the previous response. |
region | string (query) | optional | Two-letter region/country code, e.g. US. |
sort_by | string (query) | optional | Ordering to apply to the results. Allowed values: top, new_releases. |
curl "https://hproxy.com/api/v1/scrape/tiktok/shop-products?url=https://www.tiktok.com/@tiktok/video/7106594312292453675" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/tiktok/shop-productTikTok Shop Product Details
Returns structured JSON for TikTok Shop Product Details. Billed $0.003 per successful call ($3.50 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.
| Parameter | Type | Required | Description |
|---|---|---|---|
x-api-key | string (header) | required | Your HProxy API key with the scrape scope. |
url | url (query) | required | Target URL (profile, post or video). |
region | string (query) | optional | Two-letter region/country code, e.g. US. |
curl "https://hproxy.com/api/v1/scrape/tiktok/shop-product?url=https://www.tiktok.com/@tiktok/video/7106594312292453675" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/tiktok/shop-product-reviewsTikTok Shop Product Reviews
Returns structured JSON for TikTok Shop Product Reviews. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.
| Parameter | Type | Required | Description |
|---|---|---|---|
x-api-key | string (header) | required | Your HProxy API key with the scrape scope. |
url | url (query) | required | Target URL (profile, post or video). Send this or product_id. |
product_id | string (query) | required | Identifier from a previous response. Send this or url. |
region | string (query) | optional | Two-letter region/country code, e.g. US. |
page | integer (query) | optional | Pagination token from the previous response. |
curl "https://hproxy.com/api/v1/scrape/tiktok/shop-product-reviews?url=https://www.tiktok.com/@tiktok/video/7106594312292453675" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/tiktok/search-topTikTok Top Search
Returns structured JSON for TikTok Top Search. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.
| Parameter | Type | Required | Description |
|---|---|---|---|
x-api-key | string (header) | required | Your HProxy API key with the scrape scope. |
query | string (query) | required | Search term or keyword. |
publish_time | string (query) | optional | Filter by date, as YYYY-MM-DD. Allowed values: yesterday, this-week, this-month, last-3-months, last-6-months, all-time. |
sort_by | string (query) | optional | Ordering to apply to the results. Allowed values: relevance, most-liked, date-posted. |
region | string (query) | optional | Two-letter region/country code, e.g. US. |
cursor | integer (query) | optional | Pagination token from the previous response. |
curl "https://hproxy.com/api/v1/scrape/tiktok/search-top?query=coffee" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/tiktok/shop-showcaseTikTok Shop User Showcase
Returns structured JSON for TikTok Shop User Showcase. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.
| Parameter | Type | Required | Description |
|---|---|---|---|
x-api-key | string (header) | required | Your HProxy API key with the scrape scope. |
handle | string (query) | required | Account handle or @username. |
region | string (query) | optional | Two-letter region/country code, e.g. US. |
cursor | string (query) | optional | Pagination token from the previous response. |
curl "https://hproxy.com/api/v1/scrape/tiktok/shop-showcase?handle=tiktok" \
-H "X-API-Key: hpx_your_key_here"Need a hand wiring this up? Email support@hproxy.com. A real person reads every message.
hproxy.com/api/v1/scrape/tiktok/comment-repliesTikTok Comment Replies
Returns structured JSON for TikTok Comment Replies. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged.
POSTwith a JSON body works too.x-api-keycomment_idurlcursor