Docs menu

Best Buy API endpoint

Best Buy Store Locator API

Returns Best Buy's physical store locations in one city (name, address, phone, coordinates, rating, hours), sourced from Best Buy's own SEO store directory. state is one of the 50 US state codes plus dc and pr: `al`, `ak`, `az`, `ar`, `ca`, `co`, `ct`, `de`, `dc`, `fl`, `ga`, `hi`, `id`, `il`, `in`, `ia`, `ks`, `ky`, `la`, `me`, `md`, `ma`, `mi`, `mn`, `ms`, `mo`, `mt`, `ne`, `nv`, `nh`, `nj`, `nm`, `ny`, `nc`, `nd`, `oh`, `ok`, `or`, `pa`, `pr`, `ri`, `sc`, `sd`, `tn`, `tx`, `ut`, `vt`, `va`, `wa`, `wv`, `wi`, `wy`. city is free text matched case-insensitively against that state's own directory (e.g. "Chicago").

GETapiKey3 credits/requestBest Buybestbuy.storesResponseDoc/bestbuy/stores

Endpoint facts

Method: GET
API path: /bestbuy/stores
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Best Buy
Response schema: #/definitions/bestbuy.storesResponseDoc

Best Buy Scraper API Try Best Buy Store Locator API in Playground Best Buy API documentation

How this endpoint behaves

Query parameters:

state (required) -- one of the 50 US state codes plus dc and pr: al, ak, az, ar, ca, co, ct, de, dc, fl, ga, hi, id, il, in, ia, ks, ky, la, me, md, ma, mi, mn, ms, mo, mt, ne, nv, nh, nj, nm, ny, nc, nd, oh, ok, or, pa, pr, ri, sc, sd, tn, tx, ut, vt, va, wa, wv, wi, wy.
city (required) -- free text, matched case-insensitively against that state's own directory (e.g. Chicago, Arlington Heights).

Notable response behavior:

count/stores cover every store in the matched city -- one store for most cities, several for a dense metro (bounded at 20 stores per request).
hours maps a full day name (Monday..Sunday) to that day's opening range (e.g. "10:00-21:00").
A city value with no match in that state's directory returns a 404, not an empty stores list.
state must be one of the enumerated codes above; any other value is a 400.

Live monitoring

Monitored request: GET /bestbuy/stores?city=Chicago&state=il
Checks passed, 7 days to 14 Oct 2026: 99.9%
Median response time: 9.25 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /bestbuy/stores?city=Chicago&state=il
Items in stores: 3
Fields filled in every checked item: 13

Field	Filled in, of 3 checked	Values in the sample
name	3	“Best Buy”
address	3
city	3	“Chicago”
state	3	“IL”
postal_code	3
country	3	“US”
phone	3
latitude	3
longitude	3
rating	3	4.1 to 4.2, median 4.13
review_count	3	2,112 to 4,258, median 3,659
hours	3
url	3	stores.bestbuy.com

Request parameters

