We also have put together a few AI agents that will help you extract data from social media and turn it into actionable information:
- [Comments Analyzer Agent](https://apify.com/apify/comments-analyzer-agent)
- [Influencer Discovery Agent](https://apify.com/apify/influencer-discovery-agent)
### Frequently asked questions
#### How much does TikTok Data Extractor cost?
TikTok Data Extractor uses the pay-per-result (PPR) pricing model, so your costs can be easily calculated: it will cost you **$5 to scrape 1,000 results**, so $0.005 per item. Apify provides you with $5 free usage credits every month on the [Apify free plan](https://apify.com/pricing), so you can **get 1,000 results from TikTok Data Extractor for free**.
If you need to extract data regularly, we recommend you get an Apify subscription. Not only do you get a greater amount of prepaid credits, you get a discount on your usage costs, as well. Check out the [pricing tab](https://apify.com/clockworks/free-tiktok-scraper/pricing) for more details.
#### Can I use integrations with TikTok Data Extractor?
You can integrate TikTok Data Extractor with almost any cloud service or web app. We offer integrations with **Make, Zapier, Slack, Airbyte, GitHub, Google Sheets, Google Drive**, [and plenty more](https://docs.apify.com/integrations).
Alternatively, you could use [webhooks](https://docs.apify.com/integrations/webhooks) to carry out an action whenever an event occurs, such as getting a notification whenever TikTok Data Extractor successfully finishes a run.
#### Can I use TikTok Data Extractor with the Apify API?
The Apify API gives you programmatic access to the Apify platform. The API is organized around RESTful HTTP endpoints that enable you to manage, schedule, and run Apify Actors. The API also lets you access any datasets, monitor Actor performance, fetch results, create and update versions, and more.
To access the API using Node.js, use the `apify-client` [NPM package](https://apify.com/clockworks/free-tiktok-scraper/api/javascript). To access the API using Python, use the `apify-client` [PyPI package](https://apify.com/clockworks/free-tiktok-scraper/api/python).
Click on the [API tab](https://apify.com/clockworks/free-tiktok-scraper/api/python) for code examples, or check out the [Apify API reference](https://docs.apify.com/api/v2) docs for all the details.
#### Can I use TikTok Data Extractor through an MCP Server?
With Apify API, you can use almost any Actor in conjunction with an MCP server. You can connect to the MCP server using clients like ClaudeDesktop and LibreChat, or even build your own. Read all about how you can [set up Apify Actors with MCP](https://blog.apify.com/how-to-use-mcp/).
For TikTok Data Extractor, go to the [MCP tab](https://apify.com/clockworks/free-tiktok-scraper/api/mcp) and then go through the following steps:
1. Start a Server-Sent Events (SSE) session to receive a `sessionId`
2. Send API messages using that `sessionId` to trigger the scraper
3. The message starts the TikTok Data Extractor with the provided input
4. The response should be: `Accepted`
#### Is it legal to scrape TikTok?
Our scrapers do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly.
However, you should be aware that your results could contain personal data. Personal data is protected by the [GDPR](https://en.wikipedia.org/wiki/General_Data_Protection_Regulation) in the European Union and by other regulations around the world. You
should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You can also read our blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/).
#### Your feedback
We’re always working on improving the performance of our Actors. If you have any technical feedback for TikTok Data Extractor or found a bug, please create an issue in the [Issues tab](https://apify.com/clockworks/free-tiktok-scraper/issues/open).
### Error items
When the scraper cannot retrieve data for a given input — for example a profile is private or a post has been deleted — it pushes an **error item** to the dataset instead of silently skipping it. Normal output items are never affected; you can tell them apart by the presence of an `errorCode` field.
#### Error item structure
```json
{
"url": "https://www.tiktok.com/@someuser",
"input": "someuser",
"error": "Profile is private",
"errorCode": "PROFILE_PRIVATE"
}
```
#### Error codes reference
| `errorCode` | Meaning |
| -------------------------------- | -------------------------------------------------------------- |
| `NOT_FOUND` | Profile or hashtag does not exist |
| `POST_NOT_FOUND_OR_PRIVATE` | Post URL is gone or private |
| `POST_SENSITIVE` | Post is flagged as sensitive content |
| `NO_TRENDING_FOR_HASHTAG` | No ads found for this hashtag |
| `MUSIC_NOT_FOUND` | No videos found for the music tag |
| `SEARCH_QUERY_NOT_FOUND` | No videos found for the search query |
| `SEARCH_QUERY_PROFILE_NOT_FOUND` | No profiles found for the search query |
| `FILTER_NO_PASS` | Videos exist but none match the active date/popularity filters |
| `PROFILE_EMPTY` | Profile has no videos (or is behind a login wall) |
| `PROFILE_REPOSTS_EMPTY` | Profile has no reposts (or is behind a login wall) |
| `PROFILE_STORIES_EMPTY` | Profile has no active story right now |
| `PROFILE_FOLLOWING_EMPTY` | Profile is not following anyone |
| `PROFILE_FOLLOWERS_EMPTY` | Profile has no followers |
| `PROFILE_PRIVATE` | Profile is private |
| `GOOGLE_RUN_NO_RESULTS` | Google-assisted run returned no results |
| `TRENDING_EMPTY` | Trending page returned no results |
| `INVALID_INPUT` | Actor failed due to bad configuration (run is also terminated) |
| `INVALID_URLS` | One or more start URLs were malformed |
# Actor input Schema
## `hashtags` (type: `array`):
Just add one or more TikTok hashtags and the scraper will collect data about videos containing this hashtag: likes, users, followers and more. 
By clicking on the green Export button, you can download the dataset in XML, CSV, Excel, HTML, or JSON.
#### Scraped TikTok hashtags
```json
{
"authorMeta.avatar": "