Shopify API endpoint
Lists static pages from a Shopify storefront given by the required `url`, paged with `page` (from 1) and `limit` (default 50, max 250). Each has `handle`, `title`, `url`, plain-text `content` and dates. If `transport_mode` is `ssr_embedded`, items hold only `handle`, `url` and `updated_at`.
/shopify/pagesReturns static pages from a public Shopify store.
url: required. Full Shopify storefront URL, using http or https. Localhost, private network, link-local, and credentialed URLs are rejected.page: optional. Defaults to 1.limit: optional. Defaults to 50, maximum 250.body_html; raw HTML is not returned.200 with an empty pages array.transport_mode: "ssr_embedded", and each item only carries handle, url, and updated_at — no title, id, or content. Call GET /shopify/pages/{handle} per handle to get full content. transport_mode is omitted entirely for other stores.transport_mode allowed values: ssr_embedded (only ever present, never any other value; omitted for the classic transport).
| Field | Filled in, of 40 checked | Values in the sample |
|---|---|---|
| id | 40 | |
| handle | 40 | |
| title | 40 | “10 Tested Tips for Beginner Runners” and 38 other values |
| url | 40 | allbirds.com |
| published_at | 40 | 2020-12-14 to 2026-03-19 |
| created_at | 40 | 2017-04-25 to 2025-10-10 |
| updated_at | 40 | 2020-12-14 to 2026-03-19 |
| content | 11 | median 3,997 characters |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| url | string | Yes | Shopify storefront URL | https://www.allbirds.com | |
| page | integer | No | 1 | 1-based page, defaults to 1 | 1 |
| limit | integer | No | 50 and supports up to 250 | Maximum pages, defaults to 50 and supports up to 250 | 50 |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/shopify/pages?url=https%3A%2F%2Fwww.allbirds.com&page=1&limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"store_url": "https://www.allbirds.com",
"source_url": "https://www.allbirds.com",
"page": 1,
"limit": 50,
"pages": [
{
"id": "54831906896",
"handle": "accessibility",
"title": "Accessibility",
"url": "https://www.allbirds.com/pages/accessibility",
"content": "Our Commitment to Accessibility"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/shopify.pagesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | shopify.PagesResponse | No | ||||
| data.limit | integer | No | 50 | Maximum number of pages returned per page of results. | ||
| data.page | integer | No | 1 | Page number returned. | ||
| data.pages | array | No | Static pages on this page of results, one item per page. | |||
| data.pages[].content | string | No | Body of the page as plain text. | |||
| data.pages[].created_at | string | No | Time the record was created, as Shopify returns it. | |||
| data.pages[].handle | string | No | accessibility | URL slug of the page, for example `accessibility`. | ||
| data.pages[].id | string | No | 54831906896 | Shopify page id. | ||
| data.pages[].published_at | string | No | Time the record was published, as Shopify returns it. | |||
| data.pages[].title | string | No | Accessibility | Page title as shown on the storefront. | ||
| data.pages[].updated_at | string | No | Time the record was last updated, as Shopify returns it. | |||
| data.pages[].url | string | No | https://www.allbirds.com/pages/accessibility | Storefront URL of the page. | ||
| data.source_url | string | No | https://www.allbirds.com | URL the data was read from. | ||
| data.store_url | string | No | https://www.allbirds.com | Base URL of the Shopify storefront that was queried. | ||
| data.transport_mode | string | No | ssr_embedded | ssr_embedded | TransportMode is present only when the store required the embedded-SSR-JSON fallback transport. In this mode pages are discovered from the storefront's own pages sitemap rather than a listing API: each item only carries handle/url/updated_at (no title or content) — call GET /shopify/pages/{handle} per handle for full content. | |
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/shopify/pages?url=https%3A%2F%2Fwww.allbirds.com&page=1&limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"