{ "openapi": "3.0.1", "info": { "title": "BestBuy Listings Scraper", "description": "The BestBuy Listings Scraper extracts product data from BestBuy search and category pages, capturing names, prices, discounts, images, SKUs, reviews, ratings, and product links—ideal for price tracking, market analysis, and competitor research.", "version": "0.0", "x-build-id": "D5lu0zG8FzjWa8l3t" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/piotrv1001~bestbuy-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-piotrv1001-bestbuy-listings-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/piotrv1001~bestbuy-listings-scraper/runs": { "post": { "operationId": "runs-sync-piotrv1001-bestbuy-listings-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/piotrv1001~bestbuy-listings-scraper/run-sync": { "post": { "operationId": "run-sync-piotrv1001-bestbuy-listings-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": "Search keywords", "type": "array", "description": "Keywords to search on Best Buy, one per line, such as \"laptops\" or \"airpods\".", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Best Buy URLs, one per line: search pages, category pages or product pages. Works with bestbuy.com, the US store.", "items": { "type": "string" } }, "skus": { "title": "SKUs", "type": "array", "description": "Best Buy SKU numbers to look up directly, one per line, such as 6690085. Filters and sorting do not apply to these.", "items": { "type": "string" } }, "maxItems": { "title": "Max items (total)", "minimum": 1, "type": "integer", "description": "Maximum number of products to scrape across all start URLs. Pagination continues automatically until this limit (or the end of results) is reached.", "default": 50 }, "maxItemsPerUrl": { "title": "Max items per URL or keyword", "minimum": 1, "type": "integer", "description": "Maximum number of products to scrape per start URL or keyword. Leave empty for no limit." }, "sort": { "title": "Sort by", "enum": [ "Best-Match", "Best-Selling", "Best-Discount", "Price-Low-To-High", "Price-High-To-Low", "Customer-Rating", "New-Arrivals" ], "type": "string", "description": "Order of the results. Leave empty to keep Best Buy's order, or the order in your URL. Best Buy places some sponsored products ahead of the sorted ones." }, "minPrice": { "title": "Minimum price ($)", "minimum": 0, "type": "integer", "description": "Only products at this price or above." }, "maxPrice": { "title": "Maximum price ($)", "minimum": 0, "type": "integer", "description": "Only products at this price or below." }, "brands": { "title": "Brands", "type": "array", "description": "Only these brands, spelled as in Best Buy's Brand filter, such as HP or Samsung.", "items": { "type": "string" } }, "minRating": { "title": "Minimum customer rating", "minimum": 2, "maximum": 5, "type": "integer", "description": "Only products rated at least this many stars, from 2 to 5." }, "onSaleOnly": { "title": "On sale only", "type": "boolean", "description": "Only products that are currently on sale.", "default": false }, "includeSpecifications": { "title": "Include specifications", "type": "boolean", "description": "Add each product's full specification list (screen size, memory, dimensions and so on) to the row. Same price per product.", "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 } } } } } } } } } }