> ## Documentation Index
> Fetch the complete documentation index at: https://docs-test.rye.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# productByID

> Retrieve a Product by its ID. This includes some basic fields like title, and description. This is useful for displaying products on screens where you need to display products across marketplaces together. But, each product marketplace offers extra metadata and in order to expose that to developers, Rye uses GraphQL inline fragments to expose high-fidelity information about each item.

<Note>
  [`AmazonProduct`](/api-reference/amazonproduct) and [`ShopifyProduct`](/api-reference/shopifyproduct) returned by this query have similarities and differences that are compared in detail [here](/amazon-and-shopify-product-comparison)
</Note>

***

### Arguments

<ParamField path="input" type={<><a href="/api-reference/productbyidinput">ProductByIDInput!</a></>} required>
  An object containing the product ID.
</ParamField>

### Returns

<ParamField path="Product" type={<><a href="/api-reference/product">Product</a></>}>
  Any requested field from an object which implements the [`Product`](/api-reference/product) interface.
</ParamField>

<Note>
  The query returns null if the product is not found in the inventory
</Note>

***

### Example - request

<CodeGroup>
  ```GraphQL Amazon hasOffer theme={null}
  query($input: ProductByIDInput!) {
    productByID(
      input: $input
    ) {
      id
    	title
      url
      isAvailable
      price {
        value
        currency
      }
      images {
        url
      }
      ... on AmazonProduct {
          color
          weight
          dimensions
          hasOffer(fulfilledByAmazon: true, soldByAmazon: false)
          specifications {
              value
              name
          }
      }
    }
  }
  ```

  ```GraphQL Amazon theme={null}
  query DemoAmazonShopifyProductFetch {
    amazonItem1: productByID(input: { id: "B07H2V5YLH", marketplace: AMAZON }) {
      id
      title
      marketplace
      description
      vendor
      url
      isAvailable
      tags
      images {
        url
      }
      variants {
        title
      }
      price {
        currency
        displayValue
        value
      }
      ... on AmazonProduct {
        ASIN
        titleExcludingVariantName
        categories {
          name
          url
        }
        featureBullets
        parentID
        protectionPlans {
          title
          price {
            value
            currency
            displayValue
          }
          id
        }
        ratingsTotal
        reviewsTotal
        marketplace
        variants {
          title
          image {
            url
            ... on AmazonImage {
              position
              width
              height
            }
          }
        }
        subtitle {
          text
          url
        }
        videos {
          durationSeconds
          width
          height
          url
          thumbnailURL
          title
        }
        specifications {
          name
          value
        }
        color
        manufacturer
        weight
        firstAvailable
        dimensions
        modelNumber
      }
    }
  }
  ```

  ```GraphQL Shopify theme={null}
  query DemoShopifyProductByID {
    productByID(input: { id: "7074033139917", marketplace: SHOPIFY }) {
      id
      marketplace
      title
      description
      vendor
      url
      isAvailable
      tags
      images {
        url
      }
      variants {
        ... on ShopifyVariant {
          id
        }
        title
        image {
          url
          ... on ShopifyImage {
            position
            width
            height
          }
        }
      }
      price {
        currency
        displayValue
        value
      }
      ... on ShopifyProduct {
        descriptionHTML
        collectionHandle
        handle
        maxPrice
        minPrice
        productType
        createdAt
        publishedAt
        storeCanonicalURL
        reviewsConnection(first: 5) {
          pageInfo {
            endCursor
            hasNextPage
          }
          edges {
            node {
              id
              body
              helpfulnessCount
              rating
              submittedAt
              reviewerDisplayName
              merchantReply
            }
          }
        }
      }
    }
  }
  ```
</CodeGroup>

### Example - response

