{
  "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.1",
    "x-build-id": "mXULTqeyoW3CLMxnQ"
  },
  "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. TikTok and YouTube work out of the box with no extra keys and are the most reliable. TikTok creators come from the videos on your niche's hashtag pages, with real follower counts and real engagement. Instagram, LinkedIn, and Twitter/X only return profiles when you also provide a Google Custom Search API key and Search Engine ID (see the Outreach/Advanced section); without those keys they return nothing, so start with TikTok or YouTube if you have not set up Google Custom Search.",
            "items": {
              "type": "string",
              "enum": [
                "tiktok",
                "youtube",
                "instagram",
                "linkedin",
                "twitter"
              ]
            },
            "default": [
              "tiktok",
              "youtube"
            ]
          },
          "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": "Filter results by location (e.g., 'Los Angeles', 'United Kingdom', 'New York'). Matches against influencer profile locations. For Instagram/TikTok, location filtering works best when combined with Google Custom Search (provide Google API key). LinkedIn search natively supports location filtering.",
            "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": "When ON: returns sample data with real profile URLs (no scraping, no charges). Turn OFF for real influencer discovery. IMPORTANT: If your results show generic usernames like 'fitness_creator_1', demo mode is still on.",
            "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}