{ "openapi": "3.0.1", "info": { "title": "Instagram Engagement Rate Calculator & Audit", "description": "Check creators before you pay them. Paste Instagram and Threads profiles and get one row per account: exact followers, median likes, comments and views, engagement rate, posting frequency and standout posts. No login needed. Schedule runs, use the API, export to CSV or Excel.", "version": "0.1", "x-build-id": "QRIkqEbG1fQuwrbNT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sz022~instagram-threads-influencer-audit/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sz022-instagram-threads-influencer-audit", "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/sz022~instagram-threads-influencer-audit/runs": { "post": { "operationId": "runs-sync-sz022-instagram-threads-influencer-audit", "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/sz022~instagram-threads-influencer-audit/run-sync": { "post": { "operationId": "run-sync-sz022-instagram-threads-influencer-audit", "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": [ "accounts" ], "properties": { "accounts": { "title": "Accounts", "minItems": 1, "maxItems": 1000, "type": "array", "description": "Instagram and Threads profile URLs or handles, mixed freely: https://www.instagram.com/nasa/, https://www.threads.com/@nasa, or a handle with a prefix (ig:nasa, threads:nasa). A handle without a prefix uses the platform set below. Facebook pages are accepted but come back as unsupported_platform and are not charged. Up to 1,000 per run.", "items": { "type": "string" } }, "defaultPlatform": { "title": "Platform for bare handles", "enum": [ "instagram", "threads" ], "type": "string", "description": "Which platform a handle without a URL or prefix belongs to.", "default": "instagram" }, "postsPerAccount": { "title": "Recent posts per account", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many of the most recent posts to analyse. Pinned posts are skipped and do not count toward this. Instagram reads each post on its own, so 24 posts take about 30 seconds per account; Threads takes a few seconds.", "default": 24 }, "includeCollabPosts": { "title": "Include collab posts owned by the partner (Instagram)", "type": "boolean", "description": "A collab post appears on both accounts' grids but belongs to one of them, and its likes come from both audiences. Off by default, so the numbers describe the account's own posts.", "default": false }, "maxPostAgeDays": { "title": "Only posts from the last N days", "minimum": 1, "type": "integer", "description": "Optional. Leave empty to take the most recent posts however old they are." }, "igGraphAccessToken": { "title": "Instagram Graph API access token (optional)", "type": "string", "description": "Official mode for Instagram business and creator accounts. A Facebook user access token with instagram_basic, instagram_manage_insights and pages_read_engagement. See the README for setup. Personal accounts, and any failure, fall back to logged out." }, "igGraphUserId": { "title": "Your Instagram professional account ID", "type": "string", "description": "The numeric Instagram user ID of the business or creator account the token belongs to (not the account you are auditing)." }, "instagramSessionCookie": { "title": "Instagram session cookie (optional, at your own risk)", "type": "string", "description": "The sessionid cookie of an Instagram account you control. Meta may restrict or ban an account used this way; use a secondary account. Read the README first. Logged out reads up to 50 posts without it." }, "threadsSessionCookie": { "title": "Threads session cookie (optional, at your own risk)", "type": "string", "description": "The sessionid cookie from threads.com for an account you control. Same risks as the Instagram cookie." }, "abortAfterConsecutiveFailures": { "title": "Stop after this many failures in a row", "minimum": 0, "type": "integer", "description": "Ends the run early when a platform stops responding. Accounts that do not exist or are private do not count toward this. Set to 0 to never stop early.", "default": 5 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify's datacenter proxy, which has read Instagram and Threads profiles in every test on the platform. Residential and Google SERP proxy groups are not used: the price per account is set for datacenter traffic, so a run that asks for them falls back to the datacenter proxy and notes it on each row. Proxy URLs of your own are used as given.", "default": { "useApifyProxy": 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 }, "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 } } } } } } } } } }