Best Buy Search
Search Best Buy US or Canada by keyword or search URL. Returns product listings with price, rating and pagination via browser rendering.
Credit cost: 2 credits per call
Autorización
ApiKeyAuth x-api-key<token>
Your API key. Include it in the x-api-key header for every request.
In: header
Parámetros de consulta
query*string
Keyword or full Best Buy search URL.
Examples:
machinehttps://www.bestbuy.com/site/searchpage.jsp?st=machinehttps://www.bestbuy.ca/fr-ca/chercher?search=machineA full Best Buy URL auto-detects region.
region?string
Best Buy country when query is not a full URL (default: com).
Supported:
com→ www.bestbuy.com, USDca→ www.bestbuy.ca, CAD
page?number
Page number (default: 1).
sort?string
Sort order (default: best_selling).
Supported: best_selling, best_discount
Default
"best_selling"return_page_source?boolean
When true, return rendered HTML as {"result": "..."} instead of JSON. Defaults to false.
Cuerpo de la respuesta
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v2/bestbuy/search?query=string"{ "results": [ { "url": "https://www.bestbuy.com/product/singing-machine-smk302pp-kids-bluetooth-headphones-pink-collectibles-multicolor/J7GW9JWXZ5", "type": "product", "price": 29.99, "title": "Singing Machine - SMK302PP Kids Bluetooth Headphones Pink - COLLECTIBLES - Multicolor", "currency": "USD", "condition": "new", "image_url": "https://pisces.bbystatic.com/image2/BestBuy_US/images/products/014a6bfe-fd8a-413d-a204-49efbdb9baaa.jpg", "product_id": "J7GW9JWXZ5" } ], "pagination": { "next": 2, "page": 1, "per_page": 18, "total_pages": 763, "has_next_page": true, "total_results": 13730 }}{ "error": "Bad Request"}{ "error": "Invalid API Key"}{ "error": "Payment required"}{ "error": "Rate limit exceeded for the API key: quota monthly"}{ "error": "Internal Error"}