# ✅ TikTok Search Accounts (`datamagnet/account-search-actor`) Actor Search TikTok accounts by keyword and collect the matching raw profile records exactly as returned by the source. Set a max results limit and the actor will automatically load more pages until it reaches your target or runs out of matches. - **URL**: https://apify.com/datamagnet/account-search-actor.md - **Developed by:** [Datamagnet](https://apify.com/datamagnet) (community) - **Categories:** Social media, Lead generation - **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 ## Account Search Scraper Find TikTok accounts by keyword and collect the matching account records in a simple, business-friendly format. Account Search Scraper is built for marketers, recruiters, researchers, and growth teams who need to discover TikTok profiles fast without manually scrolling through search results. Enter a search term, set how many results you want, and get back the raw account data exactly as returned by the source. It is a practical TikTok account search tool for lead generation, audience research, and creator discovery. ### Key Features - **Find** TikTok accounts that match a keyword you choose. - **Collect** raw account records exactly as they are returned, preserving all available fields. - **Limit** the number of results so you only gather as much data as you need. - **Load** additional pages automatically until your target count is reached or no more matches are available. - **Support** lead generation workflows by surfacing account details in one place. - **Save** time on manual searching by letting the actor do the repetitive work for you. - **Export** results in formats that are easy to review, share, and analyze. ### Use Cases #### Lead Generation Sales and partnership teams can search for accounts related to a niche, brand, or topic and quickly build a list of relevant TikTok profiles. The returned fields such as `nickname`, `unique_id`, `follower_count`, and `signature` help teams decide which accounts are worth outreach. #### Influencer Discovery Influencer marketers can use this actor to find creators whose profile names and bios match a campaign theme. Fields like `follower_count`, `total_favorited`, `avatar_thumb`, and `custom_verify` make it easier to shortlist creators with the right audience size and profile presentation. #### Market Research Researchers and analysts can search for accounts tied to a product category, trend, or audience segment. By reviewing `nickname`, `signature`, `unique_id`, and `account_labels`, they can understand how people and brands position themselves on TikTok. #### Competitor Monitoring Brands can look up competitor-related keywords to identify accounts that appear in search results and compare their public profile details. Information such as `follower_count`, `room_id`, `enterprise_verify_reason`, and `search_highlight` can help teams spot notable accounts and track how they present themselves. #### Creator Vetting Agencies and brand managers can review account records before starting a collaboration. The raw profile data gives a quick snapshot of identity and reach, including `uid`, `sec_uid`, `nickname`, `signature`, and `follower_count`, which supports faster screening. #### Audience Building Growth teams can search for accounts that reflect a target audience or content style and use the results to inspire content strategy. Profile fields like `signature`, `unique_id`, and `avatar_thumb` help teams understand what kinds of accounts are visible for a given keyword. ### Input | Field | Type | Required | Description | Example | |---|---|---:|---|---| | Search keyword | string | Yes | Enter the word or phrase you want to search for. | cat | | Max results | integer | No | The maximum number of matching accounts to collect. The actor keeps loading more results until it reaches this number or runs out of matches. | 100 | ### Output | Field | Type | Description | |---|---|---| | user_info | object | The main account details for the matching TikTok profile, including name, bio, follower count, and other public profile information. | | user_info.uid | string | The internal user identifier for the account. | | user_info.nickname | string | The display name shown on the profile. | | user_info.signature | string | The bio or profile description written by the account owner. | | user_info.avatar_thumb | object | The profile picture information, including image links and size details. | | user_info.avatar_thumb.uri | string | The image reference for the profile picture. | | user_info.avatar_thumb.url_list | array | Direct links to the profile picture in different formats. | | user_info.avatar_thumb.width | integer | The width of the profile image. | | user_info.avatar_thumb.height | integer | The height of the profile image. | | user_info.avatar_thumb.url_prefix | null | A prefix value for image links when available. | | user_info.follow_status | integer | The follow relationship status between the viewer and the account. | | user_info.follower_count | integer | How many followers the account has. | | user_info.total_favorited | integer | How many likes or favorites the account has received in total. | | user_info.custom_verify | string | Any custom verification text shown on the profile. | | user_info.unique_id | string | The public username or handle used to find the account. | | user_info.room_id | integer | The live room identifier if the account has one. | | user_info.enterprise_verify_reason | string | The reason the account is marked as verified for business use, if shown. | | user_info.followers_detail | null | Extra follower details when available. | | user_info.platform_sync_info | null | Additional synced profile information when available. | | user_info.geofencing | null | Location-based visibility information when available. | | user_info.cover_url | array | Cover image links for the profile, if provided. | | user_info.item_list | null | Related content items when available. | | user_info.type_label | null | A label describing the account type when available. | | user_info.ad_cover_url | null | Ad-related cover image links when available. | | user_info.relative_users | null | Related user suggestions when available. | | user_info.cha_list | null | Related hashtag or challenge information when available. | | user_info.sec_uid | string | A secure account identifier used by the source. | | user_info.need_points | null | A points-related field when available. | | user_info.homepage_bottom_toast | null | Any message shown at the bottom of the homepage when available. | | user_info.can_set_geofencing | null | Whether location restrictions can be set for the account. | | user_info.white_cover_url | null | Alternate cover image links when available. | | user_info.user_tags | null | Tags associated with the account when available. | | user_info.bold_fields | null | Fields highlighted by the source when available. | | user_info.search_highlight | null | Text highlighted because it matched the search term. | | user_info.mutual_relation_avatars | null | Avatars of mutual connections when available. | | user_info.room_id_str | string | The live room identifier as text. | | user_info.events | null | Event-related information when available. | | user_info.advance_feature_item_order | null | Ordering information for advanced profile features when available. | | user_info.advanced_feature_info | null | Extra feature details shown on the profile when available. | | user_info.user_profile_guide | null | Guidance or prompts related to the profile when available. | | user_info.shield_edit_field_info | null | Information about fields that may be hidden or restricted. | | user_info.can_message_follow_status_list | null | Messaging availability details when available. | | user_info.account_labels | null | Labels attached to the account when available. | | position | null | Position information in the search results when available. | | uniqid_position | null | Position information for the unique username when available. | | effects | null | Effect-related data when available. | | musics | null | Music-related data when available. | | items | null | Content items linked to the account when available. | | mix_list | null | Mix or playlist information when available. | | challenges | null | Challenge-related information when available. | ### Sample Output ```json { "user_info": { "uid": "7617910736928785429", "nickname": "cats2", "signature": "Love ❤️", "avatar_thumb": { "uri": "tos-alisg-avt-0068/d330d68334c6becf54ab651a17f44c50", "url_list": [ "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/d330d68334c6becf54ab651a17f44c50~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=musically_user.user_cover&dr=14635&idc=my2&ps=82dc5187&refresh_token=801947ef&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1784613600&x-signature=VFF1CafIK6r7U2mccprx6ADajD8%3D", "https://p19-common-sign.tiktokcdn.com/tos-alisg-avt-0068/d330d68334c6becf54ab651a17f44c50~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=musically_user.user_cover&dr=14635&idc=my2&ps=82dc5187&refresh_token=402196b7&shcp=c1333099&shp=30310797&t=4d5b0474&x-expires=1784613600&x-signature=7ias88QX632eqk4KcHYOrDrzHE4%3D" ], "width": 720, "height": 720, "url_prefix": null }, "follow_status": 0, "follower_count": 1782872, "total_favorited": 1312550, "custom_verify": "", "unique_id": "cats2balla", "room_id": 0, "enterprise_verify_reason": "", "followers_detail": null, "platform_sync_info": null, "geofencing": null, "cover_url": [], "item_list": null, "type_label": null, "ad_cover_url": null, "relative_users": null, "cha_list": null, "sec_uid": "MS4wLjABAAAAIn83kehItHzi4XiH1YnQFzeJnoPs3YGbNVKCZXOEpva82CpSR3Xf58tjAmZtSLPu", "need_points": null, "homepage_bottom_toast": null, "can_set_geofencing": null, "white_cover_url": null, "user_tags": null, "bold_fields": null, "search_highlight": null, "mutual_relation_avatars": null, "room_id_str": "0", "events": null, "advance_feature_item_order": null, "advanced_feature_info": null, "user_profile_guide": null, "shield_edit_field_info": null, "can_message_follow_status_list": null, "account_labels": null }, "position": null, "uniqid_position": null, "effects": null, "musics": null, "items": null, "mix_list": null, "challenges": null } ```` ### How It Works 1. You enter a keyword that describes the accounts you want to find. 2. You choose how many results you want to collect, or leave the default limit in place. 3. The actor searches for matching TikTok accounts and gathers the returned profile records. 4. If more results are needed, it keeps loading additional pages automatically. 5. When it reaches your limit or there are no more matches, your dataset is ready to review. ### 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**. The actor will collect matching TikTok account records for you automatically. When it finishes, you can download the results as JSON, CSV, or Excel and use them in your own workflow. ### Frequently Asked Questions #### Do I need technical skills? No. This actor is designed for business users who want results without dealing with code. You only need to enter a keyword and choose how many results you want. #### How fast does it run? Speed depends on how many matching accounts are available and how many results you request. Smaller searches usually finish quickly, while larger searches may take longer because the actor keeps collecting more pages until it reaches your limit. #### What format is the output? Your results are available in easy-to-use formats such as JSON, CSV, and Excel. The data is also returned as raw account records, so you can keep all available fields for analysis or reporting. #### Is this legal to use? You should always use the data in a way that follows applicable laws, platform rules, and your own internal policies. This tool is meant to help you collect publicly available account search results for legitimate business use. #### Can I schedule it to run automatically? Yes, you can run it whenever you need fresh results, including on a recurring schedule if that fits your workflow. This is useful for ongoing research, lead lists, and monitoring keyword-based account discovery over time. # Actor input Schema ## `keyword` (type: `string`): Enter the word or phrase you want to search for. ## `max_results` (type: `integer`): Maximum number of results to collect. The actor will keep loading more results until this limit is reached or there are no more results. ## 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", "max_results": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("datamagnet/account-search-actor").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", "max_results": 100, } # Run the Actor and wait for it to finish run = client.actor("datamagnet/account-search-actor").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", "max_results": 100 }' | apify call datamagnet/account-search-actor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=datamagnet/account-search-actor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "✅ TikTok Search Accounts", "description": "Search TikTok accounts by keyword and collect the matching raw profile records exactly as returned by the source. Set a max results limit and the actor will automatically load more pages until it reaches your target or runs out of matches.", "version": "0.0", "x-build-id": "BSpmY44yjCQmpN5jW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datamagnet~account-search-actor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datamagnet-account-search-actor", "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~account-search-actor/runs": { "post": { "operationId": "runs-sync-datamagnet-account-search-actor", "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~account-search-actor/run-sync": { "post": { "operationId": "run-sync-datamagnet-account-search-actor", "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": "Search keyword", "type": "string", "description": "Enter the word or phrase you want to search for." }, "max_results": { "title": "Max results", "type": "integer", "description": "Maximum number of results to collect. The actor will keep loading more results until this limit is reached or there are no more results." } } }, "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 } } } } } } } } } } ```