{ "openapi": "3.0.1", "info": { "title": "Instagram MCP Server — Profiles, Posts, Reels, Comments", "description": "One MCP-ready Instagram Actor for public profiles, posts, Reels, and comments. Cookieless ScrapeCreators + SociaVault providers, no login. Returns structured JSON with provenance. $0.004 per result.", "version": "0.1", "x-build-id": "SLvI8BJdeYkn4owDe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~instagram-mcp-server/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-instagram-mcp-server", "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/khadinakbar~instagram-mcp-server/runs": { "post": { "operationId": "runs-sync-khadinakbar-instagram-mcp-server", "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/khadinakbar~instagram-mcp-server/run-sync": { "post": { "operationId": "run-sync-khadinakbar-instagram-mcp-server", "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": { "tool": { "title": "Instagram tool", "enum": [ "profile", "posts", "reels", "comments" ], "type": "string", "description": "Which Instagram data tool to run for this call. Accepts profile, posts, reels, or comments. Defaults to profile. Do not use this Actor for hashtags, follower graphs, likes, or private accounts — hashtag search is not returned by the current public-data providers, and follower graphs are login-gated.", "default": "profile" }, "usernames": { "title": "Instagram usernames or profile URLs", "type": "array", "description": "Public Instagram handles for profile, posts, or reels tools. Accepts natgeo, @nasa, or https://www.instagram.com/nike/. Prefill is one public profile so the quality test stays under five minutes. Not a post or Reel URL.", "items": { "type": "string" } }, "postUrls": { "title": "Instagram post or Reel URLs", "type": "array", "description": "Public post or Reel URLs for the comments tool. Accepts https://www.instagram.com/p/SHORTCODE/ , /reel/SHORTCODE/ , or a bare shortcode. Leave empty for profile/posts/reels. Not a profile URL.", "items": { "type": "string" } }, "maxResults": { "title": "Max output rows", "minimum": 1, "maximum": 200, "type": "integer", "description": "Hard cap on billed dataset rows for the whole run. Accepts 1-200; defaults to 12 so a Console or MCP probe stays cheap. Stops the run at the cap with PARTIAL when more public items exist. Not a per-target cap — use maxResultsPerTarget for that.", "default": 12 }, "maxResultsPerTarget": { "title": "Max results per target", "minimum": 1, "maximum": 50, "type": "integer", "description": "Per-username or per-post cap before the global maxResults stop. Accepts 1-50; defaults to 12. Profile tool always writes one row per handle. Not the run-wide spend guard.", "default": 12 }, "providerOrder": { "title": "Data provider order", "enum": [ "scrapecreators-first", "sociavault-first", "scrapecreators-only", "sociavault-only" ], "type": "string", "description": "Order of owner-configured public-data providers. Defaults to scrapecreators-first with automatic SociaVault fallback. Use a -only value to pin one provider. You never paste an API key; keys are owner secrets.", "default": "scrapecreators-first" }, "includeRawData": { "title": "Include raw provider payload", "type": "boolean", "description": "When true, each row also stores the unmodified provider item under raw. Defaults to false because raw payloads roughly triple token size for agents. Not required for normal MCP use.", "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 } } }, "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 } } } } } } } } } }