shopify-rate-limits

Featured

Handle Shopify API rate limits for both REST (leaky bucket) and GraphQL (calculated query cost). Use when hitting 429 errors, implementing retry logic, or optimizing API request throughput. Trigger with phrases like "shopify rate limit", "shopify throttling", "shopify 429", "shopify THROTTLED", "shopify query cost", "shopify backoff".

AI & Automation 2,926 stars 433 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 99/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Shopify Rate Limits ## Overview Shopify uses two distinct rate limiting systems: leaky bucket for REST and calculated query cost for GraphQL. This skill covers both with real header values and response shapes. ## Prerequisites - Understanding of Shopify's REST and GraphQL Admin APIs - Familiarity with the `@shopify/shopify-api` library ## Instructions ### Step 1: Understand the Two Rate Limit Systems **REST Admin API** — Leaky Bucket: | Plan | Bucket Size | Leak Rate | |------|------------|-----------| | Standard | 40 requests | 2/second | | Shopify Plus | 80 requests | 4/second | The `X-Shopify-Shop-Api-Call-Limit` header shows your bucket state: ``` X-Shopify-Shop-Api-Call-Limit: 32/40 ``` Means: 32 of 40 slots used. When full, you get HTTP 429 with `Retry-After` header. **GraphQL Admin API** — Calculated Query Cost: | Plan | Max Available | Restore Rate | |------|--------------|-------------| | Standard | 1,000 points | 50 points/second | | Shopify Plus | 2,000 points | 100 points/second | Every GraphQL response includes cost info in `extensions`: ```json { "extensions": { "cost": { "requestedQueryCost": 252, "actualQueryCost": 12, "throttleStatus": { "maximumAvailable": 1000.0, "currentlyAvailable": 988.0, "restoreRate": 50.0 } } } } ``` Key insight: `requestedQueryCost` is the *worst case* estimate. `actualQueryCost` is the real cost (often much lower). When `currentlyAvailable` drops to 0, you...

Details

Author
jeremylongshore
Repository
jeremylongshore/claude-code-plugins-plus-skills
Created
1 years ago
Last Updated
yesterday
Language
Python
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category