{ "openapi": "3.0.1", "info": { "title": "Instagram Hashtag Scraper - Filtered Post Search", "description": "Search Instagram hashtags and keywords without login, with filters that run inside the crawl: date range, minimum likes, comments and plays, media type and hashtag exclusions. Full post records with engagement, owner, location and coordinates. Monitor mode.", "version": "0.1", "x-build-id": "E5hirFCWwdE6Na15Q" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~instagram-hashtag-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-instagram-hashtag-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/scrapesage~instagram-hashtag-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-instagram-hashtag-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/scrapesage~instagram-hashtag-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-instagram-hashtag-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": { "hashtags": { "title": "Hashtags", "type": "array", "description": "Hashtags to search, with or without the # (e.g. travel, streetphotography). Instagram's logged-out discovery returns its top posts per tag.", "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Free-text keyword searches (e.g. \"sourdough starter\"). Uses Instagram's keyword discovery rather than an exact tag.", "items": { "type": "string" } }, "mediaType": { "title": "Media type", "enum": [ "all", "image", "video", "reel", "carousel" ], "type": "string", "description": "Restrict results to one media type. Requires post details for reliable classification.", "default": "all" }, "postedAfter": { "title": "Posted after", "type": "string", "description": "Only posts on or after this date (YYYY-MM-DD). Needs post details, which carry the timestamp, so it switches them on automatically." }, "postedBefore": { "title": "Posted before", "type": "string", "description": "Only posts on or before this date (YYYY-MM-DD)." }, "minLikes": { "title": "Minimum likes", "minimum": 0, "type": "integer", "description": "Skip posts below this like count. Needs post details.", "default": 0 }, "minComments": { "title": "Minimum comments", "minimum": 0, "type": "integer", "description": "Skip posts below this comment count. Needs post details.", "default": 0 }, "minPlays": { "title": "Minimum plays (video)", "minimum": 0, "type": "integer", "description": "Skip videos/Reels below this play count. Applied to the discovery payload BEFORE any paid detail fetch, so filtered posts cost you nothing.", "default": 0 }, "excludeHashtags": { "title": "Exclude hashtags", "type": "array", "description": "Drop any post whose caption carries one of these hashtags (e.g. ad, sponsored, giveaway).", "items": { "type": "string" } }, "includePostDetails": { "title": "Include post details (likes, comments, date, owner)", "type": "boolean", "description": "Fetches each post's own page to add like count, comment count, exact post date, dimensions, location, tagged users, collaborators and the full owner record. Billed as the postDetail event. Turn off for a cheap discovery-only pull.", "default": true }, "maxResults": { "title": "Maximum posts", "minimum": 0, "type": "integer", "description": "Total posts to return across all queries. 0 means no limit (the run's time budget stops it safely).", "default": 100 }, "onlyNewPosts": { "title": "Monitor mode - only new posts", "type": "boolean", "description": "Remembers posts already returned for this query set and emits only unseen ones. Ideal on a schedule for brand monitoring.", "default": false }, "detailConcurrency": { "title": "Detail concurrency", "minimum": 1, "maximum": 8, "type": "integer", "description": "Parallel detail fetches. Keep at 4 or below - hashtag pages are Instagram's most rate-limited surface.", "default": 4 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "RESIDENTIAL is the tested default and strongly recommended for hashtag pages.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }