{ "openapi": "3.0.1", "info": { "title": "Best Buy Price Drop & Stock Tracker", "description": "Search Best Buy by keyword or product URL to get current and regular price, savings, rating, review count, brand, model and stock status for each item in one structured record.", "version": "1.1", "x-build-id": "Ed9cXcqgUuFh1rmod" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dataspryva~best-buy-price-drop-and-stock-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dataspryva-best-buy-price-drop-and-stock-tracker", "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/dataspryva~best-buy-price-drop-and-stock-tracker/runs": { "post": { "operationId": "runs-sync-dataspryva-best-buy-price-drop-and-stock-tracker", "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/dataspryva~best-buy-price-drop-and-stock-tracker/run-sync": { "post": { "operationId": "run-sync-dataspryva-best-buy-price-drop-and-stock-tracker", "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": "Search keywords", "type": "array", "description": "One or more Best Buy searches, for example `sony headphones` or `oled tv`. Each query is paginated until `maxResults` is reached.", "items": { "type": "string" } }, "categoryUrls": { "title": "Category or search URLs", "type": "array", "description": "Best Buy category, browse or search-result links, e.g. `https://www.bestbuy.com/site/headphones/.../pcmcat....c?id=...`. Pagination, sorting and condition filters are applied automatically.", "default": [], "items": { "type": "string" } }, "productUrls": { "title": "Product URLs", "type": "array", "description": "Exact Best Buy product links in either the new `/product/.../sku/...` or legacy `/site/.../.p?skuId=...` format.", "default": [], "items": { "type": "string" } }, "skuIds": { "title": "SKUs", "type": "array", "description": "Best Buy SKU numbers (6–9 digits). Product links are also accepted here.", "default": [], "items": { "type": "string" } }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on the total number of product records emitted across every mode.", "default": 24 }, "maxPages": { "title": "Max pages per query or category", "minimum": 1, "maximum": 100, "type": "integer", "description": "Pagination guard for each keyword or category link. Each page carries up to about 24 products.", "default": 50 }, "sortBy": { "title": "Sort results", "enum": [ "Best-Match", "Best-Selling", "Best-Discount", "Price-Low-To-High", "Price-High-To-Low", "Customer-Rating", "New-Arrivals" ], "type": "string", "description": "Best Buy's own sort order. Price, rating and discount orders are also enforced on the collected records.", "default": "Best-Match" }, "condition": { "title": "Condition", "enum": [ "all", "new", "open-box", "refurbished" ], "type": "string", "description": "Keep only new, open-box or refurbished products. `All conditions` disables this filter.", "default": "all" }, "minPrice": { "title": "Minimum price ($)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Drop products below this current price. `0` means no minimum.", "default": 0 }, "maxPrice": { "title": "Maximum price ($)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Drop products above this current price. `0` means no maximum.", "default": 0 }, "inStockOnly": { "title": "In stock only", "type": "boolean", "description": "Drop products that Best Buy marks sold out, out of stock or unavailable.", "default": false }, "includeDetails": { "title": "Include product-page details", "type": "boolean", "description": "Open each product page for description, model number, GTIN/UPC and seller. Slower; unavailable fields are omitted honestly.", "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 } } } } } } } } } }