SEO Guide · 2026

Shopify Product Feed JSON Format: What AI Agents Actually Read

Every Shopify store exposes its full product catalog at /products.json — no authentication required. AI shopping agents, comparison tools, and catalog scanners read this endpoint directly. Understanding its structure tells you exactly what machine-readable data your store is (and isn't) publishing.

The /products.json endpoint

Shopify stores publish their product catalog at https://yourstore.com/products.json. This is a public, unauthenticated endpoint — no API keys or tokens required. It returns a JSON array of product objects, up to 250 per page:

https://yourstore.com/products.json          # first 30 products (default)
https://yourstore.com/products.json?limit=250  # up to 250 per page
https://yourstore.com/products.json?limit=250&page=2  # second page

The endpoint is not listed in robots.txt by default, meaning crawlers and AI agents can access it freely. CatalogScan reads this endpoint during the free scan to assess your catalog's machine-readable quality — before touching any Storefront API.

Top-level product object fields

Each product in the JSON array contains these fields. The "AI agent value" column explains how AI shopping agents use each one:

Variant-level fields (the most important object)

Each product has a variants array. Each variant is a purchasable SKU. AI shopping agents evaluate products at the variant level for price, availability, and identifier data:

What's missing from the default products.json

The public /products.json endpoint does not include several fields that AI agents need for high-confidence product matching. These fields require the Storefront API or Admin API to retrieve:

The GTIN coverage problem

CatalogScan's data shows that across scanned Shopify stores, the average GTIN coverage (percentage of variants with a non-null barcode) is 41%. This means more than half of all variants are invisible to AI shopping agents that rely on GTINs for deduplication and Shopping Graph inclusion. Stores that manually clean their GTIN coverage to 90%+ see an average +14 points on the CatalogScan AI readiness score.

Reading products.json: pagination and structure

The full catalog requires pagination. A Shopify store with 1,200 products requires at minimum 5 requests at 250 per page:

// Paginate through a full catalog:
// Page 1: /products.json?limit=250&page=1
// Page 2: /products.json?limit=250&page=2
// ...continue until you receive an empty products array

// Check total count first (via count endpoint):
// /products/count.json  → {"count": 1247}
// Divide by 250 and round up to get required page count

The top-level structure is a single key products containing the array:

{
  "products": [
    {
      "id": 7234567890123,
      "title": "Merino Wool Base Layer",
      "handle": "merino-wool-base-layer",
      "body_html": "<p>400gsm merino wool...</p>",
      "vendor": "Icebreaker",
      "product_type": "Base Layer",
      "tags": ["merino", "wool", "base-layer", "150gsm"],
      "variants": [
        {
          "id": 4123456789012,
          "title": "S / Blue",
          "price": "89.95",
          "sku": "ICE-ML-S-BLU",
          "barcode": "9420025582541",
          "available": true,
          "option1": "S",
          "option2": "Blue"
        }
      ],
      "images": [
        {
          "src": "https://cdn.shopify.com/.../merino-blue-s.jpg",
          "alt": "Icebreaker Merino Wool Base Layer in Blue, size S"
        }
      ]
    }
  ]
}

FAQ