Aller au contenu principal
Piloterr
Retour à la bibliothèque

API Shopify Collections

Listez les collections 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/collections

Vue d'ensemble de l'endpoint

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

AperçuLink to Aperçu

L'API Shopify Collections liste les collections 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 de collection sur le même hôte sélectionne aussi cette boutique. shopify.com et apps.shopify.com sont refusés.

Le flux public /collections.json de la boutique est renvoyé dans results et pagination.

Démarrage rapideLink to Démarrage rapide

GET https://api.piloterr.com/v2/shopify/collections?query=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/collections/camping-tents 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 de collections sur la page. Défaut 30. Maximum 250.

Champs de réponseLink to Champs de réponse

Champ Type Description
results[].title string Titre de la collection
results[].url string URL de la collection sur la boutique
results[].description string Description
results[].products_count number Nombre de produits
results[].image object ou null Image quand la boutique en envoie une
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. Quand la page contient exactement limit collections, next pointe vers page + 1. Sinon next est null.

Cas d'usageLink to Cas d'usage

  • Lister les collections d'une boutique avant d'ouvrir chacune
  • Suivre les titres et le nombre de produits
  • Suivre pagination.next jusqu'à la fin

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 aucune collection
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