Logo SearchApi

BestBuy Search API

GET   /api/v1/search?engine=bestbuy_search
OpenAPI Initiative Download OpenAPI Spec

The BestBuy Search API provides developers with access to BestBuy's extensive product catalog. You can search for products, filter by categories and store availability, and retrieve detailed product information including pricing, ratings, reviews, and savings. This API is ideal for price comparison tools, market research, and e-commerce applications.

API Parameters

Search Query

  • Name
    q
    Required
    Required
    Description

    The parameter specifies your search query. It accepts any term or phrase you'd typically input in a BestBuy search.

Filters

  • Name
    category_id
    Required
    Optional
    Description

    This parameter filters search results to a specific BestBuy category. You can find the list of categories and their IDs in the filters section of the response. Another way is to search on BestBuy and apply a department filter — the category ID will appear in the URL as the id parameter.

  • Name
    filters
    Required
    Optional
    Description

    Apply facet filters to narrow results. Use the filter_value from the filters section of the response. Combine multiple filters with ,. Example: brand_facet=Brand~HP,condition_facet=Condition~New.

  • Name
    sort_by
    Required
    Optional
    Description

    Parameter allows sorting search results by different criteria. Below is the list of available sorting options:

    • best_match - sort order based on relevance. Default
    • best_selling
    • best_discount
    • price_low_to_high
    • price_high_to_low
    • customer_rating
    • new_arrivals

Pagination

  • Name
    page
    Required
    Optional
    Description

    The parameter determines the results page number. It defaults to 1. You can find the max page number in the pagination section of the response.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to bestbuy_search.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Full Response

Full Response
GET
https://www.searchapi.org/api/v1/search?engine=bestbuy_search&q=macbook
Request
import requests

url = "https://www.searchapi.org/api/v1/search"
params = {
  "engine": "bestbuy_search",
  "q": "macbook"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_r572mGpCKkKrquPrr7mv9UhH",
    "status": "Success",
    "created_at": "2026-04-27T08:28:14Z",
    "request_time_taken": 5.49,
    "parsing_time_taken": 0.03,
    "total_time_taken": 5.52,
    "request_url": "https://www.bestbuy.com/site/searchpage.jsp?st=macbook",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_KEz3gde9WLploLF95pnaWoLG.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_RQU8NebtuCAlArIV6P7DdzUm"
  },
  "search_parameters": {
    "engine": "bestbuy_search",
    "q": "macbook"
  },
  "search_information": {
    "total_results": 2496
  },
  "organic_results": [
    {
      "position": 1,
      "product_id": "6615878",
      "title": "13-inch MacBook Neo Apple A18 Pro chip with 6‑core CPU and 5‑core GPU - 8GB Memory - 256GB SSD - Blush",
      "short_title": "13-inch MacBook Neo Apple A18 Pro chip with 6‑core CPU and 5‑core GPU - 8GB Memory - 256GB SSD",
      "link": "https://www.bestbuy.com/product/13-inch-macbook-neo-apple-a18-pro-chip-with-6core-cpu-and-5core-gpu-...",
      "brand": "Apple",
      "model_number": "MHFH4LL/A",
      "what_it_is": [
        "Laptop Computer",
        "MacBook"
      ],
      "classification": {
        "department": "COMPUTERS",
        "department_id": "6",
        "class": "APPLE LAPTOP",
        "class_id": "755",
        "subclass": "APPLE LAPTOP",
        "subclass_id": "7835"
      },
      "condition": "new",
      "rating": 4.8,
      "reviews": 202,
      "syndicated_reviews": [
        {
          "source": "bestbuy-ca",
          "rating": 4.86,
          "reviews": 7
        },
        "..."
      ],
      "seller": {
        "id": "bby",
        "name": "Best Buy"
      },
      "price": "$599.00",
      "extracted_price": 599.0,
      "member_savings": {
        "displayable_price": 599.0
      },
      "installment": {
        "months": "8 months",
        "extracted_months": 8,
        "cost_per_month": "$74.87",
        "extracted_cost_per_month": 74.87
      },
      "buying_options": [
        {
          "type": "New",
          "link": "https://www.bestbuy.com/product/13-inch-macbook-neo-apple-a18-pro-chip-with-6core-cpu-and-5core-gpu-..."
        },
        "..."
      ],
      "release_date": "2026-03-11T05:00Z",
      "thumbnail": "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/ab2dd6ec-7ae0-462f-9d0d-16818a71f9ec....",
      "images": [
        {
          "title": "Front Zoom",
          "link": "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/ab2dd6ec-7ae0-462f-9d0d-16818a71f9ec....",
          "alt_text": "Front. Apple - 13-inch MacBook Neo Apple A18 Pro chip with 6‑core CPU and 5‑core GPU - 8GB Memory - 256GB SSD - Blush."
        },
        "..."
      ]
    },
    "..."
  ],
  "filters": [
    {
      "type": "GIF-Same Day Shipping",
      "options": [
        {
          "text": "55423",
          "items": 5,
          "filter_value": "samedayshippingallcondition_facet=GIF-Same Day Shipping~55423",
          "link": "https://www.bestbuy.com/site/searchpage.jsp?st=macbook&qp=samedayshippingallcondition_facet%3DGIF-Sa..."
        },
        "..."
      ]
    },
    "..."
  ],
  "related_searches": [
    {
      "query": "laptop",
      "link": "https://www.bestbuy.com/site/searchpage.jsp?st=laptop"
    },
    "..."
  ],
  "pagination": {
    "current": 1,
    "next": "https://www.bestbuy.com/site/searchpage.jsp?st=macbook&cp=2",
    "other_pages": {
      "2": "https://www.bestbuy.com/site/searchpage.jsp?st=macbook&cp=2",
      "3": "https://www.bestbuy.com/site/searchpage.jsp?st=macbook&cp=3",
      "4": "https://www.bestbuy.com/site/searchpage.jsp?st=macbook&cp=4"
    }
  }
}

