API version: unstable
API version: 2021-07 Release candidate
API version: 2021-04 Latest
API version: 2021-01
API version: 2020-10
API version: 2020-07
API version: 2020-04 Unsupported
API version: 2020-01 Unsupported

Product

Version 2019-10

The Product resource lets you update and create products in a merchant's store. You can use product variants with the Product resource to create or update different versions of the same product. You can also add or update product images.

You can add products to collections with the CustomCollection resource and the SmartCollection resource.

What you can do with Product

The Shopify API lets you do the following with the Product resource. More detailed versions of these general actions may be available:

Product properties

body_html 
"body_html": "It's the small iPod with a big idea: Video."

A description of the product. Supports HTML formatting.
created_at
read-only 
"created_at": "2012-02-15T15:12:21-05:00"

The date and time (ISO 8601 format) when the product was created.

handle 
"handle": "ipod-nano"

A unique human-friendly string for the product. Automatically generated from the product's title. Used by the Liquid templating language to refer to objects.

id
read-only 
"id": 632910392

An unsigned 64-bit integer that's used as a unique identifier for the product. Each id is unique across the Shopify system. No two products will have the same id, even if they're from different shops.

images 
"images": [
  {
    "id": 850703190,
    "product_id": 632910392,
    "position": 1,
    "created_at": "2018-01-08T12:34:47-05:00",
    "updated_at": "2018-01-08T12:34:47-05:00",
    "width": 110,
    "height": 140,
    "src": "http://example.com/burton.jpg",
    "variant_ids": [
      {}
    ]
  }
]

A list of product image objects, each one representing an image associated with the product.

options 
"options": [
  {
    "name": "Title"
  }
]

The custom product property names like Size, Color, and Material. You can add up to 3 options of up to 255 characters each.

product_type 
"product_type": "Cult Products"

A categorization for the product used for filtering and searching products.

published_at 
"published_at": "2007-12-31T19:00:00-05:00"

The date and time (ISO 8601 format) when the product was published. Can be set to null to unpublish the product from the Online Store channel.

published_scope 
"published_scope": "global"

Whether the product is published to the Point of Sale channel. Valid values:

  • web: The product is published to the Online Store channel but not published to the Point of Sale channel.
  • global: The product is published to both the Online Store channel and the Point of Sale channel.
tags 
"tags": "Emotive, Flash Memory, MP3, Music"

A string of comma-separated tags that are used for filtering and search. A product can have up to 250 tags. Each tag can have up to 255 characters.

template_suffix 
"template_suffix": "special"

The suffix of the Liquid template used for the product page. If this property is specified, then the product page uses a template called "product.suffix.liquid", where "suffix" is the value of this property. If this property is "" or null, then the product page uses the default template "product.liquid". (default: null)

title
required 
"title": "IPod Nano - 8GB"

The name of the product.

updated_at
read-only 
"updated_at": "2012-08-24T14:01:47-04:00"

The date and time (ISO 8601 format) when the product was last modified. A product's updated_at value can change for different reasons. For example, if an order is placed for a product that has inventory tracking set up, then the inventory adjustment is counted as an update.

variants 
"variants": [
  {
    "barcode": "1234_pink",
    "compare_at_price": null,
    "created_at": "2012-08-24T14:01:47-04:00",
    "fulfillment_service": "manual",
    "grams": 567,
    "weight": 0.2,
    "weight_unit": "kg",
    "id": 808950810,
    "inventory_item_id": 341629,
    "inventory_management": "shopify",
    "inventory_policy": "continue",
    "inventory_quantity": 10,
    "option1": "Pink",
    "position": 1,
    "price": 199.99,
    "presentment_prices": [
      {
        "price": {
          "currency_code": "USD",
          "amount": "199.99"
        },
        "compare_at_price": null
      },
      {
        "price": {
          "currency_code": "EUR",
          "amount": "158.95"
        },
        "compare_at_price": null
      },
      {
        "price": {
          "currency_code": "GBP",
          "amount": "143.00"
        },
        "compare_at_price": null
      },
      {
        "price": {
          "currency_code": "JPY",
          "amount": "22400"
        },
        "compare_at_price": null
      }
    ],
    "product_id": 632910392,
    "requires_shipping": true,
    "sku": "IPOD2008PINK",
    "taxable": true,
    "title": "Pink",
    "updated_at": "2012-08-24T14:01:47-04:00"
  }
]

A list of product variants, each representing a different version of the product.

The position property is read-only. The position of variants is indicated by the order in which they are listed.

To retrieve the presentment_prices property on a variant, include the request header 'X-Shopify-Api-Features': 'include-presentment-prices'.
vendor 
"vendor": "Apple"

The name of the product's vendor.

Endpoints

GET /admin/api/2019-10/products.json
Retrieves a list of products. Note: As of version 2019-07, this endpoint implements pagination by using links that are provided in the response header. Sending the page parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints.
ids

Return only products specified by a comma-separated list of product IDs.
limit

Return up to this many results per page.

(default: 50, maximum: 250)
since_id

Return only products after the specified ID.
title

Return products by product title.
vendor

Return products by product title.
handle

Return only products specified by a comma-separated list of product handles.
product_type

Return products by product type.
status

Return only products specified by a comma-separated list of statuses.

(default: any)
  • active: Return only active products.
  • archived: Return only archived products.
  • draft: Return only draft products.
collection_id

Return products by product collection ID.
created_at_min

Return products created after a specified date. (format: 2014-04-25T16:15:47-04:00)
created_at_max

Return products created before a specified date. (format: 2014-04-25T16:15:47-04:00)
updated_at_min

Return products last updated after a specified date. (format: 2014-04-25T16:15:47-04:00)
updated_at_max

Return products last updated before a specified date. (format: 2014-04-25T16:15:47-04:00)
published_at_min

Return products published after a specified date. (format: 2014-04-25T16:15:47-04:00)
published_at_max

Return products published before a specified date. (format: 2014-04-25T16:15:47-04:00)
published_status

Return products by their published status

(default: any)
  • published: Return only published products.
  • unpublished: Return only unpublished products.
  • any: Return all products.
fields

Return only certain fields specified by a comma-separated list of field names.
presentment_currencies

Return presentment prices in only certain currencies, specified by a comma-separated list of ISO 4217 currency codes.

Retrieve all products

