{ "openapi": "3.0.1", "info": { "title": "Instagram Hashtag Scraper · Recent, Top & Reels · Date Filter", "description": "Instagram hashtag scraper with a Recent (newest-first) feed, plus Top and Reels. Filter by posted-after and posted-before dates, or videos only. Captions, likes, comments, plays, video URLs, creator handle, tagged accounts, optional reel audio. No login, deduped. From $0.70 per 1,000 posts.", "version": "1.1", "x-build-id": "gGIodwz2r4NkWbBn6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~instagram-hashtag-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-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/memo23~instagram-hashtag-scraper/runs": { "post": { "operationId": "runs-sync-memo23-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/memo23~instagram-hashtag-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-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", "required": [ "hashtags" ], "properties": { "hashtags": { "title": "Hashtags", "type": "array", "description": "Instagram hashtags to scrape. Accepts bare names (coffee), #-prefixed tags (#coffee), or explore URLs (https://www.instagram.com/explore/tags/coffee/) — one per line, mixed formats are fine. Any tag that is misspelled, has no public posts, or cannot be read comes back as an error row naming that tag, so a short result is never a mystery.", "items": { "type": "string" } }, "resultsType": { "title": "What to scrape", "enum": [ "top", "reels", "recent", "both" ], "type": "string", "description": "Top posts (ranked), Reels (clips), Recent (newest-first mixed feed), or both Top and Reels. A post that appears in two lists is returned — and charged — only once. Recent uses Instagram's newest feed, not the dead v1 recent endpoint. Instagram serves almost nothing on the Recent tab of some busy tags; when that happens, Top posts are returned instead, with the same filters, and those rows have resultsType \"top\".", "default": "top" }, "maxPostsPerHashtag": { "title": "Max posts per hashtag", "minimum": 1, "type": "integer", "description": "Cap how many posts to collect per hashtag. Leave empty for as many as Instagram will serve. Note Instagram's top/reels lists are live ranked sets of limited depth — very large numbers will stop early once the list stops returning new posts." }, "postedAfter": { "title": "Posted after", "type": "string", "description": "Keep only posts published on or after this date. Accepts YYYY-MM-DD or a full ISO timestamp. Note this filters what Instagram serves, it cannot reach further back: Top and Reels are ranked by recency, so a busy hashtag may only reach back a day and a quiet one under a week. Raising Max posts per hashtag reaches a little further. Excluded posts are never charged." }, "postedBefore": { "title": "Posted before", "type": "string", "description": "Keep only posts published on or before this date. A bare YYYY-MM-DD includes the whole of that day. Excluded posts are never charged." }, "onlyVideos": { "title": "Only videos", "type": "boolean", "description": "Skip photo posts and return only videos and reels. Applies to both result types. Default: off.", "default": false }, "includeAudio": { "title": "Include reel audio", "type": "boolean", "description": "Add the sound behind each reel: track or original-audio title, artist, audio id, duration, and whether Instagram marks the sound as trending. Fetched ten reels per request, so it adds little time. Photos and carousels carry no audio and stay empty. Paid Apify plans only.", "default": false } } }, "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 } } } } } } } } } }