---
title: "List Shop.app shop locations"
method: GET
path: "/shop-app/shops/{handle}/locations"
tags: ["Shop.app"]
---

# List Shop.app shop locations

`GET /shop-app/shops/{handle}/locations`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/shop-app/shops/{handle}/locations`
- Auth: API key in header `x-api-key`

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.

## Path parameters

- `handle` string, required

## Query parameters

- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- ShopappShopLocationsResponseDoc
  - `code` integer
  - `data` ShopappShopLocationsResponse
    - `limit` integer: Maximum number of locations requested.
    - `locations` ShopappShopLocationItem[]: Retail locations of the shop.
      - `address` ShopappLocationAddress
        - `address1` string: First line of the street address.
        - `address2` string: Second line of the street address.
        - `city` string: City of the address.
        - `country` string: Country of the address, for example `US`.
        - `postal_code` string: Postal code of the address.
        - `zone_code` string: State or region code of the address, for example `NY`.
      - `id` string: Shopify location ID, for example `gid://shopify/Location/78620459087`.
      - `latitude` number: Latitude of the location, in degrees.
      - `longitude` number: Longitude of the location, in degrees.
      - `name` string: Name of the location, for example `NYC`.
    - `next_cursor` string: Cursor Shop.app returns for the next page of locations.
    - `shop_handle` string: Shop.app handle of the shop.
    - `shop_id` string: Shop.app ID of the shop.
    - `total_count` integer: Total number of locations the shop has.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)