GET /admin/api/2019-10/products.json
View Response 
HTTP/1.1 200 OK
{
  "products": [
    {
      "id": 632910392,
      "title": "IPod Nano - 8GB",
      "body_html": "<p>It's the small iPod with one very big idea: Video. Now the world's most popular music player, available in 4GB and 8GB models, lets you enjoy TV shows, movies, video podcasts, and more. The larger, brighter display means amazing picture quality. In six eye-catching colors, iPod nano is stunning all around. And with models starting at just $149, little speaks volumes.</p>",
      "vendor": "Apple",
      "product_type": "Cult Products",
      "created_at": "2021-04-01T15:07:27-04:00",
      "handle": "ipod-nano",
      "updated_at": "2021-04-01T15:07:27-04:00",
      "published_at": "2007-12-31T19:00:00-05:00",
      "template_suffix": null,
      "published_scope": "web",
      "tags": "Emotive, Flash Memory, MP3, Music",
      "admin_graphql_api_id": "gid://shopify/Product/632910392",
      "variants": [
        {
          "id": 808950810,
          "product_id": 632910392,
          "title": "Pink",
          "price": "199.00",
          "sku": "IPOD2008PINK",
          "position": 1,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Pink",
          "option2": null,
          "option3": null,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "taxable": true,
          "barcode": "1234_pink",
          "grams": 567,
          "image_id": 562641783,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 808950810,
          "inventory_quantity": 10,
          "old_inventory_quantity": 10,
          "presentment_prices": [
            {
              "price": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "compare_at_price": null
            }
          ],
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810"
        },
        {
          "id": 49148385,
          "product_id": 632910392,
          "title": "Red",
          "price": "199.00",
          "sku": "IPOD2008RED",
          "position": 2,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Red",
          "option2": null,
          "option3": null,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "taxable": true,
          "barcode": "1234_red",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 49148385,
          "inventory_quantity": 20,
          "old_inventory_quantity": 20,
          "presentment_prices": [
            {
              "price": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "compare_at_price": null
            }
          ],
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/49148385"
        },
        {
          "id": 39072856,
          "product_id": 632910392,
          "title": "Green",
          "price": "199.00",
          "sku": "IPOD2008GREEN",
          "position": 3,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Green",
          "option2": null,
          "option3": null,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "taxable": true,
          "barcode": "1234_green",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 39072856,
          "inventory_quantity": 30,
          "old_inventory_quantity": 30,
          "presentment_prices": [
            {
              "price": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "compare_at_price": null
            }
          ],
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/39072856"
        },
        {
          "id": 457924702,
          "product_id": 632910392,
          "title": "Black",
          "price": "199.00",
          "sku": "IPOD2008BLACK",
          "position": 4,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Black",
          "option2": null,
          "option3": null,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "taxable": true,
          "barcode": "1234_black",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 457924702,
          "inventory_quantity": 40,
          "old_inventory_quantity": 40,
          "presentment_prices": [
            {
              "price": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "compare_at_price": null
            }
          ],
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/457924702"
        }
      ],
      "options": [
        {
          "id": 594680422,
          "product_id": 632910392,
          "name": "Color",
          "position": 1,
          "values": [
            "Pink",
            "Red",
            "Green",
            "Black"
          ]
        }
      ],
      "images": [
        {
          "id": 850703190,
          "product_id": 632910392,
          "position": 1,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "alt": null,
          "width": 123,
          "height": 456,
          "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1617304047",
          "variant_ids": [],
          "admin_graphql_api_id": "gid://shopify/ProductImage/850703190"
        },
        {
          "id": 562641783,
          "product_id": 632910392,
          "position": 2,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "alt": null,
          "width": 123,
          "height": 456,
          "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano-2.png?v=1617304047",
          "variant_ids": [
            808950810
          ],
          "admin_graphql_api_id": "gid://shopify/ProductImage/562641783"
        }
      ],
      "image": {
        "id": 850703190,
        "product_id": 632910392,
        "position": 1,
        "created_at": "2021-04-01T15:07:27-04:00",
        "updated_at": "2021-04-01T15:07:27-04:00",
        "alt": null,
        "width": 123,
        "height": 456,
        "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1617304047",
        "variant_ids": [],
        "admin_graphql_api_id": "gid://shopify/ProductImage/850703190"
      }
    },
    {
      "id": 921728736,
      "title": "IPod Touch 8GB",
      "body_html": "<p>The iPod Touch has the iPhone's multi-touch interface, with a physical home button off the touch screen. The home screen has a list of buttons for the available applications.</p>",
      "vendor": "Apple",
      "product_type": "Cult Products",
      "created_at": "2021-04-01T15:07:27-04:00",
      "handle": "ipod-touch",
      "updated_at": "2021-04-01T15:07:27-04:00",
      "published_at": "2008-09-25T20:00:00-04:00",
      "template_suffix": null,
      "published_scope": "web",
      "tags": "",
      "admin_graphql_api_id": "gid://shopify/Product/921728736",
      "variants": [
        {
          "id": 447654529,
          "product_id": 921728736,
          "title": "Black",
          "price": "199.00",
          "sku": "IPOD2009BLACK",
          "position": 1,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "shipwire-app",
          "inventory_management": "shipwire-app",
          "option1": "Black",
          "option2": null,
          "option3": null,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "taxable": true,
          "barcode": "1234_black",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 447654529,
          "inventory_quantity": 13,
          "old_inventory_quantity": 13,
          "presentment_prices": [
            {
              "price": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "compare_at_price": null
            }
          ],
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/447654529"
        }
      ],
      "options": [
        {
          "id": 891236591,
          "product_id": 921728736,
          "name": "Title",
          "position": 1,
          "values": [
            "Black"
          ]
        }
      ],
      "images": [],
      "image": null
    }
  ]
}

Retrieve a list of specific products.

GET /admin/api/2019-10/products.json?ids=632910392,921728736
View Response 
HTTP/1.1 200 OK
{
  "products": [
    {
      "id": 632910392,
      "title": "IPod Nano - 8GB",
      "body_html": "<p>It's the small iPod with one very big idea: Video. Now the world's most popular music player, available in 4GB and 8GB models, lets you enjoy TV shows, movies, video podcasts, and more. The larger, brighter display means amazing picture quality. In six eye-catching colors, iPod nano is stunning all around. And with models starting at just $149, little speaks volumes.</p>",
      "vendor": "Apple",
      "product_type": "Cult Products",
      "created_at": "2021-04-01T15:07:27-04:00",
      "handle": "ipod-nano",
      "updated_at": "2021-04-01T15:07:27-04:00",
      "published_at": "2007-12-31T19:00:00-05:00",
      "template_suffix": null,
      "published_scope": "web",
      "tags": "Emotive, Flash Memory, MP3, Music",
      "admin_graphql_api_id": "gid://shopify/Product/632910392",
      "variants": [
        {
          "id": 808950810,
          "product_id": 632910392,
          "title": "Pink",
          "price": "199.00",
          "sku": "IPOD2008PINK",
          "position": 1,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Pink",
          "option2": null,
          "option3": null,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "taxable": true,
          "barcode": "1234_pink",
          "grams": 567,
          "image_id": 562641783,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 808950810,
          "inventory_quantity": 10,
          "old_inventory_quantity": 10,
          "presentment_prices": [
            {
              "price": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "compare_at_price": null
            }
          ],
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810"
        },
        {
          "id": 49148385,
          "product_id": 632910392,
          "title": "Red",
          "price": "199.00",
          "sku": "IPOD2008RED",
          "position": 2,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Red",
          "option2": null,
          "option3": null,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "taxable": true,
          "barcode": "1234_red",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 49148385,
          "inventory_quantity": 20,
          "old_inventory_quantity": 20,
          "presentment_prices": [
            {
              "price": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "compare_at_price": null
            }
          ],
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/49148385"
        },
        {
          "id": 39072856,
          "product_id": 632910392,
          "title": "Green",
          "price": "199.00",
          "sku": "IPOD2008GREEN",
          "position": 3,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Green",
          "option2": null,
          "option3": null,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "taxable": true,
          "barcode": "1234_green",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 39072856,
          "inventory_quantity": 30,
          "old_inventory_quantity": 30,
          "presentment_prices": [
            {
              "price": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "compare_at_price": null
            }
          ],
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/39072856"
        },
        {
          "id": 457924702,
          "product_id": 632910392,
          "title": "Black",
          "price": "199.00",
          "sku": "IPOD2008BLACK",
          "position": 4,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Black",
          "option2": null,
          "option3": null,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "taxable": true,
          "barcode": "1234_black",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 457924702,
          "inventory_quantity": 40,
          "old_inventory_quantity": 40,
          "presentment_prices": [
            {
              "price": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "compare_at_price": null
            }
          ],
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/457924702"
        }
      ],
      "options": [
        {
          "id": 594680422,
          "product_id": 632910392,
          "name": "Color",
          "position": 1,
          "values": [
            "Pink",
            "Red",
            "Green",
            "Black"
          ]
        }
      ],
      "images": [
        {
          "id": 850703190,
          "product_id": 632910392,
          "position": 1,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "alt": null,
          "width": 123,
          "height": 456,
          "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1617304047",
          "variant_ids": [],
          "admin_graphql_api_id": "gid://shopify/ProductImage/850703190"
        },
        {
          "id": 562641783,
          "product_id": 632910392,
          "position": 2,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "alt": null,
          "width": 123,
          "height": 456,
          "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano-2.png?v=1617304047",
          "variant_ids": [
            808950810
          ],
          "admin_graphql_api_id": "gid://shopify/ProductImage/562641783"
        }
      ],
      "image": {
        "id": 850703190,
        "product_id": 632910392,
        "position": 1,
        "created_at": "2021-04-01T15:07:27-04:00",
        "updated_at": "2021-04-01T15:07:27-04:00",
        "alt": null,
        "width": 123,
        "height": 456,
        "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1617304047",
        "variant_ids": [],
        "admin_graphql_api_id": "gid://shopify/ProductImage/850703190"
      }
    },
    {
      "id": 921728736,
      "title": "IPod Touch 8GB",
      "body_html": "<p>The iPod Touch has the iPhone's multi-touch interface, with a physical home button off the touch screen. The home screen has a list of buttons for the available applications.</p>",
      "vendor": "Apple",
      "product_type": "Cult Products",
      "created_at": "2021-04-01T15:07:27-04:00",
      "handle": "ipod-touch",
      "updated_at": "2021-04-01T15:07:27-04:00",
      "published_at": "2008-09-25T20:00:00-04:00",
      "template_suffix": null,
      "published_scope": "web",
      "tags": "",
      "admin_graphql_api_id": "gid://shopify/Product/921728736",
      "variants": [
        {
          "id": 447654529,
          "product_id": 921728736,
          "title": "Black",
          "price": "199.00",
          "sku": "IPOD2009BLACK",
          "position": 1,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "shipwire-app",
          "inventory_management": "shipwire-app",
          "option1": "Black",
          "option2": null,
          "option3": null,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "taxable": true,
          "barcode": "1234_black",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 447654529,
          "inventory_quantity": 13,
          "old_inventory_quantity": 13,
          "presentment_prices": [
            {
              "price": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "compare_at_price": null
            }
          ],
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/447654529"
        }
      ],
      "options": [
        {
          "id": 891236591,
          "product_id": 921728736,
          "name": "Title",
          "position": 1,
          "values": [
            "Black"
          ]
        }
      ],
      "images": [],
      "image": null
    }
  ]
}

