# Influencer Search — AI-Powered Discovery by Influship (`influship/influencer-search`) Actor Search for Instagram influencers using natural language. Find creators by niche, location, audience size, engagement rate, and content style using AI-powered semantic search. Powered by Influship. - **URL**: https://apify.com/influship/influencer-search.md - **Developed by:** [Influship](https://apify.com/influship) (community) - **Categories:** Social media, E-commerce, AI - **Stats:** 5 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ## Influencer Search — AI-Powered Creator Discovery Find the perfect influencers for your brand using natural language search powered by AI. Simply describe the type of creator you're looking for, and get back detailed profiles with engagement metrics, audience data, and relevance scores. ### What is Influencer Search? Influencer Search uses AI-powered semantic search to find social media creators that match your campaign needs. Instead of filtering by rigid categories, describe what you want in plain English — like "fitness influencers who post workout routines and promote healthy eating" — and get ranked results with match scores and reasons. ### What can this actor do? - **Natural language search** — Describe your ideal influencer in plain English - **AI-powered matching** — Results ranked by semantic relevance, not just keywords - **Rich profile data** — Follower counts, engagement rates, posting frequency, growth metrics - **Filter by metrics** — Set minimum/maximum followers, engagement rate, verified status - **Platform filtering** — Search specific platforms (Instagram, more coming soon) - **Pagination** — Get up to 100 results per run ### What data can you extract? Each result has four top-level objects: `creator`, `match`, `primary_profile`, and `relevant_profile`. Profile objects may be `null` when no profile is available for the platform. | Field | Description | |-------|-------------| | `creator.id` | Creator unique identifier | | `creator.name` | Display name of the creator | | `creator.bio` | Profile biography | | `creator.avatar_url` | Profile picture URL | | `match.score` | 0–1 relevance score for your query | | `match.reasons` | AI-generated explanations of why this creator matches | | `primary_profile.platform` | The creator's primary platform | | `primary_profile.username` | Platform handle | | `primary_profile.url` | Profile URL | | `primary_profile.followers` | Total follower count | | `primary_profile.engagement_rate` | Engagement rate as a percentage (e.g. `3.5` = 3.5%) | | `primary_profile.is_verified` | Whether the account is verified | | `relevant_profile.*` | Same shape as `primary_profile` — the profile most relevant to your query (may match `primary_profile`) | ### How to use 1. Enter your search query describing the type of influencer you need 2. Optionally set filters (follower range, engagement rate, verified only) 3. Set max results (default 25, up to 100) 4. Run the actor 5. Download results as JSON, CSV, or Excel ### Input example ```json { "query": "sustainable fashion influencers with engaged audience in the US", "minFollowers": 10000, "maxFollowers": 500000, "minEngagementRate": 0.02, "maxResults": 50 } ```` ### Output example ```json { "creator": { "id": "550e8400-e29b-41d4-a716-446655440000", "name": "Sustainable Style Co", "bio": "Ethical fashion | Slow living | NYC", "avatar_url": "https://..." }, "match": { "score": 0.92, "reasons": [ "Focuses on sustainable and ethical fashion content", "Strong engagement rate of 3.4% indicates active audience", "Based in NYC, aligns with US market" ] }, "primary_profile": { "id": "abc-123", "platform": "instagram", "username": "sustainablestyleco", "url": "https://instagram.com/sustainablestyleco", "followers": 85000, "engagement_rate": 3.4, "is_verified": false }, "relevant_profile": { "id": "abc-123", "platform": "instagram", "username": "sustainablestyleco", "url": "https://instagram.com/sustainablestyleco", "followers": 85000, "engagement_rate": 3.4, "is_verified": false } } ``` ### Pricing This actor uses **pay-per-event** pricing: - **Actor start**: Small fee per run - **Per result**: Fee for each creator returned Platform usage costs are included — you only pay the per-event fees. ### FAQ **How fresh is the data?** Search results are returned live from Influship's AI-powered discovery engine. Creator profiles are real-time — no stale cache. Results reflect current follower counts, engagement rates, and recent posts. **What platforms are supported?** Currently Instagram. YouTube and TikTok support is coming soon. **Can I use this with the Apify API?** Yes! Call this actor via the Apify API or any Apify integration (Zapier, Make, etc.) **Need more features?** Check out our other actors for profile lookup, lookalike search, and campaign matching. # Actor input Schema ## `query` (type: `string`): Natural language description of the creators you're looking for. Example: 'fitness influencers who post workout routines and have high engagement' ## `platforms` (type: `array`): Filter by social media platform. Leave empty to search all platforms. ## `minFollowers` (type: `integer`): Minimum number of followers ## `maxFollowers` (type: `integer`): Maximum number of followers ## `minEngagementRate` (type: `number`): Minimum engagement rate (0.01 = 1%) ## `maxEngagementRate` (type: `number`): Maximum engagement rate (0.01 = 1%) ## `verified` (type: `boolean`): Only return verified accounts ## `maxResults` (type: `integer`): Maximum number of results to return (1-100) ## Actor input object example ```json { "query": "fitness influencers with high engagement who post workout content", "platforms": [], "verified": false, "maxResults": 25 } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 = { "query": "fitness influencers with high engagement who post workout content" }; // Run the Actor and wait for it to finish const run = await client.actor("influship/influencer-search").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 = { "query": "fitness influencers with high engagement who post workout content" } # Run the Actor and wait for it to finish run = client.actor("influship/influencer-search").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 '{ "query": "fitness influencers with high engagement who post workout content" }' | apify call influship/influencer-search --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=influship/influencer-search", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Influencer Search — AI-Powered Discovery by Influship", "description": "Search for Instagram influencers using natural language. Find creators by niche, location, audience size, engagement rate, and content style using AI-powered semantic search. Powered by Influship.", "version": "0.0", "x-build-id": "la3cPgTnPg9w2TCbZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/influship~influencer-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-influship-influencer-search", "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/influship~influencer-search/runs": { "post": { "operationId": "runs-sync-influship-influencer-search", "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/influship~influencer-search/run-sync": { "post": { "operationId": "run-sync-influship-influencer-search", "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": [ "query" ], "properties": { "query": { "title": "Search Query", "type": "string", "description": "Natural language description of the creators you're looking for. Example: 'fitness influencers who post workout routines and have high engagement'" }, "platforms": { "title": "Platforms", "type": "array", "description": "Filter by social media platform. Leave empty to search all platforms.", "items": { "type": "string", "enum": [ "instagram" ] }, "default": [] }, "minFollowers": { "title": "Minimum Followers", "minimum": 0, "type": "integer", "description": "Minimum number of followers" }, "maxFollowers": { "title": "Maximum Followers", "minimum": 0, "type": "integer", "description": "Maximum number of followers" }, "minEngagementRate": { "title": "Minimum Engagement Rate", "minimum": 0, "maximum": 1, "type": "number", "description": "Minimum engagement rate (0.01 = 1%)" }, "maxEngagementRate": { "title": "Maximum Engagement Rate", "minimum": 0, "maximum": 1, "type": "number", "description": "Maximum engagement rate (0.01 = 1%)" }, "verified": { "title": "Verified Only", "type": "boolean", "description": "Only return verified accounts", "default": false }, "maxResults": { "title": "Maximum Results", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of results to return (1-100)", "default": 25 } } }, "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 } } } } } } } } } } ```