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.
Successful 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 }}