Retrieve all products, showing only some attributes

GET /admin/api/2019-10/products.json?fields=id,images,title
View Response 
HTTP/1.1 200 OK
{
  "products": [
    {
      "id": 632910392,
      "title": "IPod Nano - 8GB",
      "images": [
        {
          "id": 850703190,
          "product_id": 632910392,
          "position": 1,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "alt": null,
          "width": 123,
          "height": 456,
          "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1617304047",
          "variant_ids": [],
          "admin_graphql_api_id": "gid://shopify/ProductImage/850703190"
        },
        {
          "id": 562641783,
          "product_id": 632910392,
          "position": 2,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "alt": null,
          "width": 123,
          "height": 456,
          "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano-2.png?v=1617304047",
          "variant_ids": [
            808950810
          ],
          "admin_graphql_api_id": "gid://shopify/ProductImage/562641783"
        }
      ]
    },
    {
      "id": 921728736,
      "title": "IPod Touch 8GB",
      "images": []
    }
  ]
}

Retrieve all products that belong to a certain collection

GET /admin/api/2019-10/products.json?collection_id=841564295
View Response 
HTTP/1.1 200 OK
{
  "products": [
    {
      "id": 632910392,
      "title": "IPod Nano - 8GB",
      "body_html": "<p>It's the small iPod with one very big idea: Video. Now the world's most popular music player, available in 4GB and 8GB models, lets you enjoy TV shows, movies, video podcasts, and more. The larger, brighter display means amazing picture quality. In six eye-catching colors, iPod nano is stunning all around. And with models starting at just $149, little speaks volumes.</p>",
      "vendor": "Apple",
      "product_type": "Cult Products",
      "created_at": "2021-04-01T15:07:27-04:00",
      "handle": "ipod-nano",
      "updated_at": "2021-04-01T15:07:27-04:00",
      "published_at": "2007-12-31T19:00:00-05:00",
      "template_suffix": null,
      "published_scope": "web",
      "tags": "Emotive, Flash Memory, MP3, Music",
      "admin_graphql_api_id": "gid://shopify/Product/632910392",
      "variants": [
        {
          "id": 808950810,
          "product_id": 632910392,
          "title": "Pink",
          "price": "199.00",
          "sku": "IPOD2008PINK",
          "position": 1,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Pink",
          "option2": null,
          "option3": null,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "taxable": true,
          "barcode": "1234_pink",
          "grams": 567,
          "image_id": 562641783,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 808950810,
          "inventory_quantity": 10,
          "old_inventory_quantity": 10,
          "presentment_prices": [
            {
              "price": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "compare_at_price": null
            }
          ],
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810"
        },
        {
          "id": 49148385,
          "product_id": 632910392,
          "title": "Red",
          "price": "199.00",
          "sku": "IPOD2008RED",
          "position": 2,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Red",
          "option2": null,
          "option3": null,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "taxable": true,
          "barcode": "1234_red",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 49148385,
          "inventory_quantity": 20,
          "old_inventory_quantity": 20,
          "presentment_prices": [
            {
              "price": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "compare_at_price": null
            }
          ],
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/49148385"
        },
        {
          "id": 39072856,
          "product_id": 632910392,
          "title": "Green",
          "price": "199.00",
          "sku": "IPOD2008GREEN",
          "position": 3,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Green",
          "option2": null,
          "option3": null,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "taxable": true,
          "barcode": "1234_green",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 39072856,
          "inventory_quantity": 30,
          "old_inventory_quantity": 30,
          "presentment_prices": [
            {
              "price": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "compare_at_price": null
            }
          ],
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/39072856"
        },
        {
          "id": 457924702,
          "product_id": 632910392,
          "title": "Black",
          "price": "199.00",
          "sku": "IPOD2008BLACK",
          "position": 4,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Black",
          "option2": null,
          "option3": null,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "taxable": true,
          "barcode": "1234_black",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 457924702,
          "inventory_quantity": 40,
          "old_inventory_quantity": 40,
          "presentment_prices": [
            {
              "price": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "compare_at_price": null
            }
          ],
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/457924702"
        }
      ],
      "options": [
        {
          "id": 594680422,
          "product_id": 632910392,
          "name": "Color",
          "position": 1,
          "values": [
            "Pink",
            "Red",
            "Green",
            "Black"
          ]
        }
      ],
      "images": [
        {
          "id": 850703190,
          "product_id": 632910392,
          "position": 1,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "alt": null,
          "width": 123,
          "height": 456,
          "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1617304047",
          "variant_ids": [],
          "admin_graphql_api_id": "gid://shopify/ProductImage/850703190"
        },
        {
          "id": 562641783,
          "product_id": 632910392,
          "position": 2,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "alt": null,
          "width": 123,
          "height": 456,
          "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano-2.png?v=1617304047",
          "variant_ids": [
            808950810
          ],
          "admin_graphql_api_id": "gid://shopify/ProductImage/562641783"
        }
      ],
      "image": {
        "id": 850703190,
        "product_id": 632910392,
        "position": 1,
        "created_at": "2021-04-01T15:07:27-04:00",
        "updated_at": "2021-04-01T15:07:27-04:00",
        "alt": null,
        "width": 123,
        "height": 456,
        "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1617304047",
        "variant_ids": [],
        "admin_graphql_api_id": "gid://shopify/ProductImage/850703190"
      }
    }
  ]
}

Retrieve all products after the specified ID

GET /admin/api/2019-10/products.json?since_id=632910392
View Response 
HTTP/1.1 200 OK
{
  "products": [
    {
      "id": 921728736,
      "title": "IPod Touch 8GB",
      "body_html": "<p>The iPod Touch has the iPhone's multi-touch interface, with a physical home button off the touch screen. The home screen has a list of buttons for the available applications.</p>",
      "vendor": "Apple",
      "product_type": "Cult Products",
      "created_at": "2021-04-01T15:07:27-04:00",
      "handle": "ipod-touch",
      "updated_at": "2021-04-01T15:07:27-04:00",
      "published_at": "2008-09-25T20:00:00-04:00",
      "template_suffix": null,
      "published_scope": "web",
      "tags": "",
      "admin_graphql_api_id": "gid://shopify/Product/921728736",
      "variants": [
        {
          "id": 447654529,
          "product_id": 921728736,
          "title": "Black",
          "price": "199.00",
          "sku": "IPOD2009BLACK",
          "position": 1,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "shipwire-app",
          "inventory_management": "shipwire-app",
          "option1": "Black",
          "option2": null,
          "option3": null,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "taxable": true,
          "barcode": "1234_black",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 447654529,
          "inventory_quantity": 13,
          "old_inventory_quantity": 13,
          "presentment_prices": [
            {
              "price": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "compare_at_price": null
            }
          ],
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/447654529"
        }
      ],
      "options": [
        {
          "id": 891236591,
          "product_id": 921728736,
          "name": "Title",
          "position": 1,
          "values": [
            "Black"
          ]
        }
      ],
      "images": [],
      "image": null
    }
  ]
}

Retrieve all products with prices in selected presentment currencies

GET /admin/api/2019-10/products.json?presentment_currencies=USD
View Response 
HTTP/1.1 200 OK
{
  "products": [
    {
      "id": 632910392,
      "title": "IPod Nano - 8GB",
      "body_html": "<p>It's the small iPod with one very big idea: Video. Now the world's most popular music player, available in 4GB and 8GB models, lets you enjoy TV shows, movies, video podcasts, and more. The larger, brighter display means amazing picture quality. In six eye-catching colors, iPod nano is stunning all around. And with models starting at just $149, little speaks volumes.</p>",
      "vendor": "Apple",
      "product_type": "Cult Products",
      "created_at": "2021-04-01T15:07:27-04:00",
      "handle": "ipod-nano",
      "updated_at": "2021-04-01T15:07:27-04:00",
      "published_at": "2007-12-31T19:00:00-05:00",
      "template_suffix": null,
      "published_scope": "web",
      "tags": "Emotive, Flash Memory, MP3, Music",
      "admin_graphql_api_id": "gid://shopify/Product/632910392",
      "variants": [
        {
          "id": 808950810,
          "product_id": 632910392,
          "title": "Pink",
          "price": "199.00",
          "sku": "IPOD2008PINK",
          "position": 1,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Pink",
          "option2": null,
          "option3": null,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "taxable": true,
          "barcode": "1234_pink",
          "grams": 567,
          "image_id": 562641783,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 808950810,
          "inventory_quantity": 10,
          "old_inventory_quantity": 10,
          "presentment_prices": [
            {
              "price": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "compare_at_price": null
            }
          ],
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810"
        },
        {
          "id": 49148385,
          "product_id": 632910392,
          "title": "Red",
          "price": "199.00",
          "sku": "IPOD2008RED",
          "position": 2,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Red",
          "option2": null,
          "option3": null,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "taxable": true,
          "barcode": "1234_red",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 49148385,
          "inventory_quantity": 20,
          "old_inventory_quantity": 20,
          "presentment_prices": [
            {
              "price": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "compare_at_price": null
            }
          ],
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/49148385"
        },
        {
          "id": 39072856,
          "product_id": 632910392,
          "title": "Green",
          "price": "199.00",
          "sku": "IPOD2008GREEN",
          "position": 3,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Green",
          "option2": null,
          "option3": null,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "taxable": true,
          "barcode": "1234_green",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 39072856,
          "inventory_quantity": 30,
          "old_inventory_quantity": 30,
          "presentment_prices": [
            {
              "price": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "compare_at_price": null
            }
          ],
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/39072856"
        },
        {
          "id": 457924702,
          "product_id": 632910392,
          "title": "Black",
          "price": "199.00",
          "sku": "IPOD2008BLACK",
          "position": 4,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "manual",
          "inventory_management": "shopify",
          "option1": "Black",
          "option2": null,
          "option3": null,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "taxable": true,
          "barcode": "1234_black",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 457924702,
          "inventory_quantity": 40,
          "old_inventory_quantity": 40,
          "presentment_prices": [
            {
              "price": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "compare_at_price": null
            }
          ],
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/457924702"
        }
      ],
      "options": [
        {
          "id": 594680422,
          "product_id": 632910392,
          "name": "Color",
          "position": 1,
          "values": [
            "Pink",
            "Red",
            "Green",
            "Black"
          ]
        }
      ],
      "images": [
        {
          "id": 850703190,
          "product_id": 632910392,
          "position": 1,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "alt": null,
          "width": 123,
          "height": 456,
          "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1617304047",
          "variant_ids": [],
          "admin_graphql_api_id": "gid://shopify/ProductImage/850703190"
        },
        {
          "id": 562641783,
          "product_id": 632910392,
          "position": 2,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "alt": null,
          "width": 123,
          "height": 456,
          "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano-2.png?v=1617304047",
          "variant_ids": [
            808950810
          ],
          "admin_graphql_api_id": "gid://shopify/ProductImage/562641783"
        }
      ],
      "image": {
        "id": 850703190,
        "product_id": 632910392,
        "position": 1,
        "created_at": "2021-04-01T15:07:27-04:00",
        "updated_at": "2021-04-01T15:07:27-04:00",
        "alt": null,
        "width": 123,
        "height": 456,
        "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1617304047",
        "variant_ids": [],
        "admin_graphql_api_id": "gid://shopify/ProductImage/850703190"
      }
    },
    {
      "id": 921728736,
      "title": "IPod Touch 8GB",
      "body_html": "<p>The iPod Touch has the iPhone's multi-touch interface, with a physical home button off the touch screen. The home screen has a list of buttons for the available applications.</p>",
      "vendor": "Apple",
      "product_type": "Cult Products",
      "created_at": "2021-04-01T15:07:27-04:00",
      "handle": "ipod-touch",
      "updated_at": "2021-04-01T15:07:27-04:00",
      "published_at": "2008-09-25T20:00:00-04:00",
      "template_suffix": null,
      "published_scope": "web",
      "tags": "",
      "admin_graphql_api_id": "gid://shopify/Product/921728736",
      "variants": [
        {
          "id": 447654529,
          "product_id": 921728736,
          "title": "Black",
          "price": "199.00",
          "sku": "IPOD2009BLACK",
          "position": 1,
          "inventory_policy": "continue",
          "compare_at_price": null,
          "fulfillment_service": "shipwire-app",
          "inventory_management": "shipwire-app",
          "option1": "Black",
          "option2": null,
          "option3": null,
          "created_at": "2021-04-01T15:07:27-04:00",
          "updated_at": "2021-04-01T15:07:27-04:00",
          "taxable": true,
          "barcode": "1234_black",
          "grams": 567,
          "image_id": null,
          "weight": 1.25,
          "weight_unit": "lb",
          "inventory_item_id": 447654529,
          "inventory_quantity": 13,
          "old_inventory_quantity": 13,
          "presentment_prices": [
            {
              "price": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "compare_at_price": null
            }
          ],
          "requires_shipping": true,
          "admin_graphql_api_id": "gid://shopify/ProductVariant/447654529"
        }
      ],
      "options": [
        {
          "id": 891236591,
          "product_id": 921728736,
          "name": "Title",
          "position": 1,
          "values": [
            "Black"
          ]
        }
      ],
      "images": [],
      "image": null
    }
  ]
}
GET /admin/api/2019-10/products/count.json
Retrieves a count of products.
vendor

Return products by product title.
product_type

Return products by product type.
collection_id

Return products by product collection ID.
created_at_min

Return products created after a specified date. (format: 2014-04-25T16:15:47-04:00)
created_at_max

Return products created before a specified date. (format: 2014-04-25T16:15:47-04:00)
updated_at_min

Return products last updated after a specified date. (format: 2014-04-25T16:15:47-04:00)
updated_at_max

Return products last updated before a specified date. (format: 2014-04-25T16:15:47-04:00)
published_at_min

Return products published after a specified date. (format: 2014-04-25T16:15:47-04:00)
published_at_max

Return products published before a specified date. (format: 2014-04-25T16:15:47-04:00)
published_status

Return products by their published status

(default: any)
  • published: Return only published products.
  • unpublished: Return only unpublished products.
  • any: Return all products.

Retrieve a count of all products

GET /admin/api/2019-10/products/count.json
View Response 
HTTP/1.1 200 OK
{
  "count": 2
}

Retrieve a count of all products of a given collection

GET /admin/api/2019-10/products/count.json?collection_id=841564295
View Response 
HTTP/1.1 200 OK
{
  "count": 1
}
GET /admin/api/2019-10/products/{product_id}.json
Retrieves a single product.
fields

A comma-separated list of fields to include in the response.

Retrieve a single product by ID

