TikTok Scraper API
A powerful data extraction tool that allows AI agents to retrieve trending TikTok videos by country, search queries, or hashtags. It also fetches detailed metadata for specific TikTok videos using their post URLs. Powered by Apify.
Connect this API to an AI agent Browse all specs
What you can do with TikTok Scraper API via MCP
Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.
| Method | Path | Operation | Description |
|---|---|---|---|
| POST | /acts/clockworks~free-tiktok-scraper/run-sync-get-dataset-items |
getTikTokTrendingVideos | Get trending TikTok videos by country, search query, or hashtag Method: POST Path: /acts/clockworks~free-tiktok-scraper/run-sync-get-dataset-items IMPORTANT: This function has 1 REQUIRED parameter(s) and 1 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Request Body: REQUIRED: - searchQueries: Search keywords or trending topics (e.g., ['trending us'], ['trending uk'], ['#dance']) OPTIONAL: - resultsPerPage: Maximum number of video results to return |
| POST | /acts/clockworks~free-tiktok-scraper/run-sync-get-dataset-items#details |
getTikTokVideoDetails | Get detailed TikTok video info by post URL Method: POST Path: /acts/clockworks~free-tiktok-scraper/run-sync-get-dataset-items#details IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Request Body: REQUIRED: - postURLs: List of TikTok video URLs to scrape detailed information from |
Usage guide
## Getting Credentials for Apify This integration uses **Apify** to scrape data from TikTok. To use it, you need to provide your personal Apify API Token. Follow these steps to obtain your credentials: ### Step 1: Create an Apify Account 1. Go to [Apify.com](https://apify.com/) and click **Sign Up** to create a free account. 2. If you already have an account, simply log in to your Apify Console. ### Step 2: Obtain Your API Token 1. In the Apify Console, navigate to the left-hand menu and click on **Settings** (the gear icon). 2. Go to the **Integrations** tab. 3. Locate the **Personal API token** section. 4. Click the eye icon to reveal your token, or click the copy icon to copy it to your clipboard. ### Step 3: Authenticate the Agent Paste the copied Apify API Token into the Authentication/API Key field of this plugin. > **Note:** This integration uses the `clockworks~free-tiktok-scraper` actor. Ensure your Apify account has sufficient usage credits to perform the scraping tasks.
How to use this spec
- Create a free VX Agents account (sandbox tools included).
- Open the marketplace and connect “TikTok Scraper API” to an agent.
- Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.