{ "openapi": "3.0.1", "info": { "title": "Instagram Related Hashtag Stats Scraper & Multi-Tag Comparison", "description": "Instagram Related Hashtag Stats Scraper finds connected hashtags and delivers key metrics like post volume, reach, popularity, and growth trends. Ideal for research, niche discovery, SEO planning, and optimizing Instagram content with data-driven hashtag insights.", "version": "0.1", "x-build-id": "90EwzDmOQAYWOb0ld" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~instagram-related-hashtag-stats-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-instagram-related-hashtag-stats-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/api-empire~instagram-related-hashtag-stats-scraper/runs": { "post": { "operationId": "runs-sync-api-empire-instagram-related-hashtag-stats-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/api-empire~instagram-related-hashtag-stats-scraper/run-sync": { "post": { "operationId": "run-sync-api-empire-instagram-related-hashtag-stats-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": { "hashtagsToCompare": { "title": "🏷️ Hashtags to Compare", "type": "array", "description": "Add 2 or more hashtags, tag URLs, or bare keywords to compare (example: fitness, #yoga, instagram.com/explore/tags/gym). With 2+ entries the run also emits a ranked comparison row and a shared-related-tags overlap row. The legacy `urls_keywords` key is still accepted as a fallback.", "items": { "type": "string" } }, "minSharedTagOccurrence": { "title": "🔗 Minimum Shared-Tag Occurrence", "minimum": 2, "maximum": 10, "type": "integer", "description": "A related/frequent/average/rare hashtag must show up for at least this many of your input hashtags to be listed in the shared-related-tags overlap summary. Example: minSharedTagOccurrence=2 → any tag shared by 2+ of your hashtags is included. Default is 2.", "default": 2 }, "igSessionCookie": { "title": "🔑 Instagram Session Cookie (sessionid)", "type": "string", "description": "REQUIRED: paste the value of the `sessionid` cookie from a logged-in instagram.com browser tab (DevTools > Application > Cookies > https://www.instagram.com > sessionid). Instagram only returns hashtag data to logged-in traffic — there is no built-in fallback credential. Without a valid cookie, the run produces diagnostic rows explaining why no data was collected instead of real hashtag stats. The legacy `ig_sessionid` key is still accepted as a fallback." }, "requestDelaySeconds": { "title": "⏱️ Delay Between Hashtag Requests (seconds)", "minimum": 0, "maximum": 60, "type": "integer", "description": "Pause between fetching each hashtag, to avoid Instagram rate limits. Example: requestDelaySeconds=2 waits 2 seconds between hashtags. Default is 2. The legacy `delay_between_requests` key is still accepted as a fallback." }, "proxySettings": { "title": "🌐 Proxy & Reliability Settings", "type": "object", "description": "Choose proxy settings for better access reliability and smoother runs. The legacy `proxy_configuration` key is still accepted as a fallback." } } }, "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 } } } } } } } } } }