GET /admin/api/2019-10/products/632910392.json
View Response 
HTTP/1.1 200 OK
{
  "product": {
    "id": 632910392,
    "title": "IPod Nano - 8GB",
    "body_html": "<p>It's the small iPod with one very big idea: Video. Now the world's most popular music player, available in 4GB and 8GB models, lets you enjoy TV shows, movies, video podcasts, and more. The larger, brighter display means amazing picture quality. In six eye-catching colors, iPod nano is stunning all around. And with models starting at just $149, little speaks volumes.</p>",
    "vendor": "Apple",
    "product_type": "Cult Products",
    "created_at": "2021-04-01T15:07:27-04:00",
    "handle": "ipod-nano",
    "updated_at": "2021-04-01T15:07:27-04:00",
    "published_at": "2007-12-31T19:00:00-05:00",
    "template_suffix": null,
    "status": "active",
    "published_scope": "web",
    "tags": "Emotive, Flash Memory, MP3, Music",
    "admin_graphql_api_id": "gid://shopify/Product/632910392",
    "variants": [
      {
        "id": 808950810,
        "product_id": 632910392,
        "title": "Pink",
        "price": "199.00",
        "sku": "IPOD2008PINK",
        "position": 1,
        "inventory_policy": "continue",
        "compare_at_price": null,
        "fulfillment_service": "manual",
        "inventory_management": "shopify",
        "option1": "Pink",
        "option2": null,
        "option3": null,
        "created_at": "2021-04-01T15:07:27-04:00",
        "updated_at": "2021-04-01T15:07:27-04:00",
        "taxable": true,
        "barcode": "1234_pink",
        "grams": 567,
        "image_id": 562641783,
        "weight": 1.25,
        "weight_unit": "lb",
        "inventory_item_id": 808950810,
        "inventory_quantity": 10,
        "old_inventory_quantity": 10,
        "presentment_prices": [
          {
            "price": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "compare_at_price": null
          }
        ],
        "requires_shipping": true,
        "admin_graphql_api_id": "gid://shopify/ProductVariant/808950810"
      },
      {
        "id": 49148385,
        "product_id": 632910392,
        "title": "Red",
        "price": "199.00",
        "sku": "IPOD2008RED",
        "position": 2,
        "inventory_policy": "continue",
        "compare_at_price": null,
        "fulfillment_service": "manual",
        "inventory_management": "shopify",
        "option1": "Red",
        "option2": null,
        "option3": null,
        "created_at": "2021-04-01T15:07:27-04:00",
        "updated_at": "2021-04-01T15:07:27-04:00",
        "taxable": true,
        "barcode": "1234_red",
        "grams": 567,
        "image_id": null,
        "weight": 1.25,
        "weight_unit": "lb",
        "inventory_item_id": 49148385,
        "inventory_quantity": 20,
        "old_inventory_quantity": 20,
        "presentment_prices": [
          {
            "price": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "compare_at_price": null
          }
        ],
        "requires_shipping": true,
        "admin_graphql_api_id": "gid://shopify/ProductVariant/49148385"
      },
      {
        "id": 39072856,
        "product_id": 632910392,
        "title": "Green",
        "price": "199.00",
        "sku": "IPOD2008GREEN",
        "position": 3,
        "inventory_policy": "continue",
        "compare_at_price": null,
        "fulfillment_service": "manual",
        "inventory_management": "shopify",
        "option1": "Green",
        "option2": null,
        "option3": null,
        "created_at": "2021-04-01T15:07:27-04:00",
        "updated_at": "2021-04-01T15:07:27-04:00",
        "taxable": true,
        "barcode": "1234_green",
        "grams": 567,
        "image_id": null,
        "weight": 1.25,
        "weight_unit": "lb",
        "inventory_item_id": 39072856,
        "inventory_quantity": 30,
        "old_inventory_quantity": 30,
        "presentment_prices": [
          {
            "price": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "compare_at_price": null
          }
        ],
        "requires_shipping": true,
        "admin_graphql_api_id": "gid://shopify/ProductVariant/39072856"
      },
      {
        "id": 457924702,
        "product_id": 632910392,
        "title": "Black",
        "price": "199.00",
        "sku": "IPOD2008BLACK",
        "position": 4,
        "inventory_policy": "continue",
        "compare_at_price": null,
        "fulfillment_service": "manual",
        "inventory_management": "shopify",
        "option1": "Black",
        "option2": null,
        "option3": null,
        "created_at": "2021-04-01T15:07:27-04:00",
        "updated_at": "2021-04-01T15:07:27-04:00",
        "taxable": true,
        "barcode": "1234_black",
        "grams": 567,
        "image_id": null,
        "weight": 1.25,
        "weight_unit": "lb",
        "inventory_item_id": 457924702,
        "inventory_quantity": 40,
        "old_inventory_quantity": 40,
        "presentment_prices": [
          {
            "price": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "compare_at_price": null
          }
        ],
        "requires_shipping": true,
        "admin_graphql_api_id": "gid://shopify/ProductVariant/457924702"
      }
    ],
    "options": [
      {
        "id": 594680422,
        "product_id": 632910392,
        "name": "Color",
        "position": 1,
        "values": [
          "Pink",
          "Red",
          "Green",
          "Black"
        ]
      }
    ],
    "images": [
      {
        "id": 850703190,
        "product_id": 632910392,
        "position": 1,
        "created_at": "2021-04-01T15:07:27-04:00",
        "updated_at": "2021-04-01T15:07:27-04:00",
        "alt": null,
        "width": 123,
        "height": 456,
        "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1617304047",
        "variant_ids": [],
        "admin_graphql_api_id": "gid://shopify/ProductImage/850703190"
      },
      {
        "id": 562641783,
        "product_id": 632910392,
        "position": 2,
        "created_at": "2021-04-01T15:07:27-04:00",
        "updated_at": "2021-04-01T15:07:27-04:00",
        "alt": null,
        "width": 123,
        "height": 456,
        "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano-2.png?v=1617304047",
        "variant_ids": [
          808950810
        ],
        "admin_graphql_api_id": "gid://shopify/ProductImage/562641783"
      }
    ],
    "image": {
      "id": 850703190,
      "product_id": 632910392,
      "position": 1,
      "created_at": "2021-04-01T15:07:27-04:00",
      "updated_at": "2021-04-01T15:07:27-04:00",
      "alt": null,
      "width": 123,
      "height": 456,
      "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1617304047",
      "variant_ids": [],
      "admin_graphql_api_id": "gid://shopify/ProductImage/850703190"
    }
  }
}

Retrieve only particular fields

GET /admin/api/2019-10/products/632910392.json?fields=id,images,title
View Response 
HTTP/1.1 200 OK
{
  "product": {
    "id": 632910392,
    "title": "IPod Nano - 8GB",
    "images": [
      {
        "id": 850703190,
        "product_id": 632910392,
        "position": 1,
        "created_at": "2021-04-01T15:07:27-04:00",
        "updated_at": "2021-04-01T15:07:27-04:00",
        "alt": null,
        "width": 123,
        "height": 456,
        "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano.png?v=1617304047",
        "variant_ids": [],
        "admin_graphql_api_id": "gid://shopify/ProductImage/850703190"
      },
      {
        "id": 562641783,
        "product_id": 632910392,
        "position": 2,
        "created_at": "2021-04-01T15:07:27-04:00",
        "updated_at": "2021-04-01T15:07:27-04:00",
        "alt": null,
        "width": 123,
        "height": 456,
        "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/ipod-nano-2.png?v=1617304047",
        "variant_ids": [
          808950810
        ],
        "admin_graphql_api_id": "gid://shopify/ProductImage/562641783"
      }
    ]
  }
}
POST /admin/api/2019-10/products.json

Creates a new product.


If you want to set the product's SEO information, then you can use the following properties:

  • metafields_global_title_tag: The name of the product used for SEO purposes. Generally added to the <meta name='title'> tag.
  • metafields_global_description_tag: A description of the product used for SEO purposes. Generally added to the <meta name='description'> tag.

Create a new product with the default product variant

