HProxy/ docs

TikTok scraper API

Every TikTok scraper endpoint: 25 actions returning structured JSON from $0.003 per call. No proxies, no captchas, no infrastructure.

All 25 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.

GET/api/v1/scrape/tiktok/profile

TikTok 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.
ParameterTypeRequiredDescription
x-api-keystring (header)requiredYour HProxy API key with the scrape scope.
handlestring (query)requiredAccount handle or @username.
trimboolean (query)optionalReturn a slimmed-down payload (drops verbose fields).
curl "https://hproxy.com/api/v1/scrape/tiktok/profile?handle=levelsio" \
  -H "X-API-Key: hpx_your_key_here"
GET/api/v1/scrape/tiktok/profile-region

TikTok 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.
ParameterTypeRequiredDescription
x-api-keystring (header)requiredYour HProxy API key with the scrape scope.
handlestring (query)requiredAccount handle or @username.
trimboolean (query)optionalReturn a slimmed-down payload (drops verbose fields).
curl "https://hproxy.com/api/v1/scrape/tiktok/profile-region?handle=levelsio" \
  -H "X-API-Key: hpx_your_key_here"
GET/api/v1/scrape/tiktok/audience

TikTok 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.
ParameterTypeRequiredDescription
x-api-keystring (header)requiredYour HProxy API key with the scrape scope.
handlestring (query)requiredAccount handle or @username.
trimboolean (query)optionalReturn a slimmed-down payload (drops verbose fields).
curl "https://hproxy.com/api/v1/scrape/tiktok/audience?handle=levelsio" \
  -H "X-API-Key: hpx_your_key_here"
GET/api/v1/scrape/tiktok/video

TikTok Video

Returns structured JSON for TikTok Video. 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.
ParameterTypeRequiredDescription
x-api-keystring (header)requiredYour HProxy API key with the scrape scope.
urlurl (query)requiredTarget URL (profile, post or video).
get_transcriptboolean (query)optionalOptional flag (true or false).
regionstring (query)optionalTwo-letter region/country code, e.g. US.
trimboolean (query)optionalReturn a slimmed-down payload (drops verbose fields).
download_mediaboolean (query)optionalOptional flag (true or false).
curl "https://hproxy.com/api/v1/scrape/tiktok/video?url=https://example.com/..." \
  -H "X-API-Key: hpx_your_key_here"
GET/api/v1/scrape/tiktok/video-transcript

TikTok 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.
ParameterTypeRequiredDescription
x-api-keystring (header)requiredYour HProxy API key with the scrape scope.
urlurl (query)requiredTarget URL (profile, post or video).
languagestring (query)optionalTwo-letter language code, e.g. en.
use_ai_as_fallbackstring (query)optionalThe use ai as fallback parameter.
curl "https://hproxy.com/api/v1/scrape/tiktok/video-transcript?url=https://example.com/..." \
  -H "X-API-Key: hpx_your_key_here"
GET/api/v1/scrape/tiktok/profile-videos

TikTok 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.
ParameterTypeRequiredDescription
x-api-keystring (header)requiredYour HProxy API key with the scrape scope.
handlestring (query)requiredAccount handle or @username.
user_idstring (query)optionalIdentifier from a previous response.
max_cursorstring (query)optionalPagination token from the previous response.
sort_bystring (query)optionalThe sort by parameter.
regionstring (query)optionalTwo-letter region/country code, e.g. US.
trimboolean (query)optionalReturn a slimmed-down payload (drops verbose fields).
curl "https://hproxy.com/api/v1/scrape/tiktok/profile-videos?handle=levelsio" \
  -H "X-API-Key: hpx_your_key_here"
GET/api/v1/scrape/tiktok/live-status

TikTok 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.
ParameterTypeRequiredDescription
x-api-keystring (header)requiredYour HProxy API key with the scrape scope.
handlestring (query)requiredAccount handle or @username.
trimboolean (query)optionalReturn a slimmed-down payload (drops verbose fields).
curl "https://hproxy.com/api/v1/scrape/tiktok/live-status?handle=levelsio" \
  -H "X-API-Key: hpx_your_key_here"
GET/api/v1/scrape/tiktok/video-comments

TikTok 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.
ParameterTypeRequiredDescription
x-api-keystring (header)requiredYour HProxy API key with the scrape scope.
urlurl (query)requiredTarget URL (profile, post or video).
cursorinteger (query)optionalPagination token from the previous response.
trimboolean (query)optionalReturn a slimmed-down payload (drops verbose fields).
curl "https://hproxy.com/api/v1/scrape/tiktok/video-comments?url=https://example.com/..." \
  -H "X-API-Key: hpx_your_key_here"
GET/api/v1/scrape/tiktok/comment-replies

TikTok 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. POST with a JSON body works too.
ParameterTypeRequiredDescription
x-api-keystring (header)requiredYour HProxy API key with the scrape scope.
comment_idstring (query)requiredIdentifier from a previous response.
urlurl (query)requiredTarget URL (profile, post or video).
cursorinteger (query)optionalPagination token from the previous response.
curl "https://hproxy.com/api/v1/scrape/tiktok/comment-replies?comment_id=1234567890&url=https://example.com/..." \
  -H "X-API-Key: hpx_your_key_here"
GET/api/v1/scrape/tiktok/following

