L'API Shopify Catalog liste les produits d'une boutique Shopify publique. query est le domaine de la boutique ou une URL de cette boutique, par exemple decathlon.com ou https://www.decathlon.com. Un lien produit sur le même hôte sélectionne aussi cette boutique. shopify.com et apps.shopify.com sont refusés.
Le flux public /products.json de la boutique est renvoyé dans results et pagination.
GET https://api.piloterr.com/v2/shopify/catalog?query=https://www.decathlon.com&page=1&limit=30
| Paramètre |
Type |
Requis |
Description |
query |
string |
oui |
Domaine de la boutique ou URL de cette boutique. decathlon.com et https://www.decathlon.com/products/un-handle lisent tous les deux Decathlon. |
page |
integer |
non |
Numéro de page, à partir de 1. Sans page, c'est la page 1. page=2 est la tranche suivante. |
limit |
integer |
non |
Nombre d'articles sur la page. Défaut 30. Maximum 250. |
| Champ |
Type |
Description |
results[].title |
string |
Titre du produit |
results[].url |
string |
URL du produit sur la boutique |
results[].vendor |
string |
Vendeur |
results[].variants[].price |
number |
Prix de la variante |
results[].variants[].price_display |
string |
Libellé du prix, sans tiret final |
results[].variants[].compare_at_price |
number ou null |
Prix barré quand la boutique l'envoie |
pagination.page |
number |
Page demandée |
pagination.per_page |
number |
limit demandé |
pagination.next |
string ou null |
URL JSON de la page suivante si la page est pleine, sinon null |
total_results et total_pages sont null : le JSON de la boutique ne donne pas de total. Quand la page contient exactement limit produits, next pointe vers page + 1. Quand elle en contient moins, next est null.
- Parcourir le catalogue d'une boutique pour suivre les prix
- Importer les premières pages d'un shop dans un PIM
- Suivre
pagination.next jusqu'à la fin du catalogue
| Code |
Signification |
| 400 |
Query absente, domaine qui n'est pas une boutique, ou page / limit hors limites |
| 403 |
La boutique a bloqué le flux JSON |
| 404 |
Cette page ne contient aucun produit |
| 500 |
Le flux n'a pas pu être récupéré |