# ✅ TikTok Search Results Scraper (`datamagnet/search-general-top`) Actor Search TikTok by keyword and collect matching results in plain data form. It returns the raw search response exactly as provided, including all available fields and pagination metadata, and can automatically gather more results until your limit is reached. - **URL**: https://apify.com/datamagnet/search-general-top.md - **Developed by:** [Datamagnet](https://apify.com/datamagnet) (community) - **Categories:** Social media, Videos - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Keyword Search Results Scraper Keyword Search Results Scraper helps you find TikTok content by keyword and turn the matching results into clean, ready-to-use data. It is built for marketers, researchers, creators, and analysts who want to quickly collect TikTok search results without manual scrolling. Use it to discover videos, creators, captions, engagement stats, and other rich fields tied to a search term. If you need a simple TikTok search scraper, keyword extractor, or data collector for content research, this actor is designed for that job. ### Key Features - **Extract** TikTok search results for any keyword you enter. - **Collect** multiple pages of results automatically until your limit is reached. - **Return** the raw search data exactly as provided, so you keep all available fields. - **Capture** useful content details such as captions, creator profiles, music info, and engagement stats. - **Save** time by replacing manual searching and copying with one simple run. - **Support** research workflows that need plain data for analysis, reporting, or enrichment. - **Deliver** results in a format that is easy to export and reuse in other tools. ### Use Cases #### Market Research Brand and strategy teams use this actor to search TikTok for a product, topic, or trend keyword and review the matching videos. The returned fields like `desc`, `stats`, `createTime`, and `author.nickname` help teams understand what kind of content is performing well and who is posting it. This makes it easier to spot audience interests, content angles, and emerging themes. #### Influencer Discovery Agencies and creator partnerships teams can search for niche terms and identify creators whose videos appear in the results. Fields such as `author.uniqueId`, `author.followerCount`, `author.verified`, and `author.signature` help evaluate whether a creator fits a campaign. The actor gives you a fast way to build a shortlist of potential partners based on real search visibility. #### Content Performance Analysis Social media managers can use the output to compare how different videos perform for the same keyword. Metrics like `stats.playCount`, `stats.diggCount`, `stats.commentCount`, `stats.shareCount`, and `stats.collectCount` show which posts are getting attention. This helps teams decide what style of content to create next and which topics deserve more promotion. #### Competitive Monitoring Businesses can search for competitor names, product categories, or campaign phrases to see what content appears in TikTok search. The returned creator and video fields make it easy to track how competitors present themselves, what messages they use, and how audiences respond. This supports ongoing monitoring without needing to manually check search results every day. #### Trend and Topic Research Researchers and trend watchers can search broad keywords like a hobby, meme, or seasonal topic and collect a set of matching posts. The actor returns the full search result data, including video details, music information, and text snippets, which helps reveal how a topic is being discussed on TikTok. This is useful for editorial planning, audience research, and trend reports. #### Lead and Partner Prospecting Sales and partnership teams can search for industry-related keywords and identify accounts that are actively posting relevant content. Creator profile fields and engagement stats help teams prioritize accounts that are visible, active, and potentially valuable for outreach. This creates a practical list for collaboration, sponsorship, or community-building efforts. ### Input | Field | Type | Required | Description | Example | |---|---|---:|---|---| | keyword | string | Yes | The word or phrase you want to search for. | cat | | max_results | integer | No | The maximum number of matching results to collect before stopping. | 100 | ### Output | Field | Type | Description | |---|---|---| | author | object | Information about the creator of the video, including profile image, name, follower count, and account details. | | challenges | array | Any challenge tags connected to the video. | | collected | boolean | Shows whether the item was marked as collected. | | createTime | integer | The time the video was created, shown as a timestamp. | | desc | string | The video caption or description text. | | digged | boolean | Indicates whether the item was liked or marked in a way shown by the source. | | duetEnabled | boolean | Shows whether duet is enabled for the video. | | duetInfo | object | Details about duet-related information for the video. | | forFriend | boolean | Indicates whether the video is intended for friends. | | id | string | The unique ID of the video. | | isAd | boolean | Shows whether the item is an advertisement. | | itemCommentStatus | integer | The comment status for the item. | | itemMute | boolean | Indicates whether the item is muted. | | music | object | Information about the sound used in the video, including title, creator, and play link. | | officalItem | boolean | Indicates whether the item is official. | | originalItem | boolean | Shows whether the video is original content. | | privateItem | boolean | Indicates whether the item is private. | | secret | boolean | Indicates whether the item is hidden or restricted. | | shareEnabled | boolean | Shows whether sharing is allowed. | | showNotPass | boolean | Indicates whether the item is shown as not passing a check. | | stats | object | Engagement numbers such as views, likes, comments, shares, downloads, and saves. | | stitchEnabled | boolean | Shows whether stitch is enabled for the video. | | textExtra | array | Extra text elements or tags attached to the post. | | video | object | Video details such as cover image, playback links, size, quality, and duration. | | vl1 | boolean | A source-provided flag included with the result. | ### Sample Output ```json { "author": { "avatarLarger": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/590d80a91770c77b5683c116666e63db~tplv-tiktokx-cropcenter:1080:1080.webp?dr=14635&refresh_token=629485d5&x-expires=1784613600&x-signature=tjugyroPBg4Gz1iearicjSEOiD0%3D&t=4d5b0474&ps=82dc5187&shp=d05b14bd&shcp=34ff8df6&idc=my2", "avatarMedium": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/590d80a91770c77b5683c116666e63db~tplv-tiktokx-cropcenter:720:720.webp?dr=14635&refresh_token=a8d77f58&x-expires=1784613600&x-signature=saKtK4736sfMNdTFqzZ03XSpmvw%3D&t=4d5b0474&ps=82dc5187&shp=d05b14bd&shcp=34ff8df6&idc=my2", "avatarThumb": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/590d80a91770c77b5683c116666e63db~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=musically_general.video_user_cover&dr=14635&idc=my2&ps=82dc5187&refresh_token=eb93d612&shcp=34ff8df6&shp=d05b14bd&t=4d5b0474&x-expires=1784613600&x-signature=HYs6Xu%2FAQQRTT554CMxpiZiFrV4%3D", "commentSetting": 0, "downloadSetting": 0, "duetSetting": 0, "ftc": false, "id": "7351058192253846535", "nickname": "Nabins", "openFavorite": false, "privateAccount": false, "relation": 0, "followerCount": 332985, "followingCount": 0, "secUid": "MS4wLjABAAAASiYtSwRhWw05eK-VNVYFmiDIeq4Vo8syusqwboiQ5txA0D9-Aobv8lr9uSiHtmhn", "secret": false, "signature": "저는 달에 갈거예요\nContact-iamnabins2@gmail.com\nModel @Mito_Arisaka", "stitchSetting": 0, "uniqueId": "iamnabins", "verified": false }, "challenges": [], "collected": false, "createTime": 1784505600, "desc": "The cat that just wanted to drink in peace... 🥶", "digged": false, "duetEnabled": false, "duetInfo": { "duetFromId": "0" }, "forFriend": false, "id": "7664176756164709640", "isAd": false, "itemCommentStatus": 0, "itemMute": false, "music": { "album": "", "authorName": "Nabins", "coverLarge": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/590d80a91770c77b5683c116666e63db~tplv-tiktokx-cropcenter:100:100.webp?dr=14635&refresh_token=eb93d612&x-expires=1784613600&x-signature=HYs6Xu%2FAQQRTT554CMxpiZiFrV4%3D&t=4d5b0474&ps=82dc5187&shp=d05b14bd&shcp=34ff8df6&idc=my2", "coverMedium": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/590d80a91770c77b5683c116666e63db~tplv-tiktokx-cropcenter:100:100.webp?dr=14635&refresh_token=eb93d612&x-expires=1784613600&x-signature=HYs6Xu%2FAQQRTT554CMxpiZiFrV4%3D&t=4d5b0474&ps=82dc5187&shp=d05b14bd&shcp=34ff8df6&idc=my2", "coverThumb": "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/590d80a91770c77b5683c116666e63db~tplv-tiktokx-cropcenter:100:100.webp?dr=14635&refresh_token=eb93d612&x-expires=1784613600&x-signature=HYs6Xu%2FAQQRTT554CMxpiZiFrV4%3D&t=4d5b0474&ps=82dc5187&shp=d05b14bd&shcp=34ff8df6&idc=my2", "duration": 27, "id": "7664176793936595719", "original": false, "playUrl": "https://sf16-ies-music-sg.tiktokcdn.com/obj/tiktok-obj/7664393207895313170.mp3", "title": "original sound - Nabins" }, "officalItem": false, "originalItem": false, "privateItem": false, "secret": false, "shareEnabled": true, "showNotPass": false, "stats": { "collectCount": 134, "downloadCount": 8, "commentCount": 36, "diggCount": 1347, "playCount": 13970, "shareCount": 55 }, "stitchEnabled": false, "textExtra": [], "video": { "bitrate": 963530, "cover": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/o4fd5f3ABACEA4g93yDBpqQuXIA9yPVjJFACCY~tplv-tiktokx-origin.image?biz_tag=musically_general.video_cover&dr=14631&idc=my2&ps=82dc5187&refresh_token=80876e3c&s=SEARCH&shcp=34ff8df6&shp=d05b14bd&t=4d5b0474&x-expires=1784613600&x-signature=G6SrRtQrRp1ASiwzlo3%2Bhdxbx7Y%3D", "downloadAddr": "https://v16me.tiktokcdn.com/c9c25686e397f143a009a7ae445903b1/6a5f0f95/video/tos/alisg/tos-alisg-pve-0037/oEAToTXhGEVI0ce7AvLQSPrpKDeIUGDIIcAeEu/?a=1340&bti=NTY6QGo0QHM6OjZANDQuYCMucCMxNDNg&&bt=1795&eid=20480&ft=BIhA7V0xwoCRfjCEdbOx2kEGCgpiPBgkQjKJr9vLEN0P3-I&mime_type=video_mp4&rc=ZWdlNGU6NDY3NWU4Zjs7ZkBpM2RoaXk5cnc8PDMzODgzNUAvMGFiL2JeXjQxLy4uMS4tYSNucmY1MmQ0cmJhLS1kLzZzcw%3D%3D&vvpl=1&l=2026072014193775FCF572DFF1E26E4D87&btag=e000b8000", "duration": 27400, "dynamicCover": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/o4fd5f3ABACEA4g93yDBpqQuXIA9yPVjJFACCY~tplv-tiktokx-origin.image?biz_tag=musically_general.video_cover&dr=14631&idc=my2&ps=82dc5187&refresh_token=80876e3c&s=SEARCH&shcp=34ff8df6&shp=d05b14bd&t=4d5b0474&x-expires=1784613600&x-signature=G6SrRtQrRp1ASiwzlo3%2Bhdxbx7Y%3D", "encodeUserTag": "", "encodedType": "normal", "height": 1920, "id": "7664176756164709640", "originCover": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/oMeUkvrZE8GuTcIIDoL7pI6DD06eIADeTKAShA~tplv-tiktokx-360p.webp?dr=14611&refresh_token=c312b41d&x-expires=1784613600&x-signature=upqyn2of6F7iY3kTJyV7ovUAfmw%3D&t=4d5b0474&ps=82dc5187&shp=d05b14bd&shcp=34ff8df6&idc=my2&s=SEARCH&ftpl=1", "playAddr": "https://v16me.tiktokcdn.com/e60fe1b56a9d1c7b982cd3e3bdb8949f/6a5f0f95/video/tos/alisg/tos-alisg-pve-0037/oUThSLGbrEDFtERp5cIIe7DAoQvAEeJTuUe0K5/?a=1340&bti=NTY6QGo0QHM6OjZANDQuYCMucCMxNDNg&&bt=2774&ft=BIhA7V0xwoCRfjCEdbOx2kEGCgpiPBgkQjKJr9vLEN0P3-I&mime_type=video_mp4&rc=aWQ1NTY2aTplZjM0ZDlpaEBpM2RoaXk5cnc8PDMzODgzNUAyL182NC0wXmIxXy8tNmAuYSNucmY1MmQ0cmJhLS1kLzZzcw%3D%3D&vvpl=1&l=2026072014193775FCF572DFF1E26E4D87&btag=e000b8000", "ratio": "1080p", "reflowCover": "", "shareCover": [], "videoQuality": "normal", "width": 1080 }, "vl1": false } ```` ### How It Works 1. You enter the keyword you want to search for. 2. The actor looks up matching TikTok results and gathers the first set of items. 3. If more results are available, it keeps collecting them automatically until your limit is reached. 4. The actor returns the search results in a clean data format with all available fields preserved. 5. You review, export, or reuse the results for research, reporting, or enrichment. ### Getting Started Getting started is simple and does not require coding. Click **Try for free**, enter your search keyword, optionally set the maximum number of results, and click **Run**. In a short time, your results will be ready to review and download. You can work with the output as JSON, CSV, or Excel, depending on how you want to analyze or share the data. ### Frequently Asked Questions #### Do I need technical skills? No. This actor is designed for non-technical users who want search results without manual copying. You only need to enter a keyword and start the run. #### How fast does it run? Speed depends on how many results are available for your keyword and how many you ask for. Smaller searches finish quickly, while larger searches may take longer because the actor keeps collecting more matching results when available. #### What format is the output? The output is delivered in a clean data format that you can export and use in common spreadsheet and analysis tools. You can also work with it as JSON, CSV, or Excel after the run. #### Is this legal to use? Using search data for research, analysis, and internal business workflows is common, but you should always make sure your use complies with applicable laws, platform rules, and your own policies. If you plan to use the data commercially, review your intended use carefully. #### Can I schedule it to run automatically? Yes, you can set it up to run on a schedule if you want regular updates for a keyword, topic, or competitor search. This is useful for ongoing monitoring and trend tracking. # Actor input Schema ## `keyword` (type: `string`): The search term to look up. ## `max_results` (type: `integer`): The maximum number of results to return. ## Actor input object example ```json { "keyword": "cat", "max_results": 100 } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "keyword": "cat" }; // Run the Actor and wait for it to finish const run = await client.actor("datamagnet/search-general-top").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "keyword": "cat" } # Run the Actor and wait for it to finish run = client.actor("datamagnet/search-general-top").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "keyword": "cat" }' | apify call datamagnet/search-general-top --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=datamagnet/search-general-top", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "✅ TikTok Search Results Scraper", "description": "Search TikTok by keyword and collect matching results in plain data form. It returns the raw search response exactly as provided, including all available fields and pagination metadata, and can automatically gather more results until your limit is reached.", "version": "0.0", "x-build-id": "AQKQy6w4XPCRMWn1e" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datamagnet~search-general-top/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datamagnet-search-general-top", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/datamagnet~search-general-top/runs": { "post": { "operationId": "runs-sync-datamagnet-search-general-top", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/datamagnet~search-general-top/run-sync": { "post": { "operationId": "run-sync-datamagnet-search-general-top", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "keyword" ], "properties": { "keyword": { "title": "Keyword", "type": "string", "description": "The search term to look up." }, "max_results": { "title": "Max results", "type": "integer", "description": "The maximum number of results to return." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```