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

# List Item Matches

> Gets the same product's listings on other sites, and its other listings on the same site, matched by UPC. Products without a UPC have no matches.



## OpenAPI

````yaml GET /items/{itemid}/matches
openapi: 3.0.0
info:
  title: Companion API
  version: 2.0.0
  description: Companion API for Blaze Monitors
servers:
  - url: https://api.blazemonitors.com
    description: Production server
security:
  - ApiKeyAuth: []
tags:
  - name: Items
    description: Monitored product management
  - name: Products
    description: Product search and discovery
  - name: Monitor
    description: Site monitoring information
  - name: Stores
    description: Monitored store management
paths:
  /items/{itemid}/matches:
    get:
      tags:
        - Items
      summary: List Item Matches
      description: >-
        Gets the same product's listings on other sites, and its other listings
        on the same site, matched by UPC. Products without a UPC have no
        matches.
      parameters:
        - name: site
          in: query
          required: true
          schema:
            type: string
          example: bestbuy
        - name: itemid
          in: path
          required: true
          schema:
            type: string
          example: '6614323'
          description: Product SKU or identifier
      responses:
        '200':
          description: The item and its matches
          content:
            application/json:
              schema:
                type: object
                properties:
                  site:
                    $ref: '#/components/schemas/Site'
                  product:
                    $ref: '#/components/schemas/Product'
                  matches:
                    type: array
                    items:
                      type: object
                      properties:
                        site:
                          $ref: '#/components/schemas/Site'
                        product:
                          $ref: '#/components/schemas/Product'
        '400':
          description: The item couldn't be identified
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Product not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    Site:
      type: object
      properties:
        platformName:
          type: string
          example: amazon
        siteId:
          type: string
          example: amazon.com
        siteName:
          type: string
          example: AmazonUS
        siteUrl:
          type: string
          example: https://amazon.com
        siteCurrency:
          type: string
          example: USD
        capabilities:
          $ref: '#/components/schemas/SiteCapabilities'
        queryType:
          type: string
          example: productSku
        notificationTypes:
          type: array
          items:
            type: string
          example:
            - Restock
        altNames:
          type: array
          items:
            type: string
          example:
            - amazon
            - amz
            - amzus
        sellers:
          type: array
          items:
            type: string
          description: Seller IDs the site supports.
          example:
            - Amazon.com
      required:
        - platformName
        - siteId
        - siteName
        - siteUrl
        - siteCurrency
        - capabilities
    Product:
      type: object
      properties:
        productSku:
          type: string
          example: B09DFHJTF5
        productImg:
          type: string
          example: https://images-na.ssl-images-amazon.com/images/I/31B4XfsojxL.jpg
        productName:
          type: string
          example: PlayStation 5 Digital Edition
        retailPrice:
          type: number
          format: double
          example: 399.99
        currentPrice:
          type: number
          format: double
          example: 399.99
        productUrl:
          type: string
          example: https://www.amazon.com/blaze/dp/B09DFHJTF5?tag=blaz3-20
        productSite:
          type: string
          example: AmazonUS
        upc:
          type: string
          description: >-
            The product's barcode (UPC, EAN or GTIN). Present only when the
            retailer lists one.
          example: '711719577294'
        lastRestocked:
          type: integer
          format: int64
          example: 1648823785000
        firstAdded:
          type: integer
          format: int64
          example: 1666041400973
    ErrorResponse:
      type: object
      properties:
        status:
          type: integer
        message:
          type: string
    SiteCapabilities:
      type: object
      properties:
        lists:
          type: boolean
          example: true
        products:
          type: boolean
          example: true
        releases:
          type: boolean
          example: false
        sellers:
          type: boolean
          example: false
        stores:
          type: boolean
          example: false
          description: Alerts cover only the stores your workspace monitors.
      required:
        - lists
        - products
        - releases
        - sellers
        - stores
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
      description: API key for authentication

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.