{ "openapi": "3.0.1", "info": { "title": "Instagram Tagged & Mention Posts: AI Sentiment & Captions", "description": "Scrapes posts where an Instagram profile is tagged or mentioned, capturing captions, media, usernames, timestamps, engagement metrics, hashtags, and post URLs. Ideal for brand monitoring, influencer tracking, sentiment analysis, and automated UGC discovery at scale", "version": "0.1", "x-build-id": "qN7D68jAVOuKNdbLB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapio~instagram-tagged-mentions-posts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapio-instagram-tagged-mentions-posts-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-tagged-mentions-posts-scraper/runs": { "post": { "operationId": "runs-sync-scrapio-instagram-tagged-mentions-posts-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-tagged-mentions-posts-scraper/run-sync": { "post": { "operationId": "run-sync-scrapio-instagram-tagged-mentions-posts-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": "👤 Target Profiles", "type": "array", "description": "Usernames or profile URLs to find tagged/mentioned posts for. One per line. Example: mrbeast. Base key `urlsOrKeywords` is also accepted.", "items": { "type": "string" } }, "maxPostsPerProfile": { "title": "🔢 Max Posts per Profile (each pass)", "minimum": 10, "maximum": 1000, "type": "integer", "description": "Limit on posts collected PER target, applied separately to the own-feed pass and the real tagged-feed pass (so up to 2x this value per target). Range 10-1000. Base key `maxPosts` is also accepted. Default 10.", "default": 10 }, "maxCommentsPerPost": { "title": "💬 Max Comments per Post", "minimum": 0, "maximum": 50, "type": "integer", "description": "How many of each post's latest comments to collect (also fed to the optional AI sentiment pass). The base actor hardcoded this to 1 with no way to raise it -- this is now a real, working input. Range 0-50. Default 3.", "default": 3 }, "extractHashtagsAndMentions": { "title": "🔎 Extract Hashtags, Mentions & Sponsor Usernames (keyless)", "type": "boolean", "description": "ON by default, no API key needed. Adds `hashtags[]` and `allMentions[]` parsed from the caption via regex (the base only checked ONE literal username and silently dropped hashtags entirely), plus `sponsorUsernames[]` -- a clean, flattened list normalized from the base's raw/inconsistent `sponsor_user` field.", "default": true }, "aiSentimentEnabled": { "title": "🤖 Enable AI Sentiment & Topic Tagging", "type": "boolean", "description": "OFF by default. When ON and a key is supplied (input or environment variable), each post's caption AND each collected comment get model-graded sentiment, emotion and up to 3 topic keywords (`aiCaptionSentiment`/`aiCaptionEmotion`/`aiCaptionTopics` on the post, `aiSentiment`/`aiEmotion`/`aiTopics` on each comment). On failure or missing key, AI fields are `null` -- the rest of the row (including Feature 1) is unaffected.", "default": false }, "aiModel": { "title": "🧬 AI Model / Provider", "enum": [ "claude-haiku-4-5", "claude-sonnet-5", "claude-opus-4-8", "gpt-4o-mini", "gpt-4o", "gpt-4.1-mini", "o3-mini", "gemini-2.0-flash-lite", "gemini-2.0-flash", "gemini-2.5-flash", "grok-3-mini", "deepseek-chat", "sonar", "mistral-small-latest" ], "type": "string", "description": "Provider auto-detected from the name: claude-*=Anthropic, gpt-*/o1/o3=OpenAI, gemini-*=Google, grok-*=xAI, deepseek-*=DeepSeek, sonar*=Perplexity, mistral-*=Mistral. Cheaper mini/flash/haiku models are recommended for classification.", "default": "claude-haiku-4-5" }, "aiApiKey": { "title": "🔑 AI API Key", "type": "string", "description": "Provider API key for AI sentiment enrichment. Kept secret. Falls back to the provider env var if empty (ANTHROPIC_API_KEY / OPENAI_API_KEY / GEMINI_API_KEY / XAI_API_KEY / DEEPSEEK_API_KEY / PERPLEXITY_API_KEY / MISTRAL_API_KEY)." }, "proxyConfiguration": { "title": "🌐 Proxy Configuration", "type": "object", "description": "Controls the actual proxy used for every request (the base actor ignored this input and always forced RESIDENTIAL regardless of what was configured -- fixed here). Residential is recommended for Instagram." } } }, "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 } } } } } } } } } }