{ "openapi": "3.0.1", "info": { "title": "Influencer Discovery - Find Influencers Across Social Platforms", "description": "Discover influencers across Instagram, TikTok, LinkedIn, YouTube, and Twitter by niche, hashtags, engagement rate, and follower count. Perfect for influencer marketing campaigns and brand partnerships.\nMulti-Platform Discovery \nNiche Targeting\nEngagement Analysis\nTier Filtering\nContact Extraction", "version": "1.0", "x-build-id": "21yBQz5oceXcfSLvI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alizarin_refrigerator-owner~influencer-discovery---find-influencers-across-social-platforms/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alizarin_refrigerator-owner-influencer-discovery---find-influencers-across-social-platforms", "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/alizarin_refrigerator-owner~influencer-discovery---find-influencers-across-social-platforms/runs": { "post": { "operationId": "runs-sync-alizarin_refrigerator-owner-influencer-discovery---find-influencers-across-social-platforms", "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/alizarin_refrigerator-owner~influencer-discovery---find-influencers-across-social-platforms/run-sync": { "post": { "operationId": "run-sync-alizarin_refrigerator-owner-influencer-discovery---find-influencers-across-social-platforms", "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": [ "platforms", "niches" ], "properties": { "platforms": { "title": "Platforms", "type": "array", "description": "Social media platforms to search for influencers", "items": { "type": "string", "enum": [ "instagram", "tiktok", "linkedin", "youtube", "twitter" ] }, "default": [ "instagram" ] }, "niches": { "title": "Niches/Industries", "type": "array", "description": "Target niches or industries to search. Use simple words like: fitness, tech, ai, ai automation, beauty, food, travel, fashion, gaming, business, finance, saas, marketing, real estate, wellness, crypto, coaching, health, education, photography, diy, home, art, music, pets, sports, parenting, lifestyle. You can also type any custom niche — the actor will generate relevant hashtags automatically.", "items": { "type": "string" } }, "hashtags": { "title": "Hashtags", "type": "array", "description": "Hashtags to search for (without #). Leave empty to auto-generate from niches.", "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Keywords to search in bios and content", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Target locations (cities, countries, or regions)", "items": { "type": "string" } }, "followerRange": { "title": "Follower Range", "type": "object", "description": "Target follower count range", "properties": { "min": { "title": "Minimum Followers", "description": "Minimum number of followers an influencer should have", "type": "integer", "default": 1000 }, "max": { "title": "Maximum Followers", "description": "Maximum number of followers an influencer should have", "type": "integer", "default": 1000000 } } }, "influencerTiers": { "title": "Influencer Tiers", "type": "array", "description": "Target influencer size tiers: nano (1K-10K), micro (10K-100K), mid (100K-500K), macro (500K-1M), mega (1M+)", "items": { "type": "string", "enum": [ "nano", "micro", "mid", "macro", "mega" ] }, "default": [ "micro", "mid" ] }, "minEngagementRate": { "title": "Minimum Engagement Rate (%)", "minimum": 0.1, "maximum": 50, "type": "number", "description": "Minimum engagement rate to qualify as a good influencer", "default": 2 }, "contentTypes": { "title": "Content Types", "type": "array", "description": "Preferred content types the influencer creates", "items": { "type": "string", "enum": [ "photos", "videos", "reels", "stories", "live", "articles", "podcasts" ] }, "default": [ "photos", "videos", "reels" ] }, "verifiedOnly": { "title": "Verified Accounts Only", "type": "boolean", "description": "Only discover verified/blue-check accounts", "default": false }, "businessAccountsOnly": { "title": "Business/Creator Accounts Only", "type": "boolean", "description": "Only discover business or creator accounts (where detectable)", "default": false }, "maxResults": { "title": "Maximum Results", "minimum": 10, "maximum": 500, "type": "integer", "description": "Maximum number of influencers to discover per platform", "default": 50 }, "includeContactInfo": { "title": "Extract Contact Info", "type": "boolean", "description": "Attempt to extract email addresses and contact info from bios", "default": true }, "excludeUsernames": { "title": "Exclude Usernames", "type": "array", "description": "Usernames to exclude from results (e.g., competitors, already contacted)", "items": { "type": "string" } }, "languagePreference": { "title": "Language Preference", "enum": [ "en", "es", "fr", "de", "pt", "it", "ja", "ko", "zh", "ar", "hi", "any" ], "type": "string", "description": "Preferred content language: en (English), es (Spanish), fr (French), de (German), pt (Portuguese), it (Italian), ja (Japanese), ko (Korean), zh (Chinese), ar (Arabic), hi (Hindi), any (Any Language)", "default": "en" }, "sortBy": { "title": "Sort Results By", "enum": [ "discoveryScore", "followers", "engagementRate", "recentActivity" ], "type": "string", "description": "How to sort discovered influencers: discoveryScore (recommended), followers, engagementRate, recentActivity", "default": "discoveryScore" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings for scraping" }, "demoMode": { "title": "Demo Mode", "type": "boolean", "description": "Test with fake sample data (no real scraping, no charge). Set to false for real results.", "default": false }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Optional webhook URL to receive results when discovery completes" }, "enableOutreach": { "title": "Enable Outreach Pipeline", "type": "boolean", "description": "Enable automated email outreach to discovered influencers with emails", "default": false }, "googleApiKey": { "title": "Google Custom Search API Key", "type": "string", "description": "Google Custom Search API key for discovering profiles with emails (optional, supplements platform discovery)" }, "googleSearchEngineId": { "title": "Google Search Engine ID", "type": "string", "description": "Google Programmable Search Engine ID" }, "emailProvider": { "title": "Email Provider", "enum": [ "sendgrid", "resend" ], "type": "string", "description": "Email service for sending outreach", "default": "sendgrid" }, "sendgridApiKey": { "title": "SendGrid API Key", "type": "string", "description": "SendGrid API key for sending emails" }, "resendApiKey": { "title": "Resend API Key", "type": "string", "description": "Resend API key for sending emails" }, "fromEmail": { "title": "From Email", "type": "string", "description": "Sender email address" }, "fromName": { "title": "From Name", "type": "string", "description": "Sender display name" }, "emailSubject": { "title": "Email Subject", "type": "string", "description": "Email subject line. Use {name} and {brand} for personalization." }, "emailTemplate": { "title": "Email Template", "type": "string", "description": "Email body template. Use {name}, {platform}, {niche}, {followers} for personalization." }, "aiProvider": { "title": "AI Provider for Personalization", "enum": [ "anthropic", "openai", "gemini", "none" ], "type": "string", "description": "AI provider for email personalization (makes each email unique based on the influencer's bio and content)", "default": "none" }, "aiApiKey": { "title": "AI API Key", "type": "string", "description": "API key for your chosen AI provider" }, "aiModel": { "title": "AI Model", "type": "string", "description": "Specific AI model to use (optional, uses best default per provider)" }, "brandContext": { "title": "Brand Context", "type": "object", "description": "Your brand information for AI personalization" }, "sendEmails": { "title": "Actually Send Emails", "type": "boolean", "description": "Set to true to actually send emails. False = dry run (preview only).", "default": false }, "maxEmailsPerRun": { "title": "Max Emails Per Run", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum emails to send in this run", "default": 100 }, "delayBetweenEmails": { "title": "Delay Between Emails (ms)", "minimum": 500, "type": "integer", "description": "Delay between sending each email in milliseconds", "default": 2000 } } }, "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 } } } } } } } } } }