POST /admin/api/2019-10/products.json
{
  "product": {
    "title": "Burton Custom Freestyle 151",
    "body_html": "<strong>Good snowboard!</strong>",
    "vendor": "Burton",
    "product_type": "Snowboard",
    "tags": [
      "Barnes & Noble",
      "John's Fav",
      "\Big Air\"
    ]
  }
}
View Response 
HTTP/1.1 201 Created
{
  "product": {
    "id": 1071559590,
    "title": "Burton Custom Freestyle 151",
    "body_html": "<strong>Good snowboard!</strong>",
    "vendor": "Burton",
    "product_type": "Snowboard",
    "created_at": "2021-04-01T15:27:08-04:00",
    "handle": "burton-custom-freestyle-151",
    "updated_at": "2021-04-01T15:27:09-04:00",
    "published_at": "2021-04-01T15:27:08-04:00",
    "template_suffix": null,
    "status": "active",
    "published_scope": "web",
    "tags": "\Big Air\, Barnes & Noble, John's Fav",
    "admin_graphql_api_id": "gid://shopify/Product/1071559590",
    "variants": [
      {
        "id": 1070325041,
        "product_id": 1071559590,
        "title": "Default Title",
        "price": "0.00",
        "sku": "",
        "position": 1,
        "inventory_policy": "deny",
        "compare_at_price": null,
        "fulfillment_service": "manual",
        "inventory_management": null,
        "option1": "Default Title",
        "option2": null,
        "option3": null,
        "created_at": "2021-04-01T15:27:09-04:00",
        "updated_at": "2021-04-01T15:27:09-04:00",
        "taxable": true,
        "barcode": null,
        "grams": 0,
        "image_id": null,
        "weight": 0.0,
        "weight_unit": "lb",
        "inventory_item_id": 1070325041,
        "inventory_quantity": 0,
        "old_inventory_quantity": 0,
        "presentment_prices": [
          {
            "price": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "compare_at_price": null
          }
        ],
        "requires_shipping": true,
        "admin_graphql_api_id": "gid://shopify/ProductVariant/1070325041"
      }
    ],
    "options": [
      {
        "id": 1055547212,
        "product_id": 1071559590,
        "name": "Title",
        "position": 1,
        "values": [
          "Default Title"
        ]
      }
    ],
    "images": [],
    "image": null
  }
}

Create a new unpublished product

POST /admin/api/2019-10/products.json
{
  "product": {
    "title": "Burton Custom Freestyle 151",
    "body_html": "<strong>Good snowboard!</strong>",
    "vendor": "Burton",
    "product_type": "Snowboard",
    "published": false
  }
}
View Response 
HTTP/1.1 201 Created
{
  "product": {
    "id": 1071559591,
    "title": "Burton Custom Freestyle 151",
    "body_html": "<strong>Good snowboard!</strong>",
    "vendor": "Burton",
    "product_type": "Snowboard",
    "created_at": "2021-04-01T15:27:12-04:00",
    "handle": "burton-custom-freestyle-151",
    "updated_at": "2021-04-01T15:27:13-04:00",
    "published_at": null,
    "template_suffix": null,
    "status": "active",
    "published_scope": "web",
    "tags": "",
    "admin_graphql_api_id": "gid://shopify/Product/1071559591",
    "variants": [
      {
        "id": 1070325042,
        "product_id": 1071559591,
        "title": "Default Title",
        "price": "0.00",
        "sku": "",
        "position": 1,
        "inventory_policy": "deny",
        "compare_at_price": null,
        "fulfillment_service": "manual",
        "inventory_management": null,
        "option1": "Default Title",
        "option2": null,
        "option3": null,
        "created_at": "2021-04-01T15:27:12-04:00",
        "updated_at": "2021-04-01T15:27:12-04:00",
        "taxable": true,
        "barcode": null,
        "grams": 0,
        "image_id": null,
        "weight": 0.0,
        "weight_unit": "lb",
        "inventory_item_id": 1070325042,
        "inventory_quantity": 0,
        "old_inventory_quantity": 0,
        "presentment_prices": [
          {
            "price": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "compare_at_price": null
          }
        ],
        "requires_shipping": true,
        "admin_graphql_api_id": "gid://shopify/ProductVariant/1070325042"
      }
    ],
    "options": [
      {
        "id": 1055547213,
        "product_id": 1071559591,
        "name": "Title",
        "position": 1,
        "values": [
          "Default Title"
        ]
      }
    ],
    "images": [],
    "image": null
  }
}

Create a new draft product

POST /admin/api/2019-10/products.json
{
  "product": {
    "title": "Burton Custom Freestyle 151",
    "body_html": "<strong>Good snowboard!</strong>",
    "vendor": "Burton",
    "product_type": "Snowboard",
    "shop": {
      "id": 690933842,
      "name": "Apple Computers",
      "email": "steve@apple.com",
      "domain": "apple.myshopify.com",
      "province": "California",
      "country": "US",
      "address1": "1 Infinite Loop",
      "zip": "95014",
      "city": "Cupertino",
      "source": null,
      "phone": "1231231234",
      "latitude": 45.45,
      "longitude": -75.43,
      "primary_locale": "en",
      "address2": "Suite 100",
      "created_at": "2007-12-31T19:00:00-05:00",
      "updated_at": "2021-04-01T15:07:27-04:00",
      "country_code": "US",
      "country_name": "United States",
      "currency": "USD",
      "customer_email": "steve@apple.com",
      "timezone": "(GMT-05:00) Eastern Time (US & Canada)",
      "iana_timezone": "America/New_York",
      "shop_owner": "Steve Jobs",
      "money_format": "$",
      "money_with_currency_format": "$ USD",
      "weight_unit": "lb",
      "province_code": "CA",
      "taxes_included": null,
      "auto_configure_tax_inclusivity": null,
      "tax_shipping": null,
      "county_taxes": true,
      "plan_display_name": "Shopify Plus",
      "plan_name": "enterprise",
      "has_discounts": true,
      "has_gift_cards": true,
      "myshopify_domain": "apple.myshopify.com",
      "google_apps_domain": null,
      "google_apps_login_enabled": null,
      "money_in_emails_format": "$",
      "money_with_currency_in_emails_format": "$ USD",
      "eligible_for_payments": true,
      "requires_extra_payments_agreement": false,
      "password_enabled": null,
      "has_storefront": true,
      "eligible_for_card_reader_giveaway": false,
      "finances": true,
      "primary_location_id": 905684977,
      "cookie_consent_level": "implicit",
      "visitor_tracking_consent_preference": "allow_all",
      "force_ssl": true,
      "checkout_api_supported": true,
      "multi_location_enabled": false,
      "setup_required": false,
      "pre_launch_enabled": false,
      "enabled_presentment_currencies": [
        "USD"
      ]
    },
    "status": "draft"
  }
}
View Response 
HTTP/1.1 201 Created
{
  "product": {
    "id": 1071559592,
    "title": "Burton Custom Freestyle 151",
    "body_html": "<strong>Good snowboard!</strong>",
    "vendor": "Burton",
    "product_type": "Snowboard",
    "created_at": "2021-04-01T15:27:17-04:00",
    "handle": "burton-custom-freestyle-151",
    "updated_at": "2021-04-01T15:27:17-04:00",
    "published_at": null,
    "template_suffix": null,
    "status": "draft",
    "published_scope": "web",
    "tags": "",
    "admin_graphql_api_id": "gid://shopify/Product/1071559592",
    "variants": [
      {
        "id": 1070325043,
        "product_id": 1071559592,
        "title": "Default Title",
        "price": "0.00",
        "sku": "",
        "position": 1,
        "inventory_policy": "deny",
        "compare_at_price": null,
        "fulfillment_service": "manual",
        "inventory_management": null,
        "option1": "Default Title",
        "option2": null,
        "option3": null,
        "created_at": "2021-04-01T15:27:17-04:00",
        "updated_at": "2021-04-01T15:27:17-04:00",
        "taxable": true,
        "barcode": null,
        "grams": 0,
        "image_id": null,
        "weight": 0.0,
        "weight_unit": "lb",
        "inventory_item_id": 1070325043,
        "inventory_quantity": 0,
        "old_inventory_quantity": 0,
        "presentment_prices": [
          {
            "price": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "compare_at_price": null
          }
        ],
        "requires_shipping": true,
        "admin_graphql_api_id": "gid://shopify/ProductVariant/1070325043"
      }
    ],
    "options": [
      {
        "id": 1055547214,
        "product_id": 1071559592,
        "name": "Title",
        "position": 1,
        "values": [
          "Default Title"
        ]
      }
    ],
    "images": [],
    "image": null
  }
}

Create a new product with multiple product variants

