### Your feedback
We’re always working on improving the performance of our Actors. So if you’ve got any technical feedback for TikTok User Search Scraper or simply found a bug, please create an issue on the Actor’s [Issues tab](https://apify.com/clockworks/tiktok-user-search-scraper/issues/open) in Apify Console.
### ❓FAQ
#### How much does it cost to use TikTok User Search Scraper?
TikTok User Search Scraper uses the pay-per-result pricing model, so your costs can be easily calculated: it will cost you **$6 to scrape 1,000 results** on the Free plan, so $0.006 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 over 800 results from TikTok User Search Scraper for free**. Discounts per result apply on paid plans, so you pay less as you scale. Check the [full pricing for every plan](https://apify.com/clockworks/tiktok-user-search-scraper/pricing).
#### How can I use TikTok User Search scraper with the Apify API?
The Apify API gives you programmatic access to the Apify platform. [The API](https://apify.com/clockworks/tiktok-user-search-scraper/api/python) 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. To access the API using Python, use the `apify-client` PyPI package.
Check out the [Apify API reference](https://docs.apify.com/api/v2) docs for full details or click on the [TikTok User Search Scraper API tab](https://apify.com/clockworks/tiktok-user-search-scraper/api/python) for code examples.
#### Is it legal to scrape TikTok with TikTok User Search Scraper?
Our [TikTok scrapers](https://apify.com/store?search=tiktok), TikTok User Search Scraper included, are ethical and **do not extract any private user data, such as email addresses, gender, or location.** They can only extract what the user has chosen to share publicly. However, you should be aware that your results might contain personal data.
Personal data is protected by GDPR in the European Union and other laws and 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/) and [ethical scraping](https://blog.apify.com/what-is-ethical-web-scraping-and-how-do-you-do-it/).
### Error items
When the scraper cannot retrieve data for a given search query, 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
{
"input": "zzqxnonexistentterm99812734xyz",
"searchQuery": "zzqxnonexistentterm99812734xyz",
"error": "No profiles found for the search query",
"errorCode": "SEARCH_QUERY_PROFILE_NOT_FOUND"
}
```
#### Error codes reference
| `errorCode` | Meaning |
| -------------------------------- | -------------------------------------------------------------- |
| `SEARCH_QUERY_PROFILE_NOT_FOUND` | No profiles found for the search query |
| `INVALID_INPUT` | Actor failed due to bad configuration (run is also terminated) |
# Changelog
This Actor's version history is a separate document: https://apify.com/clockworks/tiktok-user-search-scraper/changelog.md
# Actor input Schema
## `searchQueries` (type: `array`):
Your keyword will apply to profiles. As for your query's format, you can use any query that works on TikTok.
## `maxProfilesPerQuery` (type: `integer`):
The maximum number of profiles to extract per query
## Actor input object example
```json
{
"searchQueries": [
"cats"
],
"maxProfilesPerQuery": 10
}
```
# Actor output Schema
## `dataset` (type: `string`):
Dataset containing all scraped data
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '