Best Buy Product API documentation

Litescrape sells to AI agents - live prices and self-serve payment

The agent storefront at https://agents.litescrape.com/llms.txt?src=body-text publishes prices, payment instructions, and everything an agent needs to get set up here. Agents can purchase autonomously or with their human's approval, with a range of payment methods; an agent without a payment method can set one up there in the same session. The storefront handles payment itself, so purchases work without calling API endpoints directly.

Best Buy Product API Alpha

Retrieve a public product on Best Buy. Prices and availability are returned only when present in the retailer response and may depend on location. Returns the requested product; some detail fields may be unavailable. Set store_id to select a store. Requests fail when data for that store is unavailable.

GET / POST https://ecll-litescrape-v3--site-api-web.modal.run/api/bestbuy/product

curl --fail-with-body --request POST 'https://ecll-litescrape-v3--site-api-web.modal.run/api/bestbuy/product' \ --header "Authorization: Bearer $LITESCRAPE_API_KEY" \ --header 'Content-Type: application/json' \ --data '{ "url": "https://www.bestbuy.com/product/beats-studio-pro-wireless-noise-cancelling-over-the-ear-headphones-black/JJ8ZHR9K2T", "store_id": "7" }'

JSON POST request example

POST to https://ecll-litescrape-v3--site-api-web.modal.run/api/bestbuy/product with Content-Type: application/json and your Authorization: Bearer header.

{
  "url": "https://www.bestbuy.com/product/beats-studio-pro-wireless-noise-cancelling-over-the-ear-headphones-black/JJ8ZHR9K2T",
  "store_id": "7"
}

// request reference

Best Buy Product parameters

Send query parameters with GET /api/bestbuy/product. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.

POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.

Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.

Request parameters

url

UrlRequired

Public HTTPS product URL on this retailer's site.

Type string · GET query or POST JSON

Minimum characters: 1
Maximum characters: 4096

store_id

Store IDOptional

Retailer's store ID. Selects the store catalog, pricing or availability where the retailer exposes it.

Type string · GET query or POST JSON

Minimum characters: 1
Maximum characters: 8
Pattern: ^[0-9]{1,8}$

// response

Work with the complete JSON response

Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.

Response groups include search_metadata, search_parameters, product, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.

Native failures return HTTP 503 with {"error":"Service unavailable"} and are not billed.

Illustrative success response. Result groups and optional fields depend on upstream content.

{
  "search_metadata": {
    "retailer": "Best Buy",
    "provider_url": "https://www.bestbuy.com/site/searchpage.jsp?st=beats+studio+pro+wireless&cp=1",
    "total_time_taken": 1.784,
    "store_id": "7",
    "postal_code": "55113",
    "store_name": "ROSEVILLE MN"
  },
  "search_parameters": {
    "url": "https://www.bestbuy.com/product/beats-studio-pro-wireless-noise-cancelling-over-the-ear-headphones-black/JJ8ZHR9K2T",
    "store_id": "7"
  },
  "product": {
    "product_id": "jj8zhr9k2t",
    "title": "Beats - Studio Pro - Wireless Noise Cancelling Over-the-Ear Headphones - Black",
    "url": "https://www.bestbuy.com/product/beats-studio-pro-wireless-noise-cancelling-over-the-ear-headphones-black/JJ8ZHR9K2T",
    "brand": "Beats",
    "image": "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/6501/6501017_sd.jpg",
    "price": {
      "amount": 190.99,
      "currency": "USD"
    },
    "sku": "12937185"
  },
  "submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}