{ "openapi": "3.0.1", "info": { "title": "Instagram Reels Search - Reels by Keyword and Hashtag", "description": "Search Instagram Reels by keyword or hashtag. \"home workout\" and #homeworkout return different reels, and both are searched here. Each row has the caption, plays, likes, comments, shares, video link, creator, audio and publish time. Up to 100 per run. $0.40 per 1,000 reels.", "version": "0.1", "x-build-id": "4TrOEohSot9sE81wy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~instagram-reels-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-instagram-reels-search-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/dami_studio~instagram-reels-search-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-instagram-reels-search-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/dami_studio~instagram-reels-search-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-instagram-reels-search-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": { "searchQueries": { "title": "Keyword searches", "maxItems": 20, "type": "array", "description": "Up to 20 keyword searches. Each keyword is searched directly against Instagram's Reels search surface and returns ranked Reels for that keyword.", "items": { "type": "string" } }, "hashtags": { "title": "Hashtags", "maxItems": 20, "type": "array", "description": "Optional direct hashtags, up to 20. Each is searched as #tag on the same Reels search surface.", "items": { "type": "string" } }, "maxReels": { "title": "Maximum Reels", "minimum": 1, "maximum": 100, "type": "integer", "description": "Hard run-wide maximum of genuine Reels written and charged.", "default": 30 }, "maxReelsPerTerm": { "title": "Maximum Reels per term", "minimum": 10, "maximum": 100, "type": "integer", "description": "Optional, 10 to 100. Stop each keyword or hashtag at this many Reels, so the later terms get searched too. The lowest value is 10. Maximum Reels still caps the whole run. Leave it empty to let the first terms fill the run." }, "requestTimeoutSeconds": { "title": "Request timeout seconds", "minimum": 5, "maximum": 30, "type": "integer", "description": "Timeout for each Instagram Reels search request.", "default": 15 }, "maxRunSeconds": { "title": "Maximum run seconds", "minimum": 20, "maximum": 180, "type": "integer", "description": "Hard wall-clock bound for Reels search and extraction.", "default": 120 }, "minLikes": { "title": "Minimum likes", "minimum": 1, "type": "integer", "description": "Keep only reels with at least this many likes. The search has no such filter, so each reel is checked after it arrives: one that passes is delivered and charged as usual, and each one it leaves out is billed as a reel checked and left out (see the Pricing tab). A strict filter can return fewer reels than you asked for and cost more than Maximum Reels suggests; your maximum cost per run still holds. Leave it empty for no minimum." }, "minComments": { "title": "Minimum comments", "minimum": 1, "type": "integer", "description": "Keep only reels with at least this many comments. Billed the same way as Minimum likes: each reel it leaves out is billed as a reel checked and left out. Leave it empty for no minimum." }, "newerThan": { "title": "Only reels newer than", "type": "string", "description": "Keep only reels posted on or after this day, counted in UTC, or within a window such as 7 days. The search is ranked, not sorted by date, so older reels come back too, and each one this leaves out is billed as a reel checked and left out. A reel with no publish time is left out. Leave it empty for no date limit." }, "sessionCookies": { "title": "Account cookies (not needed)", "minItems": 0, "maxItems": 20, "type": "array", "description": "Optional: your own session, used only for your run. You are responsible for using it within the site's terms. Runs work without it.", "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Leave this alone unless you need the run to go out through a particular network. Your own proxy servers are used exactly as given." }, "maxAttempts": { "title": "Maximum attempts per request", "minimum": 1, "maximum": 12, "type": "integer", "description": "How many times to retry a request that comes back empty before giving up on it.", "default": 8 } } }, "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 } } } } } } } } } }