Shopify

List Shopify store locations

List a Shopify store's physical locations with address, coordinates and phone.

GET/v1/shopify/store/locations
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
storestringrequiredquery

The store's domain, for example `allbirds.com`, `www.allbirds.com` or `weareallbirds.myshopify.com`. A full URL is accepted and reduced to its host. Only public storefront hosts are accepted.

limitintegeroptionalquery

Locations per page, 1 to 250. Default: 50.

≥ 1 · ≤ 250

cursorstringoptionalquery

Cursor from `page.nextCursor` of the previous response. It only works with the same filters.

min 1 chars · max 4096 chars

Response fields
27

Endpoint-specific response payload.

datalookupStatus
string

`found` on success; `not_found` when it does not exist or is not a Shopify store; `private` when the storefront is password-protected; `restricted` when the store is paused or frozen.

one of: found, not_found, private, restricted

datastore
string

The store host that was requested.

Physical store locations.

datalocations[]id
string

Location id.

datalocations[]name
string

Location name.

The address the merchant published.

datalocations[]addressaddress1
stringnullable

Street address.

datalocations[]addressaddress2
stringnullable

Second line.

datalocations[]addresscity
stringnullable

City.

datalocations[]addressprovince
stringnullable

Province or state.

datalocations[]addressprovinceCode
stringnullable

Province code.

datalocations[]addresszip
stringnullable

Postal code.

datalocations[]addresscountry
stringnullable

Country name.

datalocations[]addresscountryCode
stringnullable

Country code.

datalocations[]addresslatitude
numbernullable

Latitude.

datalocations[]addresslongitude
numbernullable

Longitude.

datalocations[]addressphone
stringnullable

Phone number.

The address as the store formats it.

datalocations[]addressformatted[]
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.

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

Code example

curl "https://api.socialfetch.dev/v1/shopify/store/locations?store=0171d6-3.myshopify.com" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A Shopify store's physical locations.