Shopify API Skill

API Selection Guide

1. Admin GraphQL API (Preferred): Use for most backend operations. It's the primary API for Shopify, offering more features and efficiency than REST.
2. Admin REST API: Use for simple resource management if GraphQL is too complex for the specific task or if dealing with legacy systems.
3. Storefront API: Use for building custom shopping experiences (headless commerce). It is unauthenticated or uses public access tokens.

Authentication

Admin API (Custom Apps)

• Header:

  X-Shopify-Access-Token: <shpat_...>

• URL:

  https://{shop}.myshopify.com/admin/api/{version}/{endpoint}

OAuth (Public Apps)

• Header:

  X-Shopify-Access-Token: <access_token>

• Flow: Requires an OAuth exchange to get the offline/online token.

1. Admin GraphQL API

Endpoint

POST https://{shop}.myshopify.com/admin/api/{version}/graphql.json

Common Patterns

Querying Products

query getProducts($first: Int!) {
  products(first: $first) {
    edges {
      node {
        id
        title
        handle
      }
      cursor
    }
    pageInfo {
      hasNextPage
    }
  }
}

Mutation (Update Product)

mutation productUpdate($input: ProductInput!) {
  productUpdate(input: $input) {
    product {
      id
      title
    }
    userErrors {
      field
      message
    }
  }
}

Pagination

pageInfo { hasNextPage }

cursor

after

2. Admin REST API

Endpoint

https://{shop}.myshopify.com/admin/api/{version}/{resource}.json

Pagination

page

page_info

GET /admin/api/2025-10/products.json?limit=50

Link: <...page_info=...>; rel="next", <...>; rel="previous"

3. Storefront API

Endpoint

POST https://{shop}.myshopify.com/api/{version}/graphql.json

Authentication

• Header:

  X-Shopify-Storefront-Access-Token: <public_token>

Example Query

query {
  shop {
    name
  }
  products(first: 5) {
    edges {
      node {
        title
        priceRange {
          minVariantPrice {
            amount
            currencyCode
          }
        }
      }
    }
  }
}

Rate Limits

• REST: 40 requests/bucket, refilled at 2/sec (Standard).
• GraphQL: Cost-based. 1000 cost points/bucket, refill rate varies (50/sec standard).

X-Shopify-Shop-Api-Call-Limit

extensions.cost

429 Too Many Requests