{ "openapi": "3.0.1", "info": { "title": "Instagram Reels Search & Trend Discovery", "description": "Finding trending Reels by scrolling Instagram wastes hours. Search any keyword and get public reels with plays, likes, comments, hashtags, audio, location and creator stats, plus trend metrics like plays per day and virality. No login needed.", "version": "1.0", "x-build-id": "wayN4JZoIHyRRUtAh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawl_craft~instagram-reels-search-trend-discovery/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawl_craft-instagram-reels-search-trend-discovery", "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/crawl_craft~instagram-reels-search-trend-discovery/runs": { "post": { "operationId": "runs-sync-crawl_craft-instagram-reels-search-trend-discovery", "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/crawl_craft~instagram-reels-search-trend-discovery/run-sync": { "post": { "operationId": "run-sync-crawl_craft-instagram-reels-search-trend-discovery", "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": [ "urls" ], "properties": { "urls": { "title": "🔎 Keywords or search links", "minItems": 1, "type": "array", "description": "One or many keywords or Instagram search / hashtag links (for example travel, or https://www.instagram.com/popular/travel/). Bulk input is supported.", "items": { "type": "string" } }, "maxItems": { "title": "📊 Max reels", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Reels to save for EACH keyword or link (3 keywords with 50 give up to 150 reels).", "default": 10 }, "maxPages": { "title": "📄 Result pages", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Optional. If set, it replaces Max reels with about 12 reels per page for each keyword. Leave empty to use Max reels." }, "sortBy": { "title": "🏆 Rank reels by", "enum": [ "feed", "trending", "plays", "likes", "engagement", "recent" ], "type": "string", "description": "Instagram's own order saves reels as they are read. Any other order reads the whole keyword first, then saves the best reels.", "default": "feed" }, "postedWithin": { "title": "⏰ Posted within", "type": "string", "description": "Only reels newer than this: 7d, 30d, 3m, 24h or a date like 2026-01-31. Leave empty for any time." }, "includeCreatorStats": { "title": "👥 Creator stats", "type": "boolean", "description": "Add followers, following, posts, bio, links, emails, engagement rate and virality ratio for each creator.", "default": true }, "fetchDetails": { "title": "💬 Likes, comments & date", "type": "boolean", "description": "Read each reel's likes, comments, post date, location, audio and duration. Needed for the date filter and for most sort orders.", "default": true }, "keywordInsights": { "title": "📈 Keyword insights", "type": "boolean", "description": "Add each keyword's total posts and related keywords.", "default": true }, "expandRelated": { "title": "🔗 Explore related keywords", "type": "boolean", "description": "If a keyword does not reach Max reels, also search that keyword's related keywords to fill its quota.", "default": true }, "maxRelatedTerms": { "title": "🧭 Max related keywords", "minimum": 0, "maximum": 500, "type": "integer", "description": "Upper limit of related keywords explored for each keyword.", "default": 5 }, "concurrency": { "title": "⚡ Parallel requests", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many reel details and creator profiles are read at the same time. Several keywords are also searched at once.", "default": 10 }, "requestDelay": { "title": "🐢 Pause between pages", "minimum": 0, "maximum": 10, "type": "number", "description": "Pause between result pages of one keyword.", "default": 0 }, "maxScanned": { "title": "🧱 Max reels examined", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Stops a search whose filters never match, after this many reels were examined.", "default": 5000 }, "proxyConfiguration": { "title": "🌐 Proxy", "type": "object", "description": "Optional. Connection settings are handled automatically. Choose a proxy here only if you want to use your own.", "default": { "useApifyProxy": 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 } } } } } } } } } }