{ "openapi": "3.0.1", "info": { "title": "Instagram Hashtag Posts Scraper", "description": "Scrape public Instagram posts and Reels for one or more hashtags. Exports captions, engagement counts, author metadata, media URLs, comments when available, cursor metadata, and run summaries. No Instagram cookies required.", "version": "1.3", "x-build-id": "0GFzBaGUPQMguT8wE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~instagram-hashtag-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-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/khadinakbar~instagram-hashtag-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-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/khadinakbar~instagram-hashtag-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-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": "Instagram hashtags to scrape, with or without #. Use focused tags such as fitness, streetphotography, skincare, or your brand campaign hashtag. Public data only; no Instagram cookies are required.", "items": { "type": "string" } }, "startUrls": { "title": "Instagram hashtag URLs", "type": "array", "description": "Optional Instagram hashtag page URLs such as https://www.instagram.com/explore/tags/fitness/. The actor extracts the hashtag automatically. You can combine this with the hashtags field.", "items": { "type": "object", "properties": { "url": { "type": "string", "title": "URL", "description": "Instagram hashtag URL." } } } }, "datePosted": { "title": "Date posted", "enum": [ "any", "last-hour", "last-day", "last-week", "last-month", "last-year" ], "type": "string", "description": "Optional freshness filter for Google-indexed Instagram results. Recent windows can be sparse; last-week or last-month usually gives a better balance of freshness and coverage.", "default": "last-week" }, "mediaType": { "title": "Media type", "enum": [ "all", "reels" ], "type": "string", "description": "Return all public post types, or only Reels when you need short-form video results.", "default": "all" }, "maxPostsPerHashtag": { "title": "Maximum posts per hashtag", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum records to save for each hashtag. This is also the hard cap for billable post-found events per hashtag.", "default": 50 }, "maxProviderPages": { "title": "Maximum provider pages", "minimum": 1, "maximum": 60, "type": "integer", "description": "Advanced pagination safety valve. Leave at 60 for normal runs. Lower it for tests or when intentionally limiting upstream provider calls.", "default": 60 }, "startCursor": { "title": "Start cursor", "maxLength": 200, "type": "string", "description": "Optional cursor from a previous run summary. Use it to continue from a later provider page for each hashtag." }, "minimumLikes": { "title": "Minimum likes", "minimum": 0, "type": "integer", "description": "Only save posts with at least this many likes. Use 0 to keep all returned posts.", "default": 0 }, "includeComments": { "title": "Include sample comments", "type": "boolean", "description": "Include public comments returned by the provider in each dataset record. Disable for smaller records when post-level metadata is enough.", "default": false }, "outputMode": { "title": "Output mode", "enum": [ "full", "compact" ], "type": "string", "description": "Compact mode keeps the common fields for quick tables and LLM workflows. Full mode includes media URLs, cursor provenance, author images, and comments when enabled.", "default": "full" } } }, "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 } } } } } } } } } }