POST /admin/api/2019-10/products.json
{
  "product": {
    "title": "Burton Custom Freestyle 151",
    "body_html": "<strong>Good snowboard!</strong>",
    "vendor": "Burton",
    "product_type": "Snowboard",
    "variants": [
      {
        "option1": "First",
        "price": "10.00",
        "sku": "123"
      },
      {
        "option1": "Second",
        "price": "20.00",
        "sku": "123"
      }
    ]
  }
}
View Response 
HTTP/1.1 201 Created
{
  "product": {
    "id": 1071559593,
    "title": "Burton Custom Freestyle 151",
    "body_html": "<strong>Good snowboard!</strong>",
    "vendor": "Burton",
    "product_type": "Snowboard",
    "created_at": "2021-04-01T15:27:19-04:00",
    "handle": "burton-custom-freestyle-151",
    "updated_at": "2021-04-01T15:27:20-04:00",
    "published_at": "2021-04-01T15:27:19-04:00",
    "template_suffix": null,
    "status": "active",
    "published_scope": "web",
    "tags": "",
    "admin_graphql_api_id": "gid://shopify/Product/1071559593",
    "variants": [
      {
        "id": 1070325044,
        "product_id": 1071559593,
        "title": "First",
        "price": "10.00",
        "sku": "123",
        "position": 1,
        "inventory_policy": "deny",
        "compare_at_price": null,
        "fulfillment_service": "manual",
        "inventory_management": null,
        "option1": "First",
        "option2": null,
        "option3": null,
        "created_at": "2021-04-01T15:27:20-04:00",
        "updated_at": "2021-04-01T15:27:20-04:00",
        "taxable": true,
        "barcode": null,
        "grams": 0,
        "image_id": null,
        "weight": 0.0,
        "weight_unit": "lb",
        "inventory_item_id": 1070325044,
        "inventory_quantity": 0,
        "old_inventory_quantity": 0,
        "presentment_prices": [
          {
            "price": {
              "amount": "10.00",
              "currency_code": "USD"
            },
            "compare_at_price": null
          }
        ],
        "requires_shipping": true,
        "admin_graphql_api_id": "gid://shopify/ProductVariant/1070325044"
      },
      {
        "id": 1070325045,
        "product_id": 1071559593,
        "title": "Second",
        "price": "20.00",
        "sku": "123",
        "position": 2,
        "inventory_policy": "deny",
        "compare_at_price": null,
        "fulfillment_service": "manual",
        "inventory_management": null,
        "option1": "Second",
        "option2": null,
        "option3": null,
        "created_at": "2021-04-01T15:27:20-04:00",
        "updated_at": "2021-04-01T15:27:20-04:00",
        "taxable": true,
        "barcode": null,
        "grams": 0,
        "image_id": null,
        "weight": 0.0,
        "weight_unit": "lb",
        "inventory_item_id": 1070325045,
        "inventory_quantity": 0,
        "old_inventory_quantity": 0,
        "presentment_prices": [
          {
            "price": {
              "amount": "20.00",
              "currency_code": "USD"
            },
            "compare_at_price": null
          }
        ],
        "requires_shipping": true,
        "admin_graphql_api_id": "gid://shopify/ProductVariant/1070325045"
      }
    ],
    "options": [
      {
        "id": 1055547215,
        "product_id": 1071559593,
        "name": "Title",
        "position": 1,
        "values": [
          "First",
          "Second"
        ]
      }
    ],
    "images": [],
    "image": null
  }
}

Create a new product with multiple product variants and multiple options

POST /admin/api/2019-10/products.json
{
  "product": {
    "title": "Burton Custom Freestyle 151",
    "body_html": "<strong>Good snowboard!</strong>",
    "vendor": "Burton",
    "product_type": "Snowboard",
    "variants": [
      {
        "option1": "Blue",
        "option2": "155"
      },
      {
        "option1": "Black",
        "option2": "159"
      }
    ],
    "options": [
      {
        "name": "Color",
        "values": [
          "Blue",
          "Black"
        ]
      },
      {
        "name": "Size",
        "values": [
          "155",
          "159"
        ]
      }
    ]
  }
}
View Response 
HTTP/1.1 201 Created
{
  "product": {
    "id": 1071559594,
    "title": "Burton Custom Freestyle 151",
    "body_html": "<strong>Good snowboard!</strong>",
    "vendor": "Burton",
    "product_type": "Snowboard",
    "created_at": "2021-04-01T15:27:23-04:00",
    "handle": "burton-custom-freestyle-151",
    "updated_at": "2021-04-01T15:27:24-04:00",
    "published_at": "2021-04-01T15:27:23-04:00",
    "template_suffix": null,
    "status": "active",
    "published_scope": "web",
    "tags": "",
    "admin_graphql_api_id": "gid://shopify/Product/1071559594",
    "variants": [
      {
        "id": 1070325046,
        "product_id": 1071559594,
        "title": "Blue / 155",
        "price": "0.00",
        "sku": "",
        "position": 1,
        "inventory_policy": "deny",
        "compare_at_price": null,
        "fulfillment_service": "manual",
        "inventory_management": null,
        "option1": "Blue",
        "option2": "155",
        "option3": null,
        "created_at": "2021-04-01T15:27:23-04:00",
        "updated_at": "2021-04-01T15:27:23-04:00",
        "taxable": true,
        "barcode": null,
        "grams": 0,
        "image_id": null,
        "weight": 0.0,
        "weight_unit": "lb",
        "inventory_item_id": 1070325046,
        "inventory_quantity": 0,
        "old_inventory_quantity": 0,
        "presentment_prices": [
          {
            "price": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "compare_at_price": null
          }
        ],
        "requires_shipping": true,
        "admin_graphql_api_id": "gid://shopify/ProductVariant/1070325046"
      },
      {
        "id": 1070325047,
        "product_id": 1071559594,
        "title": "Black / 159",
        "price": "0.00",
        "sku": "",
        "position": 2,
        "inventory_policy": "deny",
        "compare_at_price": null,
        "fulfillment_service": "manual",
        "inventory_management": null,
        "option1": "Black",
        "option2": "159",
        "option3": null,
        "created_at": "2021-04-01T15:27:24-04:00",
        "updated_at": "2021-04-01T15:27:24-04:00",
        "taxable": true,
        "barcode": null,
        "grams": 0,
        "image_id": null,
        "weight": 0.0,
        "weight_unit": "lb",
        "inventory_item_id": 1070325047,
        "inventory_quantity": 0,
        "old_inventory_quantity": 0,
        "presentment_prices": [
          {
            "price": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "compare_at_price": null
          }
        ],
        "requires_shipping": true,
        "admin_graphql_api_id": "gid://shopify/ProductVariant/1070325047"
      }
    ],
    "options": [
      {
        "id": 1055547216,
        "product_id": 1071559594,
        "name": "Color",
        "position": 1,
        "values": [
          "Blue",
          "Black"
        ]
      },
      {
        "id": 1055547217,
        "product_id": 1071559594,
        "name": "Size",
        "position": 2,
        "values": [
          "155",
          "159"
        ]
      }
    ],
    "images": [],
    "image": null
  }
}

Create a new product with the default variant and base64 encoded image

