{ "openapi": "3.0.1", "info": { "title": "Instagram Related Hashtag Stats Scraper By Keyword Search", "description": "Instagram Related Hashtag Stats Scraper extracts related hashtags and their metrics, including post counts, popularity, top posts, and growth trends. Ideal for content planning, hashtag research, SEO, and automating structured Instagram hashtag insights for better reach and strategy.", "version": "0.1", "x-build-id": "estg7Kf83FeCX1Zpj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/simpleapi~instagram-related-hashtag-stats-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-simpleapi-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/simpleapi~instagram-related-hashtag-stats-scraper/runs": { "post": { "operationId": "runs-sync-simpleapi-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/simpleapi~instagram-related-hashtag-stats-scraper/run-sync": { "post": { "operationId": "run-sync-simpleapi-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": { "discoveryKeywords": { "title": "🌱 Seed Keywords (Hashtag Discovery)", "type": "array", "description": "Broader niche keywords/phrases (e.g. 'sustainable fashion', 'home workout') to resolve into real candidate Instagram hashtags via IG's search/topsearch endpoint. Each candidate then gets the full stats pipeline. Example: 'sustainable fashion' -> #sustainablefashion, #ecofashion, #slowfashion ... each with real postsCount.", "items": { "type": "string" } }, "maxCandidatesPerKeyword": { "title": "🔢 Max candidate hashtags per keyword", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many discovered hashtag candidates (from IG's own search results, ranked by media_count) to run the full stats pipeline on, per seed keyword. Default 5.", "default": 5 }, "minPostsCount": { "title": "📉 Minimum postsCount (goldilocks floor)", "minimum": 0, "type": "integer", "description": "Skip hashtags with fewer than this many total posts (too small/dead niche). 0 = no minimum. Applies to both discovered and literal hashtags. Default 0.", "default": 0 }, "maxPostsCount": { "title": "📈 Maximum postsCount (goldilocks ceiling)", "minimum": 0, "type": "integer", "description": "Skip hashtags with more than this many total posts (too saturated/oversaturated niche). 0 = no maximum. Applies to both discovered and literal hashtags. Default 0.", "default": 0 }, "literalHashtags": { "title": "🏷️ Literal Hashtags / Tag URLs (optional)", "type": "array", "description": "Direct hashtags, '#tags', or instagram.com/explore/tags/... URLs to analyze exactly as typed (same literal mode as the base actor's 'urls_keywords' input, which is still accepted for backward compatibility). Use this when you already know the exact tag; use 'Seed Keywords' above when you want IG to discover tags for you.", "items": { "type": "string" } }, "urls_keywords": { "title": "🏷️ (legacy) urls_keywords", "type": "array", "description": "Deprecated alias of 'literalHashtags' kept for backward compatibility with the base actor's input shape. Prefer 'literalHashtags' or 'discoveryKeywords' above.", "items": { "type": "string" } }, "ig_sessionid": { "title": "🔑 Instagram sessionid cookie", "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/search 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." }, "delay_between_requests": { "title": "⏱️ Delay between requests (seconds)", "minimum": 0, "type": "integer", "description": "Pause between each hashtag/keyword processed, to reduce Instagram rate-limiting. Default 2 seconds.", "default": 2 }, "proxy_configuration": { "title": "🌐 Proxy Configuration", "type": "object", "description": "Choose proxy settings for better access reliability and smoother runs." } } }, "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 } } } } } } } } } }