Proxy./ docs

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.

GEThproxy.com/api/v1/scrape/tiktok/profilekey
curl "https://hproxy.com/api/v1/scrape/tiktok/profile?handle=tiktok" \
  -H "X-API-Key: hpx_your_key_here"

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. Send this or user_id.
user_idstring (query)requiredIdentifier from a previous response. Send this or handle.
trimboolean (query)optionalReturn a slimmed-down payload (drops verbose fields).
cache_max_agestring (query)optionalAccept 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.
GEThproxy.com/api/v1/scrape/tiktok/profile-regionkey
curl "https://hproxy.com/api/v1/scrape/tiktok/profile-region?handle=tiktok" \
  -H "X-API-Key: hpx_your_key_here"

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).
GEThproxy.com/api/v1/scrape/tiktok/audiencekey
curl "https://hproxy.com/api/v1/scrape/tiktok/audience?handle=tiktok" \
  -H "X-API-Key: hpx_your_key_here"

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).
GEThproxy.com/api/v1/scrape/tiktok/videokey
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"

TikTok 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.

ParameterTypeRequiredDescription
x-api-keystring (header)requiredYour HProxy API key with the scrape scope.
urlurl (query)requiredTarget URL (profile, post or video).
get_transcriptboolean (query)optionalAlso include transcript in the response.
regionstring (query)optionalTwo-letter region/country code, e.g. US.
trimboolean (query)optionalReturn a slimmed-down payload (drops verbose fields).
download_mediaboolean (query)optionalReturn a direct media URL alongside the metadata.
cache_max_agestring (query)optionalAccept 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.
GEThproxy.com/api/v1/scrape/tiktok/video-transcriptkey
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"

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.
GEThproxy.com/api/v1/scrape/tiktok/profile-videoskey
curl "https://hproxy.com/api/v1/scrape/tiktok/profile-videos?handle=tiktok" \
  -H "X-API-Key: hpx_your_key_here"

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)optionalOrdering to apply to the results. Allowed values: latest, popular.
regionstring (query)optionalTwo-letter region/country code, e.g. US.
trimboolean (query)optionalReturn a slimmed-down payload (drops verbose fields).
GEThproxy.com/api/v1/scrape/tiktok/live-statuskey
curl "https://hproxy.com/api/v1/scrape/tiktok/live-status?handle=tiktok" \
  -H "X-API-Key: hpx_your_key_here"

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).
GEThproxy.com/api/v1/scrape/tiktok/video-commentskey
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"

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).
GEThproxy.com/api/v1/scrape/tiktok/comment-replieskey
curl "https://hproxy.com/api/v1/scrape/tiktok/comment-replies?comment_id=1234567890&url=https://www.tiktok.com/@tiktok/video/7106594312292453675" \
  -H "X-API-Key: hpx_your_key_here"

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.
GEThproxy.com/api/v1/scrape/tiktok/followingkey
curl "https://hproxy.com/api/v1/scrape/tiktok/following?handle=tiktok" \
  -H "X-API-Key: hpx_your_key_here"

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.
min_timeinteger (query)optionalFilter by date, as YYYY-MM-DD.
trimboolean (query)optionalReturn a slimmed-down payload (drops verbose fields).
GEThproxy.com/api/v1/scrape/tiktok/followerskey
curl "https://hproxy.com/api/v1/scrape/tiktok/followers?handle=tiktok" \
  -H "X-API-Key: hpx_your_key_here"

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. Send this or user_id.
user_idstring (query)requiredIdentifier from a previous response. Send this or handle.
min_timeinteger (query)optionalFilter by date, as YYYY-MM-DD.
trimboolean (query)optionalReturn a slimmed-down payload (drops verbose fields).
GEThproxy.com/api/v1/scrape/tiktok/search-userskey
curl "https://hproxy.com/api/v1/scrape/tiktok/search-users?query=coffee" \
  -H "X-API-Key: hpx_your_key_here"

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).
GEThproxy.com/api/v1/scrape/tiktok/search-hashtagkey
curl "https://hproxy.com/api/v1/scrape/tiktok/search-hashtag?hashtag=travel" \
  -H "X-API-Key: hpx_your_key_here"

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).
GEThproxy.com/api/v1/scrape/tiktok/songkey
curl "https://hproxy.com/api/v1/scrape/tiktok/song?clipId=1234567890" \
  -H "X-API-Key: hpx_your_key_here"

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.
GEThproxy.com/api/v1/scrape/tiktok/song-videoskey
curl "https://hproxy.com/api/v1/scrape/tiktok/song-videos?clipId=1234567890" \
  -H "X-API-Key: hpx_your_key_here"

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.
GEThproxy.com/api/v1/scrape/tiktok/shop-productskey
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"

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.
sort_bystring (query)optionalOrdering to apply to the results. Allowed values: top, new_releases.
GEThproxy.com/api/v1/scrape/tiktok/shop-productkey
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"

TikTok 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.

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.
GEThproxy.com/api/v1/scrape/tiktok/shop-product-reviewskey
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"

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)requiredTarget URL (profile, post or video). Send this or product_id.
product_idstring (query)requiredIdentifier from a previous response. Send this or url.
regionstring (query)optionalTwo-letter region/country code, e.g. US.
pageinteger (query)optionalPagination token from the previous response.
GEThproxy.com/api/v1/scrape/tiktok/search-topkey
curl "https://hproxy.com/api/v1/scrape/tiktok/search-top?query=coffee" \
  -H "X-API-Key: hpx_your_key_here"

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)optionalFilter by date, as YYYY-MM-DD. Allowed values: yesterday, this-week, this-month, last-3-months, last-6-months, all-time.
sort_bystring (query)optionalOrdering to apply to the results. Allowed values: relevance, most-liked, date-posted.
regionstring (query)optionalTwo-letter region/country code, e.g. US.
cursorinteger (query)optionalPagination token from the previous response.
GEThproxy.com/api/v1/scrape/tiktok/shop-showcasekey
curl "https://hproxy.com/api/v1/scrape/tiktok/shop-showcase?handle=tiktok" \
  -H "X-API-Key: hpx_your_key_here"

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.

Need a hand wiring this up? Email support@hproxy.com. A real person reads every message.