{ "openapi": "3.0.1", "info": { "title": "Instagram Location Scraper With Business Contact Leads", "description": "Instagram Location Scraper: Find Instagram profiles and posts by location, then extract available business names, usernames, bios, websites, emails, phone numbers, and profile URLs. Build targeted local business lead lists for prospecting, market research, and competitor analysis.", "version": "0.1", "x-build-id": "fh9Fgt7XiEWasHMXQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapier~instagram-location-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapier-instagram-location-scraper", "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/scrapier~instagram-location-scraper/runs": { "post": { "operationId": "runs-sync-scrapier-instagram-location-scraper", "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/scrapier~instagram-location-scraper/run-sync": { "post": { "operationId": "run-sync-scrapier-instagram-location-scraper", "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": [ "startUrls" ], "properties": { "startUrls": { "title": "📍 Locations, usernames, or keywords", "type": "array", "description": "Instagram location page URLs, @usernames, or place keywords. Type is auto-detected. Example: 'https://www.instagram.com/explore/locations/213131048/berlin-germany/', 'mrbeast', or 'berlin'.", "items": { "type": "string" } }, "maxItems": { "title": "📦 Max posts (leads) to collect", "minimum": 0, "type": "integer", "description": "Upper bound on posts scraped across all inputs (0 = unlimited). Each post yields one lead row.", "default": 20 }, "sessionId": { "title": "🔑 Instagram session cookie", "type": "string", "description": "Your Instagram 'sessionid' cookie value. Required in practice: logged-out, Instagram walls both the location feed and the owner-info lead endpoint. Stored encrypted." }, "enrichOwner": { "title": "👤 Enrich owner profile", "type": "boolean", "description": "Fetch each unique post owner's profile (followerCount, followingCount, mediaCount, biography, externalUrl, category, isBusiness, isProfessionalAccount). One request per unique owner.", "default": true }, "includeBusinessContact": { "title": "📇 Include business contact details", "type": "boolean", "description": "Extract opt-in contact-button data (publicEmail, contactPhoneNumber, businessContactMethod, addressStreet, cityName, zip). Available only for business/creator accounts that published it (~30-50% of pros); null otherwise.", "default": true }, "requireBusinessContact": { "title": "✅ Only keep contactable leads", "type": "boolean", "description": "Drop any post whose owner has no public email, phone, or contact method (hasBusinessContact = false). Off by default.", "default": false }, "proxyConfiguration": { "title": "🌐 Proxy", "type": "object", "description": "Proxy settings. If Instagram rejects the current proxy, the actor falls back to residential automatically." }, "dateFilterType": { "title": "⏳ Date filter mode", "enum": [ "absolute", "relative" ], "type": "string", "description": "Filter posts by an absolute date range or a relative recent window.", "default": "relative" }, "absoluteStartDate": { "title": "📅 From date", "pattern": "^(|\\d{4}-\\d{2}-\\d{2})$", "type": "string", "description": "Start date (YYYY-MM-DD). Used when date filter mode is 'absolute'.", "default": "" }, "absoluteEndDate": { "title": "📅 To date", "pattern": "^(|\\d{4}-\\d{2}-\\d{2})$", "type": "string", "description": "End date (YYYY-MM-DD). Used when date filter mode is 'absolute'. Empty = today.", "default": "" }, "relativeValue": { "title": "🔢 Recent window amount", "minimum": 0, "type": "integer", "description": "Number of time units for the relative window (e.g. 7). Used when date filter mode is 'relative'. 0 disables date filtering.", "default": 0 }, "relativeUnit": { "title": "🕒 Recent window unit", "enum": [ "days", "weeks", "months", "years" ], "type": "string", "description": "Time unit for the relative window.", "default": "days" }, "includeEngagement": { "title": "❤️ Include engagement counts", "type": "boolean", "description": "Include likeCount and commentCount on each post. Turn off to null them out.", "default": true }, "includeVideoMetadata": { "title": "🎥 Include video metadata", "type": "boolean", "description": "Include the video object (url, dimensions, duration) on video posts. Turn off to null it out.", "default": true } } }, "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 } } } } } } } } } }