Browse by Category

Browse by Category
GET
https://www.searchapi.org/api/v1/search?category_id=pcmcat144700050004&engine=bestbuy_search&q=headphones
Request
import requests

url = "https://www.searchapi.org/api/v1/search"
params = {
  "engine": "bestbuy_search",
  "q": "headphones",
  "category_id": "pcmcat144700050004"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_5aWcDYsj0Gq93kKgs2QeI6Om",
    "status": "Success",
    "created_at": "2026-04-27T08:28:31Z",
    "request_time_taken": 5.31,
    "parsing_time_taken": 0.04,
    "total_time_taken": 5.35,
    "request_url": "https://www.bestbuy.com/site/searchpage.jsp?st=headphones&browsedCategory=pcmcat144700050004&id=pcat...",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_4T45SoeJ5zGFPv0p9bUomf9P.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_7m7SXguqmfuPbWkzD3JKWWaP"
  },
  "search_parameters": {
    "engine": "bestbuy_search",
    "q": "headphones",
    "category_id": "pcmcat144700050004"
  },
  "search_information": {
    "total_results": 1401
  },
  "organic_results": [
    {
      "position": 1,
      "product_id": "6447384",
      "title": "Apple - AirPods 4 - White",
      "short_title": "AirPods 4",
      "link": "https://www.bestbuy.com/product/apple-airpods-4-white/JJGCQ83JQ5",
      "brand": "Apple",
      "model_number": "MXP63LL/A",
      "what_it_is": [
        "Headphones",
        "Wireless Headphones"
      ],
      "classification": {
        "department": "AUDIO",
        "department_id": "1",
        "class": "APPLE HEADPHONES",
        "class_id": "746",
        "subclass": "APPLE TRUE WIRELESS",
        "subclass_id": "8421"
      },
      "condition": "new",
      "rating": 4.7,
      "reviews": 9422,
      "syndicated_reviews": [
        {
          "source": "ATT.com",
          "rating": 4.0,
          "reviews": 6
        },
        "..."
      ],
      "seller": {
        "id": "bby",
        "name": "Best Buy"
      },
      "is_sponsored": true,
      "price": "$99.99",
      "extracted_price": 99.99,
      "original_price": "$129.99",
      "extracted_original_price": 129.99,
      "discount": 30.0,
      "discount_percentage": 23,
      "member_savings": {
        "non_paid": 30.0,
        "displayable_price": 99.99
      },
      "installment": {
        "months": "4 months",
        "extracted_months": 4,
        "cost_per_month": "$25.00",
        "extracted_cost_per_month": 25.0
      },
      "finance_option": {
        "months": "12 months",
        "extracted_months": 12,
        "cost_per_month": "$25.00",
        "extracted_cost_per_month": 25.0,
        "rate": 0.0,
        "plan_type": "Deferred",
        "total_cost": 299.99
      },
      "free_gifts": [
        {
          "product_id": "6549173",
          "offer_id": "735933",
          "quantity": 1,
          "savings": 9.99
        },
        "..."
      ],
      "buying_options": [
        {
          "type": "New",
          "link": "https://www.bestbuy.com/product/apple-airpods-4-white/JJGCQ83JQ5/sku/6447384"
        },
        "..."
      ],
      "open_box_options": [
        {
          "condition": "Excellent",
          "price": "$89.99",
          "extracted_price": 89.99,
          "savings": "$10.00",
          "extracted_savings": 10.0,
          "link": "https://www.bestbuy.com/product/apple-airpods-4-white/JJGCQ83JQ5/sku/6447384/openbox?condition=excellent"
        },
        "..."
      ],
      "variants": [
        {
          "value": "White",
          "image": "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/..."
        },
        "..."
      ],
      "release_date": "2024-09-20T05:00Z",
      "thumbnail": "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/ed0cfc76-5b94-4e84-af82-a3cc7cff60e4....",
      "images": [
        {
          "title": "Front Zoom",
          "link": "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/ed0cfc76-5b94-4e84-af82-a3cc7cff60e4....",
          "alt_text": "Front. Apple - AirPods 4 - White."
        },
        "..."
      ],
      "badges": [
        "3 months free Apple Music"
      ]
    },
    "..."
  ]
}

