L'API produit Shopify est passée d'une logique REST à une logique GraphQL Admin en moins de 3 ans. Pour un développeur qui reprend un projet existant ou un freelance qui audite une stack, c'est le premier endroit à regarder : la moitié des bugs catalogue viennent d'une mauvaise utilisation de l'API.
Cette page est un mémo technique concret : endpoints utiles, mutations à privilégier, quotas à connaître, pièges classiques, et comment Seegea s'appuie sur cette API pour offrir de l'édition catalogue sans faire fuir le bucket de points.
Stack Seegea \u2194 Shopify
Les 3 mutations critiques à connaître
productUpdate (update partiel sûr)
10 pointsmetafieldsSet (créer ou mettre à jour)
10 pointsownerId + namespace + key. Essentiel pour toute stratégie metafield-driven (SEO, attributs custom, structured content).bulkOperationRunMutation (async, illimité)
1 point + asyncExemple de productUpdate minimal
mutation productUpdate($input: ProductInput!) {
productUpdate(input: $input) {
product {
id
title
updatedAt
}
userErrors {
field
message
}
}
}
# variables
{
"input": {
"id": "gid://shopify/Product/1234567890",
"title": "T-shirt coton bio — édition limitée",
"descriptionHtml": "<p>...</p>",
"seo": {
"title": "T-shirt coton bio | MaMarque",
"description": "T-shirt coton bio certifié..."
}
}
}Coût : 10 points. Ne modifie ni les variantes, ni les metafields, ni les images — les envoyer dans l'input uniquement si vous voulez les mettre à jour.
Les quotas Shopify Admin GraphQL en 2026
| Plan Shopify | Bucket | Refill | Bulk ops parallèles |
|---|---|---|---|
| Shopify Standard | 1 000 points | 50 / seconde | 1 query + 1 mutation |
| Shopify Advanced | 1 000 points | 50 / seconde | 1 query + 1 mutation |
| Shopify Plus | 2 000 points | 100 / seconde | 1 query + 1 mutation |
/admin/api/2024-07/products.json restent utilisables jusqu'à la fin de leur cycle, mais plus de nouveaux champs n'y sont exposés (ex: combinedListingRole).Comment Seegea utilise l'API produit Shopify
Seegea est bâti sur Next.js 16 + Drizzle ORM + Inngest (jobs) et parle à Shopify exclusivement via la GraphQL Admin 2025-01. Concrètement :
- Synchronisation initiale :
bulkOperationRunQuerypour lire le catalogue complet en JSONL, parsing streaming dans Inngest, écriture en masse dans Supabase. - Édition inline : chaque modification dans la grille déclenche un
productUpdate+metafieldsSeten moins de 500 ms, avec versioning côté Seegea pour le rollback. - Bulk edit 500+ fiches : transforme la sélection en JSONL, lance un
bulkOperationRunMutation, polling du statut, notification utilisateur. - Respect des rate limits : lecture du
throttleStatusde chaque réponse, pause automatique sicurrentlyAvailable < 100, retry exponentiel sur 429.
Ce que Seegea vous fait gagner côté dev
Description IA en 1 clic
Optimisation images automatique
Rollback natif
productUpdate. Filet de sécurité que vous devriez coder pendant 1 semaine sinon.| Besoin | API Shopify brute | Seegea |
|---|---|---|
| Bulk update 500 prix | Scripter bulk mutation | Grille inline + 3 min |
| Meta description 1 000 fiches | OpenAI + prompt + push | 1 clic, contextualisé |
| Images 5 000 produits | Sharp/Cloudinary pipeline | Compression WebP native |
| Rollback d’un bulk edit | Snapshots à coder | Ctrl+Z natif |
| Respect rate limits | Backoff à coder | Géré côté Seegea |
| Temps total setup | 5 à 15 jours | 48 heures |
Voyez Seegea branché sur votre vraie boutique Shopify
30 min Google Meet · on montre la grille sur votre catalogue
Quand coder directement sur l'API et quand passer par Seegea ?
Règle simple : si votre besoin est purement événementiel (ex: synchro commande → ERP, notification Slack sur low stock), codez directement sur l'API Shopify ou orchestrez via n8n/Make. C'est le bon outil.
Si votre besoin est éditorial (équipes produit qui enrichissent des fiches, bulk edit, rollback, médias, IA), Seegea couvre 80 % du cahier des charges en 48 heures d'onboarding, avec une interface que l'équipe marketing peut utiliser sans vous appeler à chaque bug.
Seegea est conçu en France, entre Annecy et Chantilly, par une équipe qui a intégré l'API Shopify chez plus de 50 marchands. Si vous êtes en train d'arbitrer un build-vs-buy sur la couche d'édition catalogue, on vous donne un avis technique sans filtre en 30 minutes.