Home Depot

List Home Depot stores near ZIP code

List Home Depot stores near a US ZIP code, with addresses, coordinates, distance, phone numbers, opening hours and services.

GET/v1/home-depot/stores
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
zipCodestringrequiredquery

US ZIP code to search around, e.g. `30339`.

pattern: ^\d{5}$

radiusintegeroptionalquery

Search radius in miles, 1 to 100. Default: 50.

≥ 1 · ≤ 100

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page. It only works with the same filters.

min 1 chars · max 1024 chars

Response fields
37

Endpoint-specific response payload.

datalookupStatus
string

Always `found`: no store within the radius, or a ZIP code the site can't place, is an empty list.

one of: found, not_found

datazipCode
string

The ZIP code searched around.

dataradius
integer

The radius searched, in miles.

datatotalResults
integernullable

Stores within the radius, across every page.

Stores on this page, nearest first.

datastores[]id
string

Store number, e.g. `0121`.

datastores[]name
stringnullable

Store name, e.g. `Cumberland`.

datastores[]url
stringnullable

Store page URL.

datastores[]street
stringnullable

Street address.

datastores[]city
stringnullable

City.

datastores[]state
stringnullable

State code, e.g. `GA`.

datastores[]postalCode
stringnullable

ZIP code.

datastores[]county
stringnullable

County.

datastores[]country
stringnullable

Country code, e.g. `US`.

datastores[]latitude
numbernullable

Latitude.

datastores[]longitude
numbernullable

Longitude.

datastores[]distanceMiles
numbernullable

Distance from the searched ZIP code, in miles.

datastores[]phone
stringnullable

Store phone number.

datastores[]timeZone
stringnullable

Store time zone, e.g. `EST5EDT`.

datastores[]storeType
stringnullable

Store type, e.g. `retail`.

Store opening hours.

datastores[]hours[]day
string

Day of the week.

one of: monday, tuesday, wednesday, thursday, friday, saturday, sunday

datastores[]hours[]open
stringnullable

Opening time, 24-hour `H:MM`.

datastores[]hours[]close
stringnullable

Closing time, 24-hour `H:MM`.

Services the store offers, e.g. `toolRental`, `propane`, `keyCutting`.

datastores[]services[]
stringoptional

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor for the next page; null on the last page.

datapagetruncated
boolean

True when the list stops here before its end: more rows exist (see `totalResults`) but no further page can be read.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/home-depot/stores?zipCode=30339" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Home Depot stores near a ZIP code.