TikTok 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.
ParameterTypeRequiredDescription
x-api-keystring (header)requiredYour HProxy API key with the scrape scope.
handlestring (query)requiredAccount handle or @username.
user_idstring (query)optionalIdentifier from a previous response.
min_timeinteger (query)optionalThe min time parameter.
trimboolean (query)optionalReturn a slimmed-down payload (drops verbose fields).
curl "https://hproxy.com/api/v1/scrape/tiktok/following?handle=levelsio" \
  -H "X-API-Key: hpx_your_key_here"
GET/api/v1/scrape/tiktok/followers

TikTok 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.
ParameterTypeRequiredDescription
x-api-keystring (header)requiredYour HProxy API key with the scrape scope.
handlestring (query)requiredAccount handle or @username.
user_idstring (query)optionalIdentifier from a previous response.
min_timeinteger (query)optionalThe min time parameter.
trimboolean (query)optionalReturn a slimmed-down payload (drops verbose fields).
curl "https://hproxy.com/api/v1/scrape/tiktok/followers?handle=levelsio" \
  -H "X-API-Key: hpx_your_key_here"
GET/api/v1/scrape/tiktok/search-users

TikTok 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.
ParameterTypeRequiredDescription
x-api-keystring (header)requiredYour HProxy API key with the scrape scope.
querystring (query)requiredSearch term or keyword.
cursorstring (query)optionalPagination token from the previous response.
trimboolean (query)optionalReturn 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"
GET/api/v1/scrape/tiktok/search-hashtag

TikTok 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.
ParameterTypeRequiredDescription
x-api-keystring (header)requiredYour HProxy API key with the scrape scope.
hashtagstring (query)requiredHashtag to look up, without the # sign.
regionstring (query)optionalTwo-letter region/country code, e.g. US.
cursorinteger (query)optionalPagination token from the previous response.
trimboolean (query)optionalReturn 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"
GET/api/v1/scrape/tiktok/song

TikTok 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.
ParameterTypeRequiredDescription
x-api-keystring (header)requiredYour HProxy API key with the scrape scope.
clipIdstring (query)requiredIdentifier from a previous response.
cursorinteger (query)optionalPagination token from the previous response.
curl "https://hproxy.com/api/v1/scrape/tiktok/song?clipId=1234567890" \
  -H "X-API-Key: hpx_your_key_here"
GET/api/v1/scrape/tiktok/song-videos

TikTok 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.
ParameterTypeRequiredDescription
x-api-keystring (header)requiredYour HProxy API key with the scrape scope.
clipIdstring (query)requiredIdentifier from a previous response.
cursorinteger (query)optionalPagination 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"
GET/api/v1/scrape/tiktok/shop-products

TikTok 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.
ParameterTypeRequiredDescription
x-api-keystring (header)requiredYour HProxy API key with the scrape scope.
urlurl (query)requiredTarget URL (profile, post or video).
cursorstring (query)optionalPagination token from the previous response.
regionstring (query)optionalTwo-letter region/country code, e.g. US.
curl "https://hproxy.com/api/v1/scrape/tiktok/shop-products?url=https://example.com/..." \
  -H "X-API-Key: hpx_your_key_here"
GET/api/v1/scrape/tiktok/shop-product

TikTok Shop Product Details

Returns structured JSON for TikTok Shop Product Details. Billed $0.005 per successful call ($5.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.
ParameterTypeRequiredDescription
x-api-keystring (header)requiredYour HProxy API key with the scrape scope.
urlurl (query)requiredTarget URL (profile, post or video).
regionstring (query)optionalTwo-letter region/country code, e.g. US.
curl "https://hproxy.com/api/v1/scrape/tiktok/shop-product?url=https://example.com/..." \
  -H "X-API-Key: hpx_your_key_here"
GET/api/v1/scrape/tiktok/shop-product-reviews

TikTok 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.
ParameterTypeRequiredDescription
x-api-keystring (header)requiredYour HProxy API key with the scrape scope.
urlurl (query)optionalTarget URL (profile, post or video).
product_idstring (query)optionalIdentifier from a previous response.
regionstring (query)optionalTwo-letter region/country code, e.g. US.
pageinteger (query)optionalPagination token from the previous response.
curl "https://hproxy.com/api/v1/scrape/tiktok/shop-product-reviews" \
  -H "X-API-Key: hpx_your_key_here"
GET/api/v1/scrape/tiktok/search-top

TikTok 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.
ParameterTypeRequiredDescription
x-api-keystring (header)requiredYour HProxy API key with the scrape scope.
querystring (query)requiredSearch term or keyword.
publish_timestring (query)optionalThe publish time parameter.
sort_bystring (query)optionalThe sort by parameter.
regionstring (query)optionalTwo-letter region/country code, e.g. US.
cursorinteger (query)optionalPagination 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"
GET/api/v1/scrape/tiktok/shop-showcase

TikTok 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.
ParameterTypeRequiredDescription
x-api-keystring (header)requiredYour HProxy API key with the scrape scope.
handlestring (query)requiredAccount handle or @username.
regionstring (query)optionalTwo-letter region/country code, e.g. US.
cursorstring (query)optionalPagination token from the previous response.
curl "https://hproxy.com/api/v1/scrape/tiktok/shop-showcase?handle=levelsio" \
  -H "X-API-Key: hpx_your_key_here"

Need a hand wiring this up? Email [email protected]. A real person reads every message.