{ "openapi": "3.0.1", "info": { "title": "Instagram Competitor Content Gap Analyzer", "description": "Analyze Instagram posts or Reels from datasets or public URLs to find competitor content gaps, creative momentum, engagement changes and repeat-run opportunities for content planning.", "version": "0.0", "x-build-id": "zGirVAEfoaCkX9o40" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/quanmatrix~instagram-content-competitive-gap-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-quanmatrix-instagram-content-competitive-gap-intelligence", "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/quanmatrix~instagram-content-competitive-gap-intelligence/runs": { "post": { "operationId": "runs-sync-quanmatrix-instagram-content-competitive-gap-intelligence", "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/quanmatrix~instagram-content-competitive-gap-intelligence/run-sync": { "post": { "operationId": "run-sync-quanmatrix-instagram-content-competitive-gap-intelligence", "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": { "currentItems": { "title": "Current source records", "type": "array", "description": "Optional current source rows. If supplied, these are analyzed directly and no source fetch is required.", "items": { "type": "object" } }, "currentDatasetId": { "title": "Current Apify Dataset ID", "type": "string", "description": "Optional current Dataset from an upstream extraction workflow." }, "previousItems": { "title": "Previous snapshot records", "type": "array", "description": "Optional previous rows for deterministic change intelligence.", "items": { "type": "object" } }, "previousDatasetId": { "title": "Previous Apify Dataset ID", "type": "string", "description": "Optional prior Dataset for recurring comparisons." }, "queries": { "title": "Queries", "type": "array", "description": "Direct-source queries for Google Maps or Google Search modes.", "items": { "type": "string" }, "default": [] }, "urls": { "title": "URLs", "type": "array", "description": "Direct public URLs for web or social best-effort modes.", "items": { "type": "string" }, "default": [] }, "directFetch": { "title": "Use direct-source mode when no Dataset/rows are supplied", "type": "boolean", "description": "Enable direct-source retrieval only when inline rows and Dataset input are not supplied.", "default": true }, "language": { "title": "Language", "type": "string", "description": "Language code used by supported direct-source retrieval modes.", "default": "en" }, "countryCode": { "title": "Country code", "type": "string", "description": "Two-letter country code used to localize supported search-source modes.", "default": "us" }, "maxResults": { "title": "Maximum direct results per query", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of direct-source results requested per query or URL batch.", "default": 20 }, "maxItems": { "title": "Maximum records to analyze", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Maximum number of records analyzed and written to the output Dataset.", "default": 20000 }, "valuePerImpactUnitUsd": { "title": "Value per impact unit (USD)", "minimum": 0, "type": "number", "description": "Optional user-supplied USD value per detected impact unit. Used only for transparent economic impact estimates." }, "monthlyRuns": { "title": "Monthly runs for impact estimate", "minimum": 1, "type": "integer", "description": "Optional number of comparable monthly runs used with value per impact unit for the economic estimate.", "default": 1 }, "previousAnalysis": { "title": "Previous Gen2 analysis", "type": "object", "description": "Optional previous Gen2 output used to compare decision metrics and detect regression between analyses.", "default": {} }, "mcpConnectors": { "title": "MCP output connectors", "type": "array", "description": "Optional MCP connectors authorized in your Apify account. Use them to send or write this Actor result to tools such as Slack, Notion, GitHub, Sentry, Supabase, or another compatible MCP service." }, "mcpToolName": { "title": "MCP tool name", "type": "string", "description": "Optional exact MCP tool name. Leave blank to let the selected MCP action preset discover a compatible tool automatically.", "default": "" }, "mcpToolArguments": { "title": "MCP tool arguments", "type": "object", "description": "JSON object passed to the selected MCP tool. String values may use {{actor_title}}, {{result_summary}}, or {{result_json}} placeholders.", "default": {} }, "mcpFailOnError": { "title": "Fail run if MCP delivery fails", "type": "boolean", "description": "When enabled, an MCP delivery error fails the Actor run. Disabled by default so data extraction and intelligence results remain available even if the external destination is unavailable.", "default": false }, "mcpActionPreset": { "title": "MCP action preset", "enum": [ "AUTO_SAFE_WRITE", "SLACK_MESSAGE", "GITHUB_ISSUE", "NOTION_PAGE", "DATABASE_WRITE", "CUSTOM" ], "type": "string", "description": "Choose a safe action pattern. AUTO_SAFE_WRITE discovers a compatible non-destructive write tool automatically; use a specific preset for Slack, GitHub, Notion, or database delivery.", "default": "AUTO_SAFE_WRITE" } } }, "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 } } } } } } } } } }