{ "openapi": "3.0.1", "info": { "title": "Instagram Mentions Scraper: with Engagement data", "description": "Scrapes Instagram mentions for any profile or keyword, capturing posts, captions, usernames, timestamps, engagement metrics, media URLs, and mention contexts. Ideal for brand monitoring, influencer tracking, sentiment analysis, and automated mention discovery at scale", "version": "0.1", "x-build-id": "q8Cvr6Dd3PVKLhjHQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapio~instagram-mentions-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapio-instagram-mentions-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/scrapio~instagram-mentions-scraper/runs": { "post": { "operationId": "runs-sync-scrapio-instagram-mentions-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/scrapio~instagram-mentions-scraper/run-sync": { "post": { "operationId": "run-sync-scrapio-instagram-mentions-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", "properties": { "targetProfiles": { "title": "🏷️ Tagged profiles to monitor", "type": "array", "description": "One Instagram handle per line (no @ needed). The actor returns posts by OTHER accounts that TAG this profile — its inbound user-generated content. Full profile URLs also work.", "items": { "type": "string" } }, "maxPosts": { "title": "🔢 Max tagged posts per profile", "minimum": 0, "maximum": 10000, "type": "integer", "description": "How many inbound tagged posts to collect for each target (0 or 10000+ = all available, within platform limits)." }, "sessionId": { "title": "🔑 Instagram Session ID", "type": "string", "description": "Paste your Instagram `sessionid` cookie value. Log in to instagram.com in your browser, open DevTools → Application → Cookies, and copy the `sessionid` value. Kept in the run input only." }, "minEngagement": { "title": "🔥 Minimum engagement (likes + comments)", "minimum": 0, "type": "integer", "description": "Keep only tagged posts whose likes + comments total is at least this value. Leave at 0 to keep everything.", "default": 0 }, "includeMediaType": { "title": "🎞️ Include media types", "type": "array", "description": "Keep only the selected media types. Leave empty to include all.", "items": { "type": "string", "enum": [ "photo", "video", "carousel", "reel" ], "enumTitles": [ "📷 Photo", "🎬 Video", "🖼️ Carousel", "📱 Reel" ] }, "default": [] }, "fetchMediaAssets": { "title": "🎬 Fetch full media assets", "type": "boolean", "description": "For video, reel and carousel posts, fetch the full media object to populate videoUrl, videoDuration and viewCount (one extra request per such post). Turn off for a faster, feed-only run.", "default": true }, "proxyConfiguration": { "title": "🛡️ Proxy configuration", "type": "object", "description": "Apify residential proxy is used automatically for reliability." } } }, "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 } } } } } } } } } }