Shopify Catalog
GET
List products from a Shopify shop. query is the shop domain or a URL on that shop. page and limit choose the slice.
Credit cost: 1 credit per call
ApiKeyAuthheader
x-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringShop domain or a URL on that shop.
Example:
https://www.decathlon.comNotes:
decathlon.com,https://www.decathlon.com, and a product or collection link on that host all select the same shop.pagestarts at 1. Omit it to read the first page.limitis the page size. Default 30. Maximum 250.shopify.comandapps.shopify.comare rejected.
page?numberPage number, starting at 1.
Example:
2Notes:
- Omit
pageto read page 1. page=2returns the next slice of the samelimit.- The shop does not publish a total, so keep following
pagination.nextuntil it is null.
limit?numberHow many items to return on this page.
Example:
30Notes:
- Default is 30 when
limitis omitted. - Maximum is 250.
- When the page contains
limititems,pagination.nextis the next shop JSON URL. - When the page is shorter,
pagination.nextis null.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
Default
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
Default
falseSuccessful response
application/json- response
results?array<>pagination?curl -X GET 'https://api.piloterr.com/v2/shopify/catalog?query=string'Example Response
{ "results": [ { "id": 8209730371646, "url": "https://www.decathlon.com/products/men-s-hiking-jacket-mh500-brown", "tags": [ "Down Jackets", "FAMILY: 11413", "GENDER: MEN'S", "Men", "Men's", "MODEL: 8943726", "NATURE_ID: 25032", "New", "OneProductMigration", "PRODUCT_TYPE: Padded Jacket", "SPORT: mountain trekking", "SUPER_MODEL: 362762" ], "image": { "alt": null, "src": "https://cdn.shopify.com/s/files/1/1330/6287/files/default_61e4eded-7b52-4c7e-b922-fdfec444efd1.jpg?v=1793283479", "width": 969, "height": 969, "position": 1 }, "title": "Quechua Men’s MH500 Synthetic Puffer Jacket", "handle": "men-s-hiking-jacket-mh500-brown", "images": [ { "alt": null, "src": "https://cdn.shopify.com/s/files/1/1330/6287/files/default_61e4eded-7b52-4c7e-b922-fdfec444efd1.jpg?v=1793283479", "width": 969, "height": 969, "position": 1 }, { "alt": null, "src": "https://cdn.shopify.com/s/files/1/1330/6287/files/default_81cfeb13-15fb-4730-a3f1-cfb30cd8bf58.jpg?v=1793283479", "width": 969, "height": 969, "position": 2 }, { "alt": null, "src": "https://cdn.shopify.com/s/files/1/1330/6287/files/default_3dd23a97-fcb7-4d04-bdb6-ca888c2d245a.jpg?v=1793283479", "width": 969, "height": 969, "position": 3 }, { "alt": null, "src": "https://cdn.shopify.com/s/files/1/1330/6287/files/default_9e3d1445-c382-4f3e-8db8-7066695630c1.jpg?v=1793283479", "width": 969, "height": 969, "position": 4 }, { "alt": null, "src": "https://cdn.shopify.com/s/files/1/1330/6287/files/default_d890c30c-dc0c-4ae1-b26a-51be87a45b90.jpg?v=1793283479", "width": 969, "height": 969, "position": 5 }, { "alt": null, "src": "https://cdn.shopify.com/s/files/1/1330/6287/files/default_369047ee-4680-41dd-b28f-f9e0b613968e.jpg?v=1793283479", "width": 969, "height": 969, "position": 6 }, { "alt": null, "src": "https://cdn.shopify.com/s/files/1/1330/6287/files/default_8767ccae-471e-49f1-a0ad-bdab8c5928a6.jpg?v=1793283479", "width": 969, "height": 969, "position": 7 }, { "alt": null, "src": "https://cdn.shopify.com/s/files/1/1330/6287/files/default_17936e65-04e6-46ba-ac28-1eebd651dc03.jpg?v=1793283479", "width": 969, "height": 969, "position": 8 } ], "vendor": "Quechua", "options": [ { "name": "Size", "values": [ "S", "2XL", "M", "3XL", "L", "XL" ], "position": 1 } ], "variants": [ { "id": 43182120337470, "sku": "5544385", "grams": 440, "price": 69.99, "title": "S", "option1": "S", "option2": null, "option3": null, "available": true, "price_display": "69.99", "compare_at_price": null, "compare_at_price_display": null }, { "id": 43182140358718, "sku": "5544389", "grams": 548, "price": 69.99, "title": "2XL", "option1": "2XL", "option2": null, "option3": null, "available": true, "price_display": "69.99", "compare_at_price": null, "compare_at_price_display": null }, { "id": 43182160216126, "sku": "5544386", "grams": 456, "price": 69.99, "title": "M", "option1": "M", "option2": null, "option3": null, "available": true, "price_display": "69.99", "compare_at_price": null, "compare_at_price_display": null }, { "id": 43194906083390, "sku": "5544390", "grams": 564, "price": 69.99, "title": "3XL", "option1": "3XL", "option2": null, "option3": null, "available": true, "price_display": "69.99", "compare_at_price": null, "compare_at_price_display": null }, { "id": 43194907426878, "sku": "5544387", "grams": 472, "price": 69.99, "title": "L", "option1": "L", "option2": null, "option3": null, "available": true, "price_display": "69.99", "compare_at_price": null, "compare_at_price_display": null }, { "id": 43194910769214, "sku": "5544388", "grams": 502, "price": 69.99, "title": "XL", "option1": "XL", "option2": null, "option3": null, "available": true, "price_display": "69.99", "compare_at_price": null, "compare_at_price_display": null } ], "created_at": "2026-08-10T07:57:16-07:00", "updated_at": "2026-10-30T10:41:35-07:00", "description": "When the temperature drops, this down jacket is your perfect companion, offering warmth, slim fit, a hood and ideal comfort for your excursions or everyday wear", "product_type": "Padded Jacket", "published_at": "2026-10-29T06:59:49-07:00" } ], "pagination": { "next": "https://www.decathlon.com/products.json?limit=1&page=2", "page": 1, "per_page": 1, "total_pages": null, "total_results": null }}