{
  "openapi": "3.0.1",
  "info": {
    "title": "Instagram Profile Lead Scraper By Keyword",
    "description": "Find targeted Instagram leads using keywords with the Instagram Profile Lead Scraper By Keyword. Extract usernames, bios, follower counts, emails, websites, and profile links automatically. Ideal for influencer discovery, outreach campaigns, and niche audience research.",
    "version": "0.7",
    "x-build-id": "wDWESwcWHbZnoAPsS"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scraper-engine~instagram-profile-lead-scraper-by-keyword/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scraper-engine-instagram-profile-lead-scraper-by-keyword",
        "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/scraper-engine~instagram-profile-lead-scraper-by-keyword/runs": {
      "post": {
        "operationId": "runs-sync-scraper-engine-instagram-profile-lead-scraper-by-keyword",
        "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/scraper-engine~instagram-profile-lead-scraper-by-keyword/run-sync": {
      "post": {
        "operationId": "run-sync-scraper-engine-instagram-profile-lead-scraper-by-keyword",
        "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": [
          "keywords"
        ],
        "properties": {
          "keywords": {
            "title": "🔍 Keywords",
            "type": "array",
            "description": "🎯 The words that power your lead search! Add one or more keywords (e.g. ['marketing', 'founder', 'coach', 'agency']) and the actor expands each one into several Instagram-native search angles — 🔤 exact phrase, #️⃣ hashtag, 💌 bio contact-intent, 👥 audience — then 📧 extracts the email addresses it finds and 🏅 ranks every profile by how well it matches your keyword. 💡 Tip: more specific keywords = more targeted leads.",
            "items": {
              "type": "string"
            }
          },
          "platform": {
            "title": "🌐 Platform",
            "enum": [
              "Instagram"
            ],
            "type": "string",
            "description": "📱 The social network to mine for leads. Currently locked to Instagram — more platforms coming soon! 🚀",
            "default": "Instagram"
          },
          "location": {
            "title": "📍 Location Filter",
            "type": "string",
            "description": "🗺️ Optional geo-targeting! Add a city or region (e.g. 'London' 🇬🇧, 'New York' 🗽, 'Dubai' 🏙️) to narrow leads down to profiles mentioning that place. ✨ Leave empty to search the whole globe 🌍.",
            "default": ""
          },
          "emailDomains": {
            "title": "📧 Email Domains Filter",
            "type": "array",
            "description": "🎛️ Keep only leads whose email is on the domains you care about — type as many as you like! ✍️ Popular picks: 📮 @gmail.com · 📨 @outlook.com · 💌 @hotmail.com · 💜 @yahoo.com · ☁️ @icloud.com · 📬 @aol.com · 🔒 @protonmail.com · 📥 @live.com · 📧 @gmx.com · 🟡 @yandex.com · 📗 @zoho.com. 🏢 Custom/business domains work too — e.g. @yourcompany.com. 🕳️ Leave empty to collect leads from ALL major free-mail providers. 💡 Adding a domain also sharpens the search 🎯.",
            "items": {
              "type": "string"
            }
          },
          "maxEmails": {
            "title": "📊 Maximum Leads per Keyword",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "🎚️ How many leads (emails) to keep per keyword. 🏅 The actor gathers a larger candidate pool across all keyword variants, ranks it by keyword relevance, and saves the best ones up to this number. ⚡ Higher = more leads but longer runs. Default is 20 ✅ (range 1 – 5,000).",
            "default": 20
          },
          "engine": {
            "title": "⚙️ Engine",
            "enum": [
              "legacy"
            ],
            "type": "string",
            "description": "🔧 The processing engine. Currently 'legacy' 🛡️ — a reliable, battle-tested extraction pipeline. More engines on the roadmap! 🚧",
            "default": "legacy"
          },
          "includeHashtagSearch": {
            "title": "#️⃣ Hashtag Discovery",
            "type": "boolean",
            "description": "🔎 Also search the hashtag spelling of each keyword (e.g. 'fitness coach' → '#fitnesscoach'). Creators tag their own bios and captions, so this surfaces a completely different slice of profiles than the plain phrase does. ✅ Recommended: ON.",
            "default": true
          },
          "extraKeywordVariants": {
            "title": "➕ Extra Keyword Variants",
            "type": "array",
            "description": "✍️ Add your own extra search phrases on top of the automatic expansions (e.g. 'online coaching', 'personal trainer', '#ptlife'). Each one becomes an additional Instagram search pass. 🕳️ Leave empty to rely on the built-in expansion only.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "maxPagesPerVariant": {
            "title": "📄 Pages per Keyword Variant",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "📚 How many result pages (20 results each) to read per keyword variant before moving to the next one. ⬆️ Raise it for deeper digs, ⬇️ lower it for faster, cheaper runs. Default 2 ✅.",
            "default": 2
          },
          "profilePagesOnly": {
            "title": "👤 First-Party Emails Only",
            "type": "boolean",
            "description": "🎯 Keep only addresses read from the account's OWN fetched Instagram profile — its bio field, or an address it repeatedly publishes in its own captions. ⚠️ Turning this OFF additionally accepts an address seen in a search-result snippet when it matches the account's name. Snippets routinely show a DIFFERENT organisation's address, so those are always discarded either way. ✅ ON (default) = every email provably belongs to the account it is listed against.",
            "default": true
          },
          "minRelevanceScore": {
            "title": "🏅 Minimum Relevance Score",
            "minimum": 0,
            "maximum": 50,
            "type": "integer",
            "description": "🎯 Drop leads whose keyword-relevance score falls below this. Scores start at 1 and climb with keyword matches in the bio/title/handle, hashtag hits, profile-page results and audience size — typical good leads land around 8–14. 0️⃣ Leave at 0 to keep everything.",
            "default": 0
          },
          "proxyConfiguration": {
            "title": "🛡️ Proxy Configuration",
            "type": "object",
            "description": "🌐 Control how the actor connects to the search index. 🆓 Leave it as-is and the actor uses the GOOGLE_SERP proxy group — the only group that reliably reaches Google search. 🔄 On any failed or blocked response it rotates to a fresh proxy URL and retries up to 3×, degrading back to GOOGLE_SERP if a custom proxy keeps getting blocked. 🧠 Advanced users can plug in their own proxy groups or external URLs here instead."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}