Filters Applied

Filters Applied
GET
https://www.searchapi.org/api/v1/search?engine=bestbuy_search&filters=carriercompatibilitysv_facet%3DCarrier+Compatibility~Metro+by+T-Mobile%2Coperatingsystem_facet%3DOperating+System~Apple+iOS%2Ccurrentprice_facet%3DPrice~500+to+2000&q=iphone+17
Request
import requests

url = "https://www.searchapi.org/api/v1/search"
params = {
  "engine": "bestbuy_search",
  "q": "iphone 17",
  "filters": "carriercompatibilitysv_facet=Carrier Compatibility~Metro by T-Mobile,operatingsystem_facet=Operating System~Apple iOS,currentprice_facet=Price~500 to 2000"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_g7p4ErjuUqqf3BIaMZmaE6cl",
    "status": "Success",
    "created_at": "2026-04-27T08:28:47Z",
    "request_time_taken": 4.07,
    "parsing_time_taken": 0.01,
    "total_time_taken": 4.09,
    "request_url": "https://www.bestbuy.com/site/searchpage.jsp?st=iphone+17&qp=carriercompatibilitysv_facet%3DCarrier%2...",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_bUUBUvInFzCzq4z4BbSmkbbz.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_Hb3IUtuBVcvl7J7ML1COQskg"
  },
  "search_parameters": {
    "engine": "bestbuy_search",
    "q": "iphone 17",
    "filters": "carriercompatibilitysv_facet=Carrier Compatibility~Metro by T-Mobile,operatingsystem_facet=Operating System~Apple iOS,currentprice_facet=Price~500 to 2000"
  },
  "search_information": {
    "total_results": 2
  },
  "filters": [
    {
      "type": "Carrier Compatibility",
      "options": [
        {
          "text": "Metro by T-Mobile",
          "items": 2,
          "filter_value": "carriercompatibilitysv_facet=Carrier Compatibility~Metro by T-Mobile",
          "link": "https://www.bestbuy.com/site/searchpage.jsp?st=iphone+17&qp=carriercompatibilitysv_facet%3DCarrier%2..."
        },
        "..."
      ]
    },
    "..."
  ]
}