{
  "openapi": "3.0.1",
  "info": {
    "title": "Best Buy Scraper: Prices, Ratings, Stock and Store Pickup",
    "description": "Scrape Best Buy by keyword, category or product link: one row per product with price, regular price, savings, rating, reviews, SKU, model, brand, seller and in stock. Add a ZIP for store pickup and same day delivery, or details for specs. No login.",
    "version": "0.1",
    "x-build-id": "fnDJsRcbYrumNqFEE"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/themineworks~bestbuy-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-themineworks-bestbuy-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/themineworks~bestbuy-scraper/runs": {
      "post": {
        "operationId": "runs-sync-themineworks-bestbuy-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/themineworks~bestbuy-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-themineworks-bestbuy-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": "Keywords",
            "type": "array",
            "description": "Product keywords, one per line, as you would type them in the Best Buy search box. Example: laptop, airpods, 65 inch tv. Each keyword is one search. Up to 100 searches per run.",
            "items": {
              "type": "string"
            }
          },
          "categoryUrls": {
            "title": "Category links (optional)",
            "type": "array",
            "description": "Best Buy category links copied from your browser, for example https://www.bestbuy.com/site/laptop-computers/all-laptops/pcmcat138500050001.c?id=pcmcat138500050001. The id alone is enough too (pcmcat138500050001). Best Buy search links (searchpage.jsp?st=...) work here as well.",
            "items": {
              "type": "string"
            }
          },
          "productUrls": {
            "title": "Product links or SKUs (optional)",
            "type": "array",
            "description": "Best Buy product links, for example https://www.bestbuy.com/site/apple-airpods-4/6447382.p?skuId=6447382 or the new style https://www.bestbuy.com/product/<name>/<id>/sku/6447382, or just the SKU number (6447382). Up to 1,000 per run, read 24 per call.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Max products per search",
            "minimum": 1,
            "maximum": 2000,
            "type": "integer",
            "description": "The most products to return for each keyword or category, 1 to 2,000. Best Buy serves about 2,000 results for one search at most; the actor reads 48 per page.",
            "default": 50
          },
          "sort": {
            "title": "Sort by",
            "enum": [
              "relevance",
              "best_selling",
              "best_discount",
              "price_low",
              "price_high",
              "rating",
              "newest"
            ],
            "type": "string",
            "description": "Order of the search and category results, as on bestbuy.com.",
            "default": "relevance"
          },
          "zipCode": {
            "title": "ZIP code for store pickup (optional)",
            "type": "string",
            "description": "A 5 digit US ZIP code. Every row then says whether the product can be picked up at the nearest Best Buy store and whether same day delivery to that ZIP is offered. Example: 10001."
          },
          "nearbyStores": {
            "title": "Stores to check for pickup",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "How many of the nearest stores to the ZIP to check, 1 to 5. With more than 1, each row lists the stores where pickup is available. Each extra store adds one small call per 24 products.",
            "default": 1
          },
          "storeId": {
            "title": "Best Buy store number (optional)",
            "type": "string",
            "description": "A Best Buy store number, for example 482 (Chelsea, New York). Use this instead of, or with, a ZIP code when you know the store."
          },
          "includeDetails": {
            "title": "Add product details",
            "type": "boolean",
            "description": "On: each product also gets its description, features, what is in the box, full specifications and image links. One extra call per 12 products. Same price per product either way.",
            "default": false
          },
          "maxImages": {
            "title": "Images per product (with details)",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "How many image links to return per product when details are on, 1 to 30.",
            "default": 10
          },
          "brands": {
            "title": "Only these brands (optional)",
            "type": "array",
            "description": "Brand names as Best Buy shows them, for example HP, Lenovo, Samsung. Applied as Best Buy's own brand filter.",
            "items": {
              "type": "string"
            }
          },
          "onSaleOnly": {
            "title": "On sale only",
            "type": "boolean",
            "description": "Only products Best Buy lists under its On Sale filter.",
            "default": false
          },
          "inStockOnly": {
            "title": "In stock only",
            "type": "boolean",
            "description": "Apply Best Buy's \"Exclude Out of Stock Items\" filter.",
            "default": false
          },
          "pickupOnly": {
            "title": "Pickup at the store only",
            "type": "boolean",
            "description": "With a ZIP code or store number: only products that can be picked up at that store (the nearest one).",
            "default": false
          },
          "condition": {
            "title": "Condition",
            "enum": [
              "any",
              "new",
              "open_box",
              "refurbished"
            ],
            "type": "string",
            "description": "New, open box or refurbished only, or any.",
            "default": "any"
          },
          "proxyConfiguration": {
            "title": "Proxy (optional)",
            "type": "object",
            "description": "Leave as is. The actor picks the route itself: straight from the Apify server first, then an Apify datacenter IP, then a US residential IP when Best Buy refuses a call. All included in the price. Pick proxy groups here only if you want every call to go through them.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}