Send your first TikTok API request

This guide shows you how to send a synchronous request to each Bright Data TikTok Scraper API endpoint. It covers profiles, posts, TikTok Shop, comments, and posts by profile.

Prerequisites

A Bright Data account with an active API key
Completed the Quickstart

Request structure

Every synchronous request follows the same pattern:

POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://www.tiktok.com/..."}]

The only thing that changes between endpoints is the dataset_id and the input URL format.

The /scrape endpoint is built for real-time, single-URL requests. It accepts up to 20 URLs and waits up to 1 minute. If collection takes longer, the response returns a snapshot_id instead of data and collection continues asynchronously. Fetch the result with async requests or have it pushed to you with webhook delivery.

How to scrape TikTok profiles

Dataset ID: gd_l1villgoiiidt09ci

curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1villgoiiidt09ci&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.tiktok.com/@tiktok"}]'

You should see a 200 response. Processing time varies with target-site conditions and scraper workload.

Example response

[
  {
    "nickname": "TikTok",
    "account_id": "tiktok",
    "biography": "Make your day.",
    "followers": 85600000,
    "following": 580,
    "likes": 520000000,
    "videos_count": 1250,
    "is_verified": true,
    "url": "https://www.tiktok.com/@tiktok",
    "profile_pic_url": "https://..."
  }
]

Full Profiles response schema

How to scrape TikTok posts

Dataset ID: gd_lu702nij2f790tmv9h

curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lu702nij2f790tmv9h&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.tiktok.com/@tiktok/video/7345678901234567890"}]'

Example response

[
  {
    "url": "https://www.tiktok.com/@tiktok/video/7345678901234567890",
    "author": "tiktok",
    "description": "Making every moment count #fyp #trending",
    "likes": 245000,
    "comments": 3200,
    "shares": 18500,
    "views": 5200000,
    "date_posted": "2024-04-10T15:30:00.000Z",
    "hashtags": ["fyp", "trending"],
    "video_url": "https://..."
  }
]

Full Posts response schema

How to scrape TikTok Shop

Dataset ID: gd_m45m1u911dsa4274pi

curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m45m1u911dsa4274pi&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.tiktok.com/@shop/product/1234567890"}]'

Example response

[
  {
    "url": "https://www.tiktok.com/@shop/product/1234567890",
    "product_name": "Wireless Bluetooth Earbuds",
    "price": 29.99,
    "currency": "USD",
    "rating": 4.7,
    "reviews_count": 1850,
    "seller_name": "TechStore Official",
    "category": "Electronics"
  }
]

Full TikTok Shop response schema

How to scrape TikTok comments

Dataset ID: gd_lkf2st302ap89utw5k

curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lkf2st302ap89utw5k&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.tiktok.com/@tiktok/video/7345678901234567890"}]'

Example response

[
  {
    "url": "https://www.tiktok.com/@tiktok/video/7345678901234567890",
    "comment_user": "creator_fan",
    "comment_user_url": "https://www.tiktok.com/@creator_fan",
    "comment_date": "2024-04-11T08:15:00.000Z",
    "comment": "This is amazing content!",
    "likes": 42,
    "replies": 3
  }
]

Full Comments response schema

Posts by Profile Fast API

Dataset ID: gd_m7n5v2gq296pex2f5m

curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m7n5v2gq296pex2f5m&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.tiktok.com/@tiktok"}]'

Example response

[
  {
    "url": "https://www.tiktok.com/@tiktok/video/7345678901234567890",
    "author": "tiktok",
    "description": "Making every moment count #fyp",
    "likes": 245000,
    "comments": 3200,
    "shares": 18500,
    "views": 5200000,
    "date_posted": "2024-04-10T15:30:00.000Z"
  },
  {
    "url": "https://www.tiktok.com/@tiktok/video/7345678901234567891",
    "author": "tiktok",
    "description": "New feature alert! #tiktok #newfeature",
    "likes": 180000,
    "comments": 2100,
    "shares": 9500,
    "views": 3800000,
    "date_posted": "2024-04-08T12:00:00.000Z"
  }
]

Full Posts by Profile Fast API response schema

Quick reference: dataset IDs

Endpoint	Dataset ID	URL pattern
Profiles	`gd_l1villgoiiidt09ci`	`tiktok.com/@{username}`
Posts	`gd_lu702nij2f790tmv9h`	`tiktok.com/@{username}/video/{id}`
TikTok Shop	`gd_m45m1u911dsa4274pi`	`tiktok.com/@shop/product/{id}`
Comments	`gd_lkf2st302ap89utw5k`	`tiktok.com/@{username}/video/{id}`
Posts by Profile Fast API	`gd_m7n5v2gq296pex2f5m`	`tiktok.com/@{username}`

Output formats

Control the response format with the format query parameter:

Value	Description
`json`	JSON array (default)
`ndjson`	Newline-delimited JSON, one record per line
`csv`	Comma-separated values

Async batch requests

Scrape hundreds of URLs in a single batch job.

API reference

Full parameter and response field reference.

Get started

Data extraction

Web access

AI training data

Proxy networks

Send your first TikTok API request

Prerequisites

Request structure

How to scrape TikTok profiles

How to scrape TikTok posts

How to scrape TikTok Shop

How to scrape TikTok comments

Posts by Profile Fast API

Quick reference: dataset IDs

Output formats

Async batch requests

API reference

​Prerequisites

​Request structure

​How to scrape TikTok profiles

​How to scrape TikTok posts

​How to scrape TikTok Shop

​How to scrape TikTok comments

​Posts by Profile Fast API

​Quick reference: dataset IDs

​Output formats

​Related

Async batch requests

API reference

Prerequisites

Request structure

How to scrape TikTok profiles

How to scrape TikTok posts

How to scrape TikTok Shop

How to scrape TikTok comments

Posts by Profile Fast API

Quick reference: dataset IDs

Output formats

Related