<CodeGroup>
  ```json Response (Amazon) theme={null}
  {
    "data": {
      "amazonItem1": {
        "id": "B07H2V5YLH",
        "title": "Ailun Glass Screen Protector Compatible for iPhone 11/XR,6.1 Inch 3 Pack Tempered Glass",
        "marketplace": "AMAZON",
        "description": "",
        "vendor": "Ailun",
        "url": "https://www.amazon.com/AILUN-Protector-Compatible-Tempered-Anti-Scratch/dp/B07H2V5YLH",
        "isAvailable": true,
        "tags": [],
        "images": [
          {
            "url": "https://m.media-amazon.com/images/I/81MZ5D1wHpL._AC_SL1500_.jpg"
          },
          {
            "url": "https://m.media-amazon.com/images/I/713LD6xbHQL._AC_SL1500_.jpg"
          },
          {
            "url": "https://m.media-amazon.com/images/I/81Y8IOtTvrL._AC_SL1500_.jpg"
          },
          {
            "url": "https://m.media-amazon.com/images/I/81Xzo3AnD1L._AC_SL1500_.jpg"
          },
          {
            "url": "https://m.media-amazon.com/images/I/71pf98FKK6L._AC_SL1500_.jpg"
          },
          {
            "url": "https://m.media-amazon.com/images/I/81X2OoQEtaL._AC_SL1500_.jpg"
          }
        ],
        "variants": [],
        "price": {
          "currency": "USD",
          "displayValue": "$7.98",
          "value": 798
        },
        "ASIN": "B07H2V5YLH",
        "titleExcludingVariantName": "",
        "categories": [
          {
            "name": "All Departments",
            "url": ""
          },
          {
            "name": "Cell Phones & Accessories",
            "url": "https://www.amazon.com/cell-phones-service-plans-accessories/b/ref=dp_bc_aui_C_1?ie=UTF8&node=2335752011"
          },
          {
            "name": "Accessories",
            "url": "https://www.amazon.com/cell-phone-accessories/b/ref=dp_bc_aui_C_2?ie=UTF8&node=2407755011"
          },
          {
            "name": "Maintenance, Upkeep & Repairs",
            "url": "https://www.amazon.com/b/ref=dp_bc_aui_C_3?ie=UTF8&node=21209105011"
          },
          {
            "name": "Screen Protectors",
            "url": "https://www.amazon.com/screen-protectors/b/ref=dp_bc_aui_C_4?ie=UTF8&node=2407781011"
          }
        ],
        "featureBullets": [
          "WORKS FOR iPhone 11/iPhone XR (2019/2018 release) 6.1 Inch display ,0.33mm tempered glass screen protector. Featuring maximum protection from scratches, scrapes, and bumps.",
          "Specialty: Due to the rounded design of the iPhone 11/XR and to enhance compatibility with most cases, the Tempered glass does not cover the entire screen. HD ultra-clear 99.99% touch-screen accurate.",
          "hydrophobic and oleophobic screen coating protects against sweat and oil residue from fingerprints.",
          "It is 100% brand new,Precise laser cut tempered glass, exquisitely polished,2.5D rounded edges.",
          "Online video installation instruction can be found at the last image slot: Easiest Installation - removing dust and aligning it properly before actual installation,no worrying about bubbles,enjoy your screen as if it wasn't there."
        ],
        "parentID": "",
        "protectionPlans": [],
        "ratingsTotal": 323687,
        "reviewsTotal": 0,
        "subtitle": {
          "text": "Visit the Ailun Store",
          "url": "https://www.amazon.com/stores/Ailun/page/52AA3AC5-42CD-4237-BE3F-75EE5051346D?ref_=ast_bln"
        },
        "videos": [
          {
            "durationSeconds": 0,
            "width": 0,
            "height": 0,
            "url": "https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-us-east-1-prod/17a2f9c7-277a-4f41-a911-47d273f6311b/default.jobtemplate.hls.m3u8",
            "thumbnailURL": "https://m.media-amazon.com/images/I/41jJUFhKhHL._CR0,0,360,203_SR342,193_.jpg",
            "title": "Not what I expected"
          },
          {
            "durationSeconds": 0,
            "width": 0,
            "height": 0,
            "url": "https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-us-east-1-prod/a4c484a7-0ab6-49a6-9aa1-ee541b53ca72/default.jobtemplate.hls.m3u8",
            "thumbnailURL": "https://m.media-amazon.com/images/I/51NUaG-6qzL._CR1,0,638,360_SR342,193_.jpg",
            "title": "video installation instruction"
          },
          {
            "durationSeconds": 0,
            "width": 0,
            "height": 0,
            "url": "https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-us-east-1-prod/83cbd766-99d7-43cf-a362-a1fa24d8a0fa/default.jobtemplate.hls.m3u8",
            "thumbnailURL": "https://m.media-amazon.com/images/I/61Bw8jWMVrL._CR0,0,978,552_SR684,386_.jpg",
            "title": "DEMO - 3 Pack Ailun Glass Screen Protector - iPhone 11/iPhone XR"
          },
          {
            "durationSeconds": 0,
            "width": 0,
            "height": 0,
            "url": "https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-us-east-1-prod/644fe9f7-6888-4301-85f9-632527569cfc/default.jobtemplate.hls.m3u8",
            "thumbnailURL": "https://m.media-amazon.com/images/I/51gVQ19paGL._CR2,0,1276,720_SR684,386_.jpg",
            "title": "Plastic, not glass"
          },
          {
            "durationSeconds": 0,
            "width": 0,
            "height": 0,
            "url": "https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-us-east-1-prod/ec69edb3-179f-42c0-b4a4-030a6ef42438/default.jobtemplate.hls.m3u8",
            "thumbnailURL": "https://m.media-amazon.com/images/I/71u3yU9zKKL._CR2,0,1276,720_SR684,386_.jpg",
            "title": "Ailun Glass Screen Protector - Demo & Review"
          },
          {
            "durationSeconds": 0,
            "width": 0,
            "height": 0,
            "url": "https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-us-east-1-prod/57067bbf-91d9-4723-887e-d2e312190d6b/default.jobtemplate.hls.m3u8",
            "thumbnailURL": "https://m.media-amazon.com/images/I/81g0z7EYvZL._CR5,0,1274,719_SR684,386_.jpg",
            "title": "Perfect and easy to install  screen protector! "
          },
          {
            "durationSeconds": 0,
            "width": 0,
            "height": 0,
            "url": "https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-us-east-1-prod/a8c019d0-c740-4789-8d54-47771f9dde90/default.jobtemplate.hls.m3u8",
            "thumbnailURL": "https://m.media-amazon.com/images/I/51hDPFv+ZNL._CR1,0,638,360_SR342,193_.jpg",
            "title": "Screen Protector Compatible + Camera Lens Protector"
          },
          {
            "durationSeconds": 0,
            "width": 0,
            "height": 0,
            "url": "https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-us-east-1-prod/df9853ac-d81d-444b-8dd9-cdf3336c12a6/default.jobtemplate.hls.m3u8",
            "thumbnailURL": "https://m.media-amazon.com/images/I/41L430xX0lL._CR1,0,638,360_SR342,193_.jpg",
            "title": "Iphone xr glass screen protector"
          },
          {
            "durationSeconds": 0,
            "width": 0,
            "height": 0,
            "url": "https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-us-east-1-prod/5289e8b2-1985-49b8-abf5-6d946097d0b4/default.jobtemplate.hls.m3u8",
            "thumbnailURL": "https://m.media-amazon.com/images/I/61lzLqWBteL._CR0,0,1075,607_SR684,386_.jpg",
            "title": "NEW’C Tempered Glass Screen Protector  - UNBOX AND INSTALL"
          },
          {
            "durationSeconds": 0,
            "width": 0,
            "height": 0,
            "url": "https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-us-east-1-prod/c0255bf0-c86d-4192-8dce-2475e63976f9/default.jobtemplate.hls.m3u8",
            "thumbnailURL": "https://m.media-amazon.com/images/I/41xGCNmAK4L._CR1,0,638,360_SR342,193_.jpg",
            "title": "Tempered Glass Screen Protector Installatuon Guide"
          }
        ],
        "specifications": [
          {
            "name": "Product Dimensions",
            "value": "6.5 x 0.43 x 3.54 inches"
          },
          {
            "name": "Item Weight",
            "value": "2.12 ounces"
          },
          {
            "name": "ASIN",
            "value": "B07H2V5YLH"
          },
          {
            "name": "Item model number",
            "value": "iphone11/XR 3GSP"
          },
          {
            "name": "Customer Reviews",
            "value": "4.6 out of 5 stars       323,687 ratings          4.6 out of 5 stars"
          },
          {
            "name": "Best Sellers Rank",
            "value": "#5 in Cell Phones & Accessories"
          },
          {
            "name": "Is Discontinued By Manufacturer",
            "value": "No"
          },
          {
            "name": "Special features",
            "value": "9H Surface Hardness"
          },
          {
            "name": "Other display features",
            "value": "Wireless"
          },
          {
            "name": "Color",
            "value": "Clear"
          },
          {
            "name": "Manufacturer",
            "value": "Siania"
          },
          {
            "name": "Date First Available",
            "value": "September 6, 2018"
          },
          {
            "name": "Brand",
            "value": "Ailun"
          },
          {
            "name": "Compatible Devices",
            "value": "IPhone XR, IPhone 11"
          },
          {
            "name": "Material",
            "value": "Tempered Glass"
          },
          {
            "name": "Item Hardness",
            "value": "9H"
          },
          {
            "name": "Product Dimensions",
            "value": "6.5\"L x 3.54\"W"
          },
          {
            "name": "Compatible Phone Models",
            "value": "Iphone xr, Iphone 11"
          },
          {
            "name": "Special Feature",
            "value": "9H Surface Hardness"
          },
          {
            "name": "Finish Type",
            "value": "Polished"
          },
          {
            "name": "Water Resistance Level",
            "value": "Not Water Resistant"
          },
          {
            "name": "Unit Count",
            "value": "3.0 Count"
          }
        ],
        "color": "Clear",
        "manufacturer": "Siania",
        "weight": "2.12 ounces",
        "firstAvailable": null,
        "dimensions": "6.5\"L x 3.54\"W",
        "modelNumber": null
      }
    }
  }
  ```

  ```json Response (Shopify) theme={null}
  {
    "data": {
      "productByID": {
        "id": "7074033139917",
        "marketplace": "SHOPIFY",
        "title": "Baseball Cap",
        "description": "A classic dad hat never goes out of style—especially one that’s made of 100% organic cotton. The high quality and 100% organic cotton of this hat makes it a sustainable choice. You'll be able to enjoy it for years to come. Complement your stylish outfits with this eco-friendly hat!\n\r\n• 100% organic cotton\r\n• Fabric weight: 8 oz/yd² (271 g/m²)\r\n• 3/1 twill\r\n• Unstructured\r\n• 6 panel\r\n• Matching sewn eyelets\r\n• Self-fabric adjustable closure with a brass slider and hidden tuck-in\r\n• Blank product sourced from China",
        "vendor": "rye-protocol",
        "url": "/products/baseball-cap",
        "isAvailable": true,
        "tags": [],
        "images": [
          {
            "url": "https://cdn.shopify.com/s/files/1/0625/6853/0125/products/organic-baseball-cap-black-front-63212d56edabf.jpg?v=1663118690"
          }
        ],
        "variants": [
          {
            "id": "41160207204557",
            "title": "Default Title",
            "image": {
              "url": "https://cdn.shopify.com/s/files/1/0625/6853/0125/products/organic-baseball-cap-black-front-63212d56edabf.jpg?v=1663118690",
              "position": 1,
              "width": 2000,
              "height": 2000
            }
          }
        ],
        "price": {
          "currency": "USD",
          "displayValue": "$21.00",
          "value": 2100
        },
        "descriptionHTML": "A classic dad hat never goes out of style—especially one that’s made of 100% organic cotton. The high quality and 100% organic cotton of this hat makes it a sustainable choice. You'll be able to enjoy it for years to come. Complement your stylish outfits with this eco-friendly hat!<br>\r\n<br>\r\n• 100% organic cotton<br>\r\n• Fabric weight: 8 oz/yd² (271 g/m²)<br>\r\n• 3/1 twill<br>\r\n• Unstructured<br>\r\n• 6 panel<br>\r\n• Matching sewn eyelets<br>\r\n• Self-fabric adjustable closure with a brass slider and hidden tuck-in<br>\r\n• Blank product sourced from China",
        "collectionHandle": "",
        "handle": "baseball-cap",
        "maxPrice": 2100,
        "minPrice": 2100,
        "productType": "",
        "createdAt": "2022-09-14T09:24:47+08:00",
        "publishedAt": "2022-09-14T09:24:50+08:00",
        "storeCanonicalURL": "https://rye-protocol.myshopify.com",
        "reviewsConnection": {
          "pageInfo": {
            "endCursor": null,
            "hasNextPage": false
          },
          "edges": []
        }
      }
    }
  }
  ```
</CodeGroup>

### Related queries

* [`productsByDomainV2`](/api-reference/productsbydomainv2)
* [`productsByIds`](/api-reference/productsbyids)