API CodexAPI Codex
WebsiteDashboardGet API Key
  • Documentation
  • All APIs
  • Changelog
Resources
  • Docs Home
  • API Catalog
  • API Codex Website
Platform
  • Get a free API key
  • Dashboard
  • APIs & Pricing

© 2026 API Codex. All rights reserved.

Information
Other endpoints
    Scrape a TikTok profile by URL or usernamegetScrape a TikTok video by URLgetScrape the comments of a TikTok videogetScrape the recent videos of a TikTok profilegetScrape a TikTok Shop product by URLgetFetch a pending scrape resultget
Schemas
powered by Zudoku
Advanced TikTok API
Advanced TikTok API

Other endpoints


Scrape a TikTok profile by URL or username

GET
https://api.apicodex.io/tiktok
/v1/profile

Returns structured JSON for a profile. Pass either url or username (a leading @ is accepted and stripped; the URL https://www.tiktok.com/@username is built for you). A fresh scrape usually returns in ~5-45s; if it exceeds the sync window you get a snapshot_id to fetch from /v1/result.

Scrape a TikTok profile by URL or username › query Parameters

url
​string

The profile URL to scrape. Required unless username is provided.

Example: https://www.tiktok.com/@tiktok
username
​string

TikTok handle instead of a URL; a leading @ is accepted and stripped.

Example: tiktok
fields
​string

Optional comma-separated list of top-level fields to keep in data.

Example: nickname,followers,likes

Scrape a TikTok profile by URL or username › Responses

Scraped data.

type
​string
url
​string
​object
GET/v1/profile
curl 'https://api.apicodex.io/tiktok/v1/profile?apikey=<api-key>'
Example Responses
{ "type": "profile", "url": "url", "data": {} }
json
application/json

Scrape a TikTok video by URL

GET
https://api.apicodex.io/tiktok
/v1/post

Returns structured JSON for a video URL (tiktok.com/@user/video/...). A fresh scrape usually returns in ~5-45s; if it exceeds the sync window you get a snapshot_id to fetch from /v1/result.

Scrape a TikTok video by URL › query Parameters

url
​string · required

The video URL to scrape.

Example: https://www.tiktok.com/@tiktok/video/7000000000000000000
fields
​string

Optional comma-separated list of top-level fields to keep in data.

Example: description,play_count,digg_count

Scrape a TikTok video by URL › Responses

Scraped data.

type
​string
url
​string
​object
GET/v1/post
curl 'https://api.apicodex.io/tiktok/v1/post?url=<string>&apikey=<api-key>'
Example Responses
{ "type": "post", "url": "url", "data": {} }
json
application/json

Scrape the comments of a TikTok video

GET
https://api.apicodex.io/tiktok
/v1/comments

Returns the comments of a video URL (tiktok.com/@user/video/...) as an array. Often exceeds the sync window and answers 202 first; the snapshot is typically ready within 1-2 minutes via /v1/result.

Scrape the comments of a TikTok video › query Parameters

url
​string · required

The video URL whose comments to scrape.

Example: https://www.tiktok.com/@tiktok/video/7000000000000000000
limit
​integer · min: 1 · max: 50

Maximum number of comments to return (1-50, default 10).

Example: 10
Default: 10
fields
​string

Optional comma-separated list of top-level fields to keep on each comment.

Example: comment_text,commenter_user_name,likes

Scrape the comments of a TikTok video › Responses

Scraped comments.

type
​string
url
​string
​object[]
GET/v1/comments
curl 'https://api.apicodex.io/tiktok/v1/comments?url=<string>&apikey=<api-key>'
Example Responses
{ "type": "comments", "url": "url", "data": [ {} ] }
json
application/json

Scrape the recent videos of a TikTok profile

GET
https://api.apicodex.io/tiktok
/v1/profile-posts

Returns the recent videos of a profile as an array (discovery). Pass either url or username (a leading @ is accepted and stripped). Often exceeds the sync window and answers 202 first; the snapshot is typically ready within 1-2 minutes via /v1/result.

Scrape the recent videos of a TikTok profile › query Parameters

url
​string

The profile URL whose videos to scrape. Required unless username is provided.

Example: https://www.tiktok.com/@tiktok
username
​string

TikTok handle instead of a URL; a leading @ is accepted and stripped.

Example: tiktok
limit
​integer · min: 1 · max: 50

Maximum number of videos to return (1-50, default 10).

Example: 10
Default: 10
fields
​string

Optional comma-separated list of top-level fields to keep on each video.

Example: url,description,play_count

Scrape the recent videos of a TikTok profile › Responses

Scraped videos.

type
​string
url
​string
​object[]
GET/v1/profile-posts
curl 'https://api.apicodex.io/tiktok/v1/profile-posts?apikey=<api-key>'
Example Responses
{ "type": "profile_posts", "url": "url", "data": [ {} ] }
json
application/json

Scrape a TikTok Shop product by URL

GET
https://api.apicodex.io/tiktok
/v1/shop

Returns structured JSON for a TikTok Shop product URL (shop.tiktok.com/..., e.g. /us/pdp// or /view/product/), including title, currency, initial_price, final_price, available, description and more. Often exceeds the sync window and answers 202 first; the snapshot is typically ready within 1-2 minutes via /v1/result.

Scrape a TikTok Shop product by URL › query Parameters

url
​string · required

The TikTok Shop product URL to scrape.

Example: https://shop.tiktok.com/view/product/1729543074742668078
fields
​string

Optional comma-separated list of top-level fields to keep in data.

Example: title,currency,final_price,available

Scrape a TikTok Shop product by URL › Responses

Scraped product data.

type
​string
url
​string
​object
GET/v1/shop
curl 'https://api.apicodex.io/tiktok/v1/shop?url=<string>&apikey=<api-key>'
Example Responses
{ "type": "shop_product", "url": "https://shop.tiktok.com/view/product/1729543074742668078", "data": { "title": "Dare to Think Differently...", "currency": "USD", "final_price": 30, "available": true } }
json
application/json

Fetch a pending scrape result

GET
https://api.apicodex.io/tiktok
/v1/result

Retrieve the result of a scrape that exceeded the sync window, using its snapshot_id. data is an array when the snapshot holds multiple records (comments, profile posts), otherwise a single object.

Fetch a pending scrape result › query Parameters

snapshot_id
​string · required

Fetch a pending scrape result › Responses

Result ready.

status
​string
snapshot_id
​string
​
GET/v1/result
curl 'https://api.apicodex.io/tiktok/v1/result?snapshot_id=<string>&apikey=<api-key>'
Example Responses
{ "status": "ready", "snapshot_id": "snapshot_id", "data": {} }
json
application/json