POST /admin/api/2019-10/products.json
{
  "product": {
    "title": "Burton Custom Freestyle 151",
    "body_html": "<strong>Good snowboard!</strong>",
    "vendor": "Burton",
    "product_type": "Snowboard",
    "images": [
      {
        "attachment": "R0lGODlhAQABAIAAAAAAAAAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw==\n"
      }
    ]
  }
}
View Response 
HTTP/1.1 201 Created
{
  "product": {
    "id": 1071559595,
    "title": "Burton Custom Freestyle 151",
    "body_html": "<strong>Good snowboard!</strong>",
    "vendor": "Burton",
    "product_type": "Snowboard",
    "created_at": "2021-04-01T15:27:27-04:00",
    "handle": "burton-custom-freestyle-151",
    "updated_at": "2021-04-01T15:27:28-04:00",
    "published_at": "2021-04-01T15:27:27-04:00",
    "template_suffix": null,
    "status": "active",
    "published_scope": "web",
    "tags": "",
    "admin_graphql_api_id": "gid://shopify/Product/1071559595",
    "variants": [
      {
        "id": 1070325048,
        "product_id": 1071559595,
        "title": "Default Title",
        "price": "0.00",
        "sku": "",
        "position": 1,
        "inventory_policy": "deny",
        "compare_at_price": null,
        "fulfillment_service": "manual",
        "inventory_management": null,
        "option1": "Default Title",
        "option2": null,
        "option3": null,
        "created_at": "2021-04-01T15:27:27-04:00",
        "updated_at": "2021-04-01T15:27:27-04:00",
        "taxable": true,
        "barcode": null,
        "grams": 0,
        "image_id": null,
        "weight": 0.0,
        "weight_unit": "lb",
        "inventory_item_id": 1070325048,
        "inventory_quantity": 0,
        "old_inventory_quantity": 0,
        "presentment_prices": [
          {
            "price": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "compare_at_price": null
          }
        ],
        "requires_shipping": true,
        "admin_graphql_api_id": "gid://shopify/ProductVariant/1070325048"
      }
    ],
    "options": [
      {
        "id": 1055547218,
        "product_id": 1071559595,
        "name": "Title",
        "position": 1,
        "values": [
          "Default Title"
        ]
      }
    ],
    "images": [
      {
        "id": 1001473904,
        "product_id": 1071559595,
        "position": 1,
        "created_at": "2021-04-01T15:27:27-04:00",
        "updated_at": "2021-04-01T15:27:27-04:00",
        "alt": null,
        "width": 1,
        "height": 1,
        "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/df3e567d6f16d040326c7a0ea29a4f41.gif?v=1617305247",
        "variant_ids": [],
        "admin_graphql_api_id": "gid://shopify/ProductImage/1001473904"
      }
    ],
    "image": {
      "id": 1001473904,
      "product_id": 1071559595,
      "position": 1,
      "created_at": "2021-04-01T15:27:27-04:00",
      "updated_at": "2021-04-01T15:27:27-04:00",
      "alt": null,
      "width": 1,
      "height": 1,
      "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/df3e567d6f16d040326c7a0ea29a4f41.gif?v=1617305247",
      "variant_ids": [],
      "admin_graphql_api_id": "gid://shopify/ProductImage/1001473904"
    }
  }
}

Create a new product with the default variant and a product image that will be downloaded by Shopify

POST /admin/api/2019-10/products.json
{
  "product": {
    "title": "Burton Custom Freestyle 151",
    "body_html": "<strong>Good snowboard!</strong>",
    "vendor": "Burton",
    "product_type": "Snowboard",
    "images": [
      {
        "src": "http://example.com/rails_logo.gif"
      }
    ]
  }
}
View Response 
HTTP/1.1 201 Created
{
  "product": {
    "id": 1071559596,
    "title": "Burton Custom Freestyle 151",
    "body_html": "<strong>Good snowboard!</strong>",
    "vendor": "Burton",
    "product_type": "Snowboard",
    "created_at": "2021-04-01T15:27:31-04:00",
    "handle": "burton-custom-freestyle-151",
    "updated_at": "2021-04-01T15:27:31-04:00",
    "published_at": "2021-04-01T15:27:31-04:00",
    "template_suffix": null,
    "status": "active",
    "published_scope": "web",
    "tags": "",
    "admin_graphql_api_id": "gid://shopify/Product/1071559596",
    "variants": [
      {
        "id": 1070325049,
        "product_id": 1071559596,
        "title": "Default Title",
        "price": "0.00",
        "sku": "",
        "position": 1,
        "inventory_policy": "deny",
        "compare_at_price": null,
        "fulfillment_service": "manual",
        "inventory_management": null,
        "option1": "Default Title",
        "option2": null,
        "option3": null,
        "created_at": "2021-04-01T15:27:31-04:00",
        "updated_at": "2021-04-01T15:27:31-04:00",
        "taxable": true,
        "barcode": null,
        "grams": 0,
        "image_id": null,
        "weight": 0.0,
        "weight_unit": "lb",
        "inventory_item_id": 1070325049,
        "inventory_quantity": 0,
        "old_inventory_quantity": 0,
        "presentment_prices": [
          {
            "price": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "compare_at_price": null
          }
        ],
        "requires_shipping": true,
        "admin_graphql_api_id": "gid://shopify/ProductVariant/1070325049"
      }
    ],
    "options": [
      {
        "id": 1055547219,
        "product_id": 1071559596,
        "name": "Title",
        "position": 1,
        "values": [
          "Default Title"
        ]
      }
    ],
    "images": [
      {
        "id": 1001473905,
        "product_id": 1071559596,
        "position": 1,
        "created_at": "2021-04-01T15:27:31-04:00",
        "updated_at": "2021-04-01T15:27:31-04:00",
        "alt": null,
        "width": 110,
        "height": 140,
        "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/rails_logo20210401-60010-jz07n4.gif?v=1617305251",
        "variant_ids": [],
        "admin_graphql_api_id": "gid://shopify/ProductImage/1001473905"
      }
    ],
    "image": {
      "id": 1001473905,
      "product_id": 1071559596,
      "position": 1,
      "created_at": "2021-04-01T15:27:31-04:00",
      "updated_at": "2021-04-01T15:27:31-04:00",
      "alt": null,
      "width": 110,
      "height": 140,
      "src": "https://cdn.shopify.com/s/files/1/0006/9093/3842/products/rails_logo20210401-60010-jz07n4.gif?v=1617305251",
      "variant_ids": [],
      "admin_graphql_api_id": "gid://shopify/ProductImage/1001473905"
    }
  }
}

Creating a product without a title will return an error

POST /admin/api/2019-10/products.json
{
  "product": {
    "body_html": "A mystery!"
  }
}
View Response 
HTTP/1.1 422 Unprocessable Entity
{
  "errors": {
    "title": [
      "can't be blank"
    ]
  }
}

Create a product with a metafield

POST /admin/api/2019-10/products.json
{
  "product": {
    "title": "Burton Custom Freestyle 151",
    "body_html": "<strong>Good snowboard!</strong>",
    "vendor": "Burton",
    "product_type": "Snowboard",
    "metafields": [
      {
        "key": "new",
        "value": "newvalue",
        "value_type": "string",
        "namespace": "global"
      }
    ]
  }
}
View Response 
HTTP/1.1 201 Created
{
  "product": {
    "id": 1071559597,
    "title": "Burton Custom Freestyle 151",
    "body_html": "<strong>Good snowboard!</strong>",
    "vendor": "Burton",
    "product_type": "Snowboard",
    "created_at": "2021-04-01T15:27:36-04:00",
    "handle": "burton-custom-freestyle-151",
    "updated_at": "2021-04-01T15:27:36-04:00",
    "published_at": "2021-04-01T15:27:36-04:00",
    "template_suffix": null,
    "status": "active",
    "published_scope": "web",
    "tags": "",
    "admin_graphql_api_id": "gid://shopify/Product/1071559597",
    "variants": [
      {
        "id": 1070325050,
        "product_id": 1071559597,
        "title": "Default Title",
        "price": "0.00",
        "sku": "",
        "position": 1,
        "inventory_policy": "deny",
        "compare_at_price": null,
        "fulfillment_service": "manual",
        "inventory_management": null,
        "option1": "Default Title",
        "option2": null,
        "option3": null,
        "created_at": "2021-04-01T15:27:36-04:00",
        "updated_at": "2021-04-01T15:27:36-04:00",
        "taxable": true,
        "barcode": null,
        "grams": 0,
        "image_id": null,
        "weight": 0.0,
        "weight_unit": "lb",
        "inventory_item_id": 1070325050,
        "inventory_quantity": 0,
        "old_inventory_quantity": 0,
        "presentment_prices": [
          {
            "price": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "compare_at_price": null
          }
        ],
        "requires_shipping": true,
        "admin_graphql_api_id": "gid://shopify/ProductVariant/1070325050"
      }
    ],
    "options": [
      {
        "id": 1055547220,
        "product_id": 1071559597,
        "name": "Title",
        "position": 1,
        "values": [
          "Default Title"
        ]
      }
    ],
    "images": [],
    "image": null
  }
}
PUT /admin/api/2019-10/products/{product_id}.json

Updates a product and its variants and images.


If you want to update the product's SEO information, then you can use the following properties:

  • metafields_global_title_tag: The name of the product used for SEO purposes. Generally added to the <meta name='title'> tag.
  • metafields_global_description_tag: A description of the product used for