🌟Instagram Lead Finder
Pricing
from $0.00005 / actor start
You can access the 🌟Instagram Lead Finder programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "0.0", "x-build-id": "0ukwKVZsdLA2DFjwB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/databuddy~instagram-lead-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-databuddy-instagram-lead-finder", "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/databuddy~instagram-lead-finder/runs": { "post": { "operationId": "runs-sync-databuddy-instagram-lead-finder", "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/databuddy~instagram-lead-finder/run-sync": { "post": { "operationId": "run-sync-databuddy-instagram-lead-finder", "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": [ "usernames" ], "properties": { "usernames": { "title": "Instagram usernames or profile URLs", "type": "array", "description": "One per line. Accepts plain handles (natgeo), handles with @ (@natgeo) or profile URLs (https://www.instagram.com/natgeo/). Duplicates are removed automatically.", "items": { "type": "string" } }, "maxResults": { "title": "Max profiles to save", "minimum": 0, "type": "integer", "description": "Stop after this many profiles are saved (and charged). 0 = no limit.", "default": 0 }, "includeFailedProfiles": { "title": "Show failed profiles in the results", "type": "boolean", "description": "Adds a row (status = blocked / not_found / invalid_input) for every profile that could not be scraped, with the reason and how to fix it. These rows are never charged.", "default": true }, "scrapeRelatedProfiles": { "title": "Also scrape related profiles (discovery)", "type": "boolean", "description": "Instagram shows 'similar accounts' on many profiles. When on, those accounts are added to the queue and scraped too (one level deep). Great for finding more influencers in the same niche.", "default": false }, "maxRelatedPerProfile": { "title": "Max related profiles per input profile", "minimum": 1, "maximum": 80, "type": "integer", "description": "How many related accounts to follow from each input profile when discovery is on.", "default": 10 }, "scanBioLinks": { "title": "Scan link-in-bio pages for emails & phones", "type": "boolean", "description": "Opens the external URL and bio links (Linktree, Beacons, Stan, websites…) and collects public emails and phone numbers found there. Slower, but finds far more contacts. Each contact found this way shows its source page in the evidence column.", "default": false }, "includeRecentPosts": { "title": "Include recent posts", "type": "boolean", "description": "Add the latest posts (likes, comments, video views, caption, URL) to each profile. Engagement rate is calculated from these posts either way.", "default": true }, "recentPostsLimit": { "title": "Posts used for engagement", "minimum": 1, "maximum": 12, "type": "integer", "description": "How many of the latest posts to analyse (Instagram returns up to 12 without login).", "default": 12 }, "excludePinnedPosts": { "title": "Exclude pinned posts from engagement", "type": "boolean", "description": "Pinned posts are often old viral posts and inflate engagement. When on, they are left out of the engagement rate.", "default": true }, "minFollowers": { "title": "Min followers", "minimum": 0, "type": "integer", "description": "Skip profiles with fewer followers. 0 = no minimum.", "default": 0 }, "maxFollowers": { "title": "Max followers", "minimum": 0, "type": "integer", "description": "Skip profiles with more followers. 0 = no maximum.", "default": 0 }, "influencerTiers": { "title": "Influencer tiers to keep", "type": "array", "description": "Keep only these tiers. Leave empty to keep all. Tiers: under 1K = sub-nano, 1K–10K = nano, 10K–100K = micro, 100K–1M = macro, 1M+ = mega.", "items": { "type": "string", "enum": [ "sub-nano", "nano", "micro", "macro", "mega" ], "enumTitles": [ "Sub-nano (<1K)", "Nano (1K–10K)", "Micro (10K–100K)", "Macro (100K–1M)", "Mega (1M+)" ] }, "default": [] }, "onlyWithContact": { "title": "Only profiles with an email or phone", "type": "boolean", "description": "Skip profiles where no public email or phone number was found.", "default": false }, "onlyBusinessAccounts": { "title": "Only business / creator accounts", "type": "boolean", "description": "Skip personal accounts. Keeps profiles Instagram marks as business or professional.", "default": false }, "minLeadGrade": { "title": "Minimum lead grade", "enum": [ "A", "B", "C", "D" ], "type": "string", "description": "Skip profiles below this grade. A = Hot (75–100), B = Warm (50–74), C = Cool (25–49), D = Cold (0–24).", "default": "D" }, "minEngagementRate": { "title": "Min engagement rate (%)", "minimum": 0, "type": "number", "description": "Skip profiles with a lower engagement rate, e.g. 1.5 for 1.5%. 0 = no minimum.", "default": 0 }, "includeUnclearEngagement": { "title": "Keep profiles with unknown engagement", "type": "boolean", "description": "When a min engagement rate is set, profiles where engagement cannot be measured (private, no posts, hidden likes) are kept if this is on and skipped if off. Their engagement fields stay empty — never guessed.", "default": true }, "includePrivateAccounts": { "title": "Include private accounts", "type": "boolean", "description": "Private accounts still show bio, follower counts and business contact, but no posts. Turn off to skip them.", "default": true }, "bioKeywords": { "title": "Bio keywords", "type": "array", "description": "Keep only profiles whose name, bio or category matches at least one of these keywords (e.g. 'real estate', 'fitness coach', 'ecommerce'). Leave empty to keep all. Hyphens, accents, capitals and simple plurals are treated as equal (e-commerce = ecommerce = E-Commerce).", "default": [], "items": { "type": "string" } }, "keywordMatchMode": { "title": "Keyword match mode", "enum": [ "exact", "all", "any", "off" ], "type": "string", "description": "Exact phrase: the words must appear together in order. All words: every word must appear anywhere. Any word: one word is enough. Off: ignore bio keywords.", "default": "exact" }, "skipPreviouslyScraped": { "title": "Skip profiles saved in previous runs", "type": "boolean", "description": "Remembers every saved username in a named key-value store and skips them in later runs. Useful for scheduled runs so you only pay for new leads.", "default": false }, "dedupeStoreName": { "title": "Memory store name", "pattern": "^[a-z0-9-]{1,63}$", "type": "string", "description": "Name of the key-value store that remembers saved usernames. Use different names to keep separate lists. Lowercase letters, numbers and hyphens only.", "default": "instagram-lead-finder-seen" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Instagram blocks datacenter IPs. Apify Residential proxy is strongly recommended.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for 🌟Instagram Lead Finder from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: