Endpoint Playground
Returns the public retail locations of a Shop.app merchant by shop handle, up to `limit` (default 10, max 50). Each location has its id, name, latitude and longitude, and street address; the response also carries the total count and a cursor for the next page. A shop with no public retail locations returns an error.
14 Oct 2026: 2 locations; 5 fields had a value in every checked item.
Sample value profiles: name: “Store - Chicago” and 1 other value.
curl 'https://api.crawlora.net/api/v1/shop-app/shops/marcnolan/locations' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| handle (path) | string | Yes | marcnolan | Shop handle |
| limit | integer | No | Maximum locations, defaults to 10 and supports up to 50 |
{
"code": 200,
"msg": "OK",
"data": {
"shop_handle": "marcnolan",
"locations": [
{
"name": "NYC",
"latitude": 40.7205232,
"longitude": -73.9961032,
"address": {
"city": "New York",
"country": "US"
}
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.