Parameter	Type	Required	Description	Example
state	string	Yes	Two-letter state/territory code	il
city	string	Yes	City name	Chicago
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/bestbuy/stores?state=il&city=Chicago" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "state": "il",
    "city": "Chicago",
    "count": 3,
    "source_url": "https://stores.bestbuy.com/il/chicago.html",
    "fetched_at": "2026-08-15T10:00:00Z",
    "stores": [
      {
        "name": "Best Buy",
        "address": "2100 N Elston Ave",
        "city": "Chicago",
        "state": "IL",
        "postal_code": "60614",
        "country": "US",
        "phone": "(773) 486-0142",
        "latitude": 41.919002,
        "longitude": -87.66959,
        "rating": 4.21,
        "review_count": 3614,
        "hours": {
          "Monday": "10:00-21:00",
          "Sunday": "10:00-20:00"
        },
        "url": "https://stores.bestbuy.com/il/chicago/2100-n-elston-ave-814.html"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/bestbuy.storesResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	bestbuy.StoreResponse	No
data.city	string	No	Chicago
data.count	integer	No	3
data.fetched_at	string	No
data.source_url	string	No
data.state	string	No	il
data.stores	array	No
data.stores[].address	string	No	2100 N Elston Ave
data.stores[].city	string	No	Chicago
data.stores[].country	string	No	US
data.stores[].hours	object	No		Hours maps a full day name ("Monday".."Sunday") to that day's opening range, e.g. "10:00-21:00" -- expanded from schema.org's own comma-joined-days shorthand (see parseOpeningHours). Joined with ", " for the rare split-hours day.
data.stores[].latitude	number	No	41.919002
data.stores[].longitude	number	No	-87.66959
data.stores[].name	string	No	Best Buy
data.stores[].phone	string	No	(773) 486-0142
data.stores[].postal_code	string	No	60614
data.stores[].rating	number	No	4.21
data.stores[].review_count	integer	No	3614
data.stores[].state	string	No	IL
data.stores[].url	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/bestbuy/stores?state=il&city=Chicago" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Best Buy endpoint docs Best Buy Scraper API Get Best Buy's full brand directory API documentation Best Buy Categories API documentation Best Buy Trending Categories API documentation Best Buy Category Listing API documentation Best Buy Subcategories API documentation Get a Best Buy product's detail API documentation

Open in Playground Back to group

Docs menu

Best Buy API endpoint

Best Buy Store Locator API

GETapiKey3 credits/requestBest Buybestbuy.storesResponseDoc/bestbuy/stores

Endpoint facts

Method: GET
API path: /bestbuy/stores
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Best Buy
Response schema: #/definitions/bestbuy.storesResponseDoc

Best Buy Scraper API Try Best Buy Store Locator API in Playground Best Buy API documentation

How this endpoint behaves

Query parameters:

state (required) -- one of the 50 US state codes plus dc and pr: al, ak, az, ar, ca, co, ct, de, dc, fl, ga, hi, id, il, in, ia, ks, ky, la, me, md, ma, mi, mn, ms, mo, mt, ne, nv, nh, nj, nm, ny, nc, nd, oh, ok, or, pa, pr, ri, sc, sd, tn, tx, ut, vt, va, wa, wv, wi, wy.
city (required) -- free text, matched case-insensitively against that state's own directory (e.g. Chicago, Arlington Heights).

Notable response behavior:

count/stores cover every store in the matched city -- one store for most cities, several for a dense metro (bounded at 20 stores per request).
hours maps a full day name (Monday..Sunday) to that day's opening range (e.g. "10:00-21:00").
A city value with no match in that state's directory returns a 404, not an empty stores list.
state must be one of the enumerated codes above; any other value is a 400.

Live monitoring

Monitored request: GET /bestbuy/stores?city=Chicago&state=il
Checks passed, 7 days to 14 Oct 2026: 99.9%
Median response time: 9.25 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /bestbuy/stores?city=Chicago&state=il
Items in stores: 3
Fields filled in every checked item: 13

Field	Filled in, of 3 checked	Values in the sample
name	3	“Best Buy”
address	3
city	3	“Chicago”
state	3	“IL”
postal_code	3
country	3	“US”
phone	3
latitude	3
longitude	3
rating	3	4.1 to 4.2, median 4.13
review_count	3	2,112 to 4,258, median 3,659
hours	3
url	3	stores.bestbuy.com

Request parameters

Parameter	Type	Required	Description	Example
state	string	Yes	Two-letter state/territory code	il
city	string	Yes	City name	Chicago
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/bestbuy/stores?state=il&city=Chicago" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "state": "il",
    "city": "Chicago",
    "count": 3,
    "source_url": "https://stores.bestbuy.com/il/chicago.html",
    "fetched_at": "2026-08-15T10:00:00Z",
    "stores": [
      {
        "name": "Best Buy",
        "address": "2100 N Elston Ave",
        "city": "Chicago",
        "state": "IL",
        "postal_code": "60614",
        "country": "US",
        "phone": "(773) 486-0142",
        "latitude": 41.919002,
        "longitude": -87.66959,
        "rating": 4.21,
        "review_count": 3614,
        "hours": {
          "Monday": "10:00-21:00",
          "Sunday": "10:00-20:00"
        },
        "url": "https://stores.bestbuy.com/il/chicago/2100-n-elston-ave-814.html"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/bestbuy.storesResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	bestbuy.StoreResponse	No
data.city	string	No	Chicago
data.count	integer	No	3
data.fetched_at	string	No
data.source_url	string	No
data.state	string	No	il
data.stores	array	No
data.stores[].address	string	No	2100 N Elston Ave
data.stores[].city	string	No	Chicago
data.stores[].country	string	No	US
data.stores[].hours	object	No		Hours maps a full day name ("Monday".."Sunday") to that day's opening range, e.g. "10:00-21:00" -- expanded from schema.org's own comma-joined-days shorthand (see parseOpeningHours). Joined with ", " for the rare split-hours day.
data.stores[].latitude	number	No	41.919002
data.stores[].longitude	number	No	-87.66959
data.stores[].name	string	No	Best Buy
data.stores[].phone	string	No	(773) 486-0142
data.stores[].postal_code	string	No	60614
data.stores[].rating	number	No	4.21
data.stores[].review_count	integer	No	3614
data.stores[].state	string	No	IL
data.stores[].url	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/bestbuy/stores?state=il&city=Chicago" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Best Buy Store Locator API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Best Buy Store Locator API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related