{ "openapi": "3.0.1", "info": { "title": "Instagram Likes Scraper", "description": "Export visible public Instagram post liker rows for audience research, influencer vetting, and campaign-overlap analysis.", "version": "0.1", "x-build-id": "y0DHuQvQFtYh1qLKx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetch_cat~instagram-likes-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetch_cat-instagram-likes-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/fetch_cat~instagram-likes-scraper/runs": { "post": { "operationId": "runs-sync-fetch_cat-instagram-likes-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/fetch_cat~instagram-likes-scraper/run-sync": { "post": { "operationId": "run-sync-fetch_cat-instagram-likes-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": [ "postUrls" ], "properties": { "postUrls": { "title": "Instagram post or Reel URLs", "minItems": 1, "type": "array", "description": "Public Instagram /p/, /reel/, /reels/ or /tv/ links, optionally username-prefixed, and /share/TOKEN, /share/p/TOKEN or /share/reel/TOKEN links. Carousel, embed and comment suffixes identify the same whole post. Share links are resolved anonymously; unresolved shares are reported separately and fail the run after usable posts are processed. App deep links are unsupported. Only instagram.com, www.instagram.com, m.instagram.com and instagr.am are accepted; runtime validates URL safety and post identity before extraction.", "items": { "type": "string", "pattern": "^\\s*(?:[hH][tT][tT][pP]://(?:[iI][nN][sS][tT][aA][gG][rR][aA][mM]\\.[cC][oO][mM]|(?:[wW][wW][wW]|[mM])\\.[iI][nN][sS][tT][aA][gG][rR][aA][mM]\\.[cC][oO][mM]|[iI][nN][sS][tT][aA][gG][rR]\\.[aA][mM])(?::80)?|[hH][tT][tT][pP][sS]://(?:[iI][nN][sS][tT][aA][gG][rR][aA][mM]\\.[cC][oO][mM]|(?:[wW][wW][wW]|[mM])\\.[iI][nN][sS][tT][aA][gG][rR][aA][mM]\\.[cC][oO][mM]|[iI][nN][sS][tT][aA][gG][rR]\\.[aA][mM])(?::443)?)/(?:(?:share/(?:p/|reel/)?[A-Za-z0-9_-]+/?)|(?:(?!(?:share|audio|accounts|login|challenge|checkpoint|stories|story|explore|direct|reels?|p|tv|profile|about|developers?|legal|privacy|terms|web|api|oauth)/)[A-Za-z0-9_.]+/)?(?!(?:reels/audio)(?:/|$))(?:[pP]|[rR][eE][eE][lL][sS]?|[tT][vV])/[A-Za-z0-9_-]+(?:/[^\\s?#\\\\]*)?)(?:[?#][^\\s\\\\]*)?\\s*$" } }, "maxLikesPerPost": { "title": "Maximum visible likers per post", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum target-bound visible liker rows to export for each source post.", "default": 100 }, "sessionCookie": { "title": "Optional Instagram session cookie", "type": "string", "description": "Public posts may show their liker list only after login. Without a session, a confirmed login/signup gate produces a warning and no liker rows, not a claim of zero actual likes. Your OWN optional authorized session may help, but can expire or remain restricted; access is not guaranteed. No operator session is supplied. Never paste/share session secrets in logs or tasks. Kept secret and excluded from telemetry/output. The existing start fee may apply to a started no-output run." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Direct access is the default (useApifyProxy: false). Explicit valid settings apply only to the optional customer-session browser when sessionCookie is supplied; anonymous requests and the anonymous browser stay direct. Choose Apify Proxy or your own proxy URLs here only when needed. Existing managed groups/country and custom proxy settings remain supported. Proxy transfer may add cost and does not guarantee access. Malformed or unsupported settings are rejected, never converted into an automatic proxy fallback.", "default": { "useApifyProxy": false } }, "includeProfileDetails": { "title": "Profile detail enrichment (not available)", "type": "boolean", "description": "Currently has no effect on saved rows. Leave false: setting true only displays a warning and does not fetch additional profile details.", "default": false }, "failOnPrivateOrBlocked": { "title": "Fail when a post is private or blocked", "type": "boolean", "description": "Confirmed login/signup gates ALWAYS warn and continue, even when true; SUMMARY records login_required and no liker records collected. True retains strict failure for other unavailable outcomes. Unknown blocking, challenges, parser/route errors, crashes, timeouts and storage/billing failures remain actionable failures regardless of this flag. Inaccessibility does not prove privacy, deletion or zero actual likes.", "default": false } } }, "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 } } } } } } } } } }