{ "openapi": "3.0.1", "info": { "title": "Instagram Boolean Search Scraper | Posts & Reels", "description": "Search Instagram posts and Reels using Boolean queries with AND, OR, NOT, phrases, keywords, and hashtags. Filter by date and engagement, deduplicate matches, and export structured JSON, CSV, Excel, or API data. No cookies required.", "version": "0.0", "x-build-id": "He9KQ30m6WTzWSLqZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraping_solutions~instagram-boolean-search-scraper-posts-reels/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraping_solutions-instagram-boolean-search-scraper-posts-reels", "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/scraping_solutions~instagram-boolean-search-scraper-posts-reels/runs": { "post": { "operationId": "runs-sync-scraping_solutions-instagram-boolean-search-scraper-posts-reels", "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/scraping_solutions~instagram-boolean-search-scraper-posts-reels/run-sync": { "post": { "operationId": "run-sync-scraping_solutions-instagram-boolean-search-scraper-posts-reels", "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": [ "searchQuery", "resultsLimit" ], "properties": { "searchQuery": { "title": "Keywords, hashtags, or Boolean query", "type": "string", "description": "Examples: #fitness; digital marketing; (#fitness OR \"home workout\") AND nutrition AND NOT giveaway. More AND, NOT, phrase, date, or engagement restrictions can require additional paid search pages while producing fewer matches. Check the expression before running with the free [FlujoDato Boolean Search Validator](https://flujodato.com/en/boolean-search-validator?platform=instagram).", "default": "(#fitness OR \"home workout\") AND (protein OR nutrition) AND NOT giveaway" }, "resultsLimit": { "title": "Maximum matching results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of unique Instagram posts or Reels saved after all filters. This is not a guaranteed result count. Successful search pages are charged separately, including pages whose candidates are all rejected.", "default": 100 }, "contentType": { "title": "Content type", "enum": [ "posts_and_reels", "reels_only" ], "type": "string", "description": "Search all public posts and Reels, or limit discovery to Reels.", "default": "posts_and_reels" }, "hashtagFeedType": { "title": "Hashtag feed order", "enum": [ "top", "recent" ], "type": "string", "description": "Order used when a Boolean branch is discovered through a hashtag. Reels-only searches automatically use the Reels feed.", "default": "top" }, "searchCoverage": { "title": "Search coverage", "enum": [ "efficient", "comprehensive" ], "type": "string", "description": "Efficient uses the strongest discovery term from each Boolean branch and is recommended for first runs. Comprehensive searches every positive term for higher recall. The Actor first gives every source fair coverage, then reallocates the remaining global page allowance to searches that are producing matches. Restrictive expressions may still return few or zero matches.", "default": "efficient" }, "oldestPostDate": { "title": "Only content posted after", "type": "string", "description": "Optional inclusive start date in YYYY-MM-DD format. This filter is applied after Instagram discovery; the provider cannot jump directly to an old date, so narrow historical ranges may return fewer matches.", "default": "" }, "newestPostDate": { "title": "Only content posted before", "type": "string", "description": "Optional inclusive end date in YYYY-MM-DD format. Using the same historical date in both fields requests one calendar day, but Instagram discovery still starts from the feed exposed by the provider.", "default": "" }, "minimumLikes": { "title": "Minimum likes", "minimum": 0, "type": "integer", "description": "Save only content with at least this many likes. Use 0 to disable the filter.", "default": 0 }, "minimumComments": { "title": "Minimum comments", "minimum": 0, "type": "integer", "description": "Save only content with at least this many comments. Use 0 to disable the filter.", "default": 0 }, "minimumViews": { "title": "Minimum views", "minimum": 0, "type": "integer", "description": "Save only Reels or videos with at least this many reported plays. Non-video posts are excluded when this value is above 0.", "default": 0 }, "strictBooleanSyntax": { "title": "Require explicit Boolean operators", "type": "boolean", "description": "Reject implicit expressions such as 'bank NOT jobs'. Leave disabled to normalize them to 'bank AND NOT jobs' with a warning.", "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 } } }, "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 } } } } } } } } } }