Aller au contenu principal
Piloterr
Retour à la bibliothèque

API Shopify Catalog

Listez les produits d'une boutique Shopify. query est le domaine de la boutique ou une URL de cette boutique. page et limit choisissent la page.

Actif1 crédit = 1 requêteGET/v2/shopify/catalog

Vue d'ensemble de l'endpoint

Documentation détaillée, tarifs et exemples d'utilisation.

AperçuLink to Aperçu

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.

Démarrage rapideLink to Démarrage rapide

GET https://api.piloterr.com/v2/shopify/catalog?query=https://www.decathlon.com&page=1&limit=30

ParamètresLink to Paramètres

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.

Champs de réponseLink to Champs de réponse

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.

Cas d'usageLink to Cas d'usage

  • 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

Codes d'erreurLink to Codes d'erreur

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é

API associées

Étendez vos capacités data avec ces outils complémentaires.

Prêt à commencer ?

Votre API de scraping web est à un clic. Commencez avec +500 crédits, sans infrastructure à gérer, sans proxies à configurer, et sans carte bancaire.

  • +500 crédits
  • Aucune carte bancaire requise
  • Tous les endpoints inclus