{ "openapi": "3.0.1", "info": { "title": "Instagram Purchase‑Intent Lead Finder", "description": "Discover real buyers on Instagram by searching posts with keywords (e.g., Saree, Kids wear) and locations (e.g., Chennai, Pune), then auto‑identify commenters with purchase‑intent phrases like price, DM, link. Export clean lead rows with profile insights. Works at scale on Apify.", "version": "0.0", "x-build-id": "fWzBrn0LTHh2piOcr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ittechinnovators~instagram-purchase-intent-lead-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ittechinnovators-instagram-purchase-intent-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/ittechinnovators~instagram-purchase-intent-lead-finder/runs": { "post": { "operationId": "runs-sync-ittechinnovators-instagram-purchase-intent-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/ittechinnovators~instagram-purchase-intent-lead-finder/run-sync": { "post": { "operationId": "run-sync-ittechinnovators-instagram-purchase-intent-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": [ "keywords", "intentKeywords" ], "properties": { "keywords": { "title": "Searching keywords (used to find posts)", "type": "array", "description": "Enter product or topic keywords used to discover Instagram posts through Google search. Do NOT include purchase-intent words here. Example: Saree, Kids wear, Kids fashion.", "default": [ "Saree", "Kids wear", "Kids fashion" ], "items": { "type": "string" } }, "intentKeywords": { "title": "Purchase-intent keywords (used to filter commenters)", "type": "array", "description": "Buying-intent phrases that will be searched inside Instagram comments to identify users interested in purchasing. Example: price, dm, price please, price pls, link.", "default": [ "price", "dm", "price please", "price pls", "link" ], "items": { "type": "string" } }, "hashtags": { "title": "Hashtags (optional)", "type": "array", "description": "Optional hashtags used as additional discovery keywords when searching for Instagram posts. You can enter values with or without # (example: saree or #saree).", "default": [], "items": { "type": "string" } }, "locations": { "title": "Locations (optional)", "type": "array", "description": "Optional city or region names used to focus discovery queries. Each location will be combined with the searching keywords to find more relevant Instagram posts.", "default": [ "Chennai", "Madurai", "Pune" ], "items": { "type": "string" } }, "maxGoogleResults": { "title": "Max Google result URLs", "minimum": 10, "maximum": 1000, "type": "integer", "description": "Maximum number of Instagram post URLs that will be collected from Google search results across all discovery queries.", "default": 60 }, "maxCommentsPerPost": { "title": "Max comments per post", "minimum": 50, "maximum": 5000, "type": "integer", "description": "Maximum number of comments to extract from each Instagram post during scraping.", "default": 400 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Choose Apify Proxy settings for running the Actor. Using residential proxies is recommended to reduce blocking while scraping Instagram." }, "instagramSessionId": { "title": "Instagram sessionid (optional)", "type": "string", "description": "Optional Instagram sessionid cookie used to run the scraper in logged-in mode. Leave empty to run in public (logged-out) mode." }, "dedupeUsers": { "title": "Return one row per unique user", "type": "boolean", "description": "If enabled, each Instagram user will appear only once in the output dataset. The most recent matching comment will be retained.", "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 } } } } } } } } } }