{ "openapi": "3.0.1", "info": { "title": "Best Buy Product Scraper", "description": "Fast Best Buy product scraper. Pull product details (title, prices, savings, SKU, BSIN, model number, brand, ratings, reviews, specifications, images, category path) by SKU, direct URL, search keyword, or category. Reads Best Buy's GraphQL gateway directly, no headless browser.", "version": "0.1", "x-build-id": "hQu0LoKeXCSRLNCda" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cirkit~bestbuy-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cirkit-bestbuy-product-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/cirkit~bestbuy-product-scraper/runs": { "post": { "operationId": "runs-sync-cirkit-bestbuy-product-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/cirkit~bestbuy-product-scraper/run-sync": { "post": { "operationId": "run-sync-cirkit-bestbuy-product-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": { "skuIds": { "title": "Best Buy SKUs", "uniqueItems": true, "type": "array", "description": "List of Best Buy 7-digit SKU IDs (e.g. '6447382'). Bypasses search and fetches each SKU directly via the public GraphQL gateway. Fastest path.", "default": [], "items": { "type": "string" } }, "productUrls": { "title": "Direct Product URLs", "uniqueItems": true, "type": "array", "description": "List of Best Buy product URLs. Both legacy (https://www.bestbuy.com/site//.p?skuId=) and new (https://www.bestbuy.com/product//) formats supported.", "default": [], "items": { "type": "string" } }, "searchQueries": { "title": "Search Keywords", "uniqueItems": true, "type": "array", "description": "Keyword search queries (e.g. 'airpods', 'oled tv', 'lego'). The scraper enumerates SKUs from Best Buy's search results, then fetches each product's details.", "default": [], "items": { "type": "string" } }, "categoryIds": { "title": "Best Buy Category IDs", "uniqueItems": true, "type": "array", "description": "Best Buy category IDs (e.g. 'pcmcat144700050004' for headphones, 'abcat0204000' for headphones parent). Found on PLP URLs after '?id='.", "default": [], "items": { "type": "string" } }, "maxResults": { "title": "Max Products Per Search", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Cap on total products per (searchQuery) or per (categoryId). Discovery walks paginated results until this cap or end-of-results.", "default": 50 }, "includeSpecifications": { "title": "Include Full Specifications", "type": "boolean", "description": "When true (default), each product record includes the full spec table (specifications, highlights, features, dimensions, image gallery). Set false for a slim record (price/rating/availability only).", "default": true }, "maxImagesPerProduct": { "title": "Max Image URLs Per Product", "minimum": 0, "maximum": 50, "type": "integer", "description": "Cap on image URLs returned per product.", "default": 10 }, "requestConcurrency": { "title": "Concurrent Product Fetches", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many product detail requests to run in parallel against Best Buy. Higher = faster runs but lower per-SKU pull-through under Akamai pressure. Default 1 gives the highest pull-through; try 2-3 if you care more about throughput than completeness.", "default": 1 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "US Residential proxies strongly recommended. Best Buy's Akamai Bot Manager closes HTTP/2 streams after 6-8 sustained requests per IP; the scraper rotates IP sessions automatically.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } }