No-Code scraper · JSON API

TikTok Scraper

Collect public TikTok video and profile data with content metadata and engagement counts.

JSON CSV & XLSX API access

Read the API reference →

From web pages to a dataset

What you can do

Research videos for selected profiles or topics.

Compare public video engagement.

Export structured content data.

Set your sources

Open the scraper and enter your own URLs, search terms and limits.

Review & run

Check the cost estimate and confirm the task. Follow its progress in your account.

Use your data

Explore saved results and export CSV, JSON or XLSX. Downloads of saved results are free.

Know what to expect

Sample data & output fields

Illustrative example

These example values demonstrate the data shape; they are not a live scraper result. Available fields depend on the source, selected options and upstream data.

JSON · illustrative result

[
  {
    "id": "example-001",
    "title": "Example title",
    "views": 100,
    "likes": 100,
    "comments": 100
  }
]

Field	Type	Description
`id`	string	Id.
`title`	string	Title.
`views`	number	Views.
`likes`	number	Likes.
`comments`	number	Comments.

Start with a real configuration

Example input

This is the configured parser input. Replace the example sources with your own and review all limits before running.

JSON · example input

{
  "customMapFunction": "(object) => { return {...object} }",
  "dateRange": "DEFAULT",
  "includeSearchKeywords": false,
  "keywords": [
    "Artificial Intelligence",
    "podcast"
  ],
  "location": "US",
  "maxItems": 1000,
  "sortType": "RELEVANCE",
  "startUrls": [
    "https://www.tiktok.com/@billieeilish/video/7050551461734042926",
    "https://www.tiktok.com/@rabbitbrandmy/photo/7553874290735729940",
    "https://www.tiktok.com/@gordonramsayofficial",
    "https://www.tiktok.com/search?q=Recipes",
    "https://www.tiktok.com/tag/duet",
    "https://www.tiktok.com/music/original-sound-Newcastle-United-7297730198175402784",
    "https://www.tiktok.com/place/New-York-22535796481546927"
  ]
}

Explore input fields

Field	Type	Notes
`customMapFunction`	string	Function that takes each of the objects as argument and returns data that will be mapped by the function itself. This function is not intended for filtering, please don't use it for filtering purposes or you will get banned automatically.
`dateRange`	string	Date range for search. It uses the standard date filtering of TikTok search.
`includeSearchKeywords`	boolean	If selected, a field will be added to each tweets about the search keyword that was used to find it.
`keywords`	array	Search keywords/terms you want to search from TikTok.
`location`	string	Enables the actor to retrieve the results from that specific region/location, given by an ISO 3166-1 alpha-2 country code.
`maxItems`	integer	Maximum number of items that you want as output.
`sortType`	string	Sort type for search. Only works with keyword search — does not apply to startUrls or other input methods.
`startUrls`	array	Paste the TikTok URLs, and get the results immediately. Video, Photo, User, Search, Tag, Music and Location URLs are supported.

The same scraper in your application

Run through the API

Create an API key in your account, send the input to the queued endpoint and use the returned task ID to retrieve results. Sending a live request uses credits.

cURL · queue a task

curl --request POST 'https://extracto.cloud/api/v1/parsers/tiktok-scraper/queue' \
  --header 'X-API-KEY: ext_your_api_key' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data-binary @- <<'JSON'
{
  "input": {
    "customMapFunction": "(object) => { return {...object} }",
    "dateRange": "DEFAULT",
    "includeSearchKeywords": false,
    "keywords": [
      "Artificial Intelligence",
      "podcast"
    ],
    "location": "US",
    "maxItems": 1000,
    "sortType": "RELEVANCE",
    "startUrls": [
      "https://www.tiktok.com/@billieeilish/video/7050551461734042926",
      "https://www.tiktok.com/@rabbitbrandmy/photo/7553874290735729940",
      "https://www.tiktok.com/@gordonramsayofficial",
      "https://www.tiktok.com/search?q=Recipes",
      "https://www.tiktok.com/tag/duet",
      "https://www.tiktok.com/music/original-sound-Newcastle-United-7297730198175402784",
      "https://www.tiktok.com/place/New-York-22535796481546927"
    ]
  }
}
JSON

Configure your task API quickstart

Your next dataset starts here.

Choose your sources, review the price and run TikTok Scraper.

Open scraper