Skip to main content
POST /v1/data/tiktok/posts/run Pricing: $0.002 per post ($2.00 per 1,000).

Ways to call it

  • Profile: set profiles (optional: resultsPerPage)
  • Hashtag: set hashtags (optional: resultsPerPage)
  • Keyword: set searchQueries (optional: resultsPerPage)
  • Post URL: set postURLs
  • Sound: set musics (optional: resultsPerPage)

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string
TikTok username or handle to scrape posts from (with or without @).Format e.g. https://www.tiktok.com/@khaby.lame.
string
Hashtag name to scrape posts for (without #).
string
Free-text search query to find matching TikTok posts.
string[]
Direct TikTok video or post URLs to scrape, one per element.
string
TikTok music or sound page URL. Returns posts that use this sound.Format e.g. https://www.tiktok.com/music/sound-7670957197136399134.
integer
Number of posts to return. Use 0 for all.Min 1.

Example

Response fields

Each row in data is one post, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
For creator-level data use tiktok/profiles; for the comments on a video use tiktok/comments.