{ "openapi": "3.0.1", "info": { "title": "Instagram Mentions & Tagged Posts Scraper", "description": "Find public Instagram posts that mention a handle: tagged in the photo, named in the caption, or credited as co-author. One row per post: how it was mentioned, link, caption, poster, likes, comments, images and an approximate date. $0.44 per 1,000 posts.", "version": "0.1", "x-build-id": "TfX1COdjG6lomhym6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~instagram-mentions-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-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/dami_studio~instagram-mentions-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-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/dami_studio~instagram-mentions-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-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": { "usernames": { "title": "Instagram usernames", "minItems": 0, "maxItems": 200, "type": "array", "description": "The accounts you want mentions of. A plain handle, @handle or a full profile URL all work. Up to 200 per run.", "items": { "type": "string" } }, "maxItems": { "title": "Maximum rows", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Total posts to return across every handle. This is the number you pay for, so keep it low while testing.", "default": 100 }, "resultsPerUsername": { "title": "Rows per handle (optional)", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Cap the posts returned for each handle. Leave empty and the row limit above is shared evenly between your handles." }, "onlyTagged": { "title": "Only posts tagged in the photo", "type": "boolean", "description": "Keep only posts where the account is tagged in the image or credited as a co-author, and drop posts that merely name it in the caption. Filtered posts are never charged.", "default": false }, "onlyPostsNewerThan": { "title": "Only posts newer than", "type": "string", "description": "Keep only posts from this date on. Pick a day, or switch to a relative window such as 7 days, which suits a daily schedule. Older posts are left out and not charged. The time comes from the post id, so a post within a few minutes of the line can land either side. The tagged feed is not in date order, so each handle is still read to its usual depth. Leave it empty for no date limit." }, "includePostDetails": { "title": "Add post details", "type": "boolean", "description": "Opens each post once more for its exact publish time, place, the poster's name, verified tick and picture, paid-partnership flag and sponsors, tagged accounts by username, the video link and length, and the music. Same price per post, slower runs. If a post's details can't be read, you still get the post without them.", "default": false }, "includeComments": { "title": "Add comments (paid extra)", "type": "boolean", "description": "Adds the comments Instagram shows first on each post, in its own order. It is a paid extra, billed per comment, and it starts soon: until then, ticking it adds one free row saying so, and no comments are read or charged. Posts with few comments are skipped at no charge.", "default": false }, "commentsPerPost": { "title": "Comments per post", "minimum": 11, "maximum": 30, "type": "integer", "description": "The most comments added to each post, 11 to 30. Replies count. Only used when comments are ticked.", "default": 15 }, "concurrency": { "title": "Handles read at once", "minimum": 1, "maximum": 8, "type": "integer", "description": "How many handles to read in parallel. Raise it for a long list; lower it if you supply your own proxy servers and they are few.", "default": 4 }, "sessionCookies": { "title": "Account cookies (not needed)", "minItems": 0, "maxItems": 20, "type": "array", "description": "Optional: your own session, used only for your run. You are responsible for using it within the site's terms. Runs work without it." }, "proxyUrls": { "title": "Your own proxy servers (optional)", "minItems": 0, "maxItems": 50, "type": "array", "description": "Leave this empty for a normal run. Fill it in only if you want the traffic to leave through proxy servers you already pay for, one URL per line, in the form http://user:pass@host:port.", "items": { "type": "string" } } } }, "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 } } } } } } } } } }