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

# /2027-01/retail-media/catalog/stats/merchants/{merchant-id}

> Get the statistics of the catalog of a merchant over the last `last-number-of-hours` hours (24 hours by default)



## OpenAPI

````yaml https://api.criteo.com/2027-01/retailmedia/open-api-specifications.json get /2027-01/retail-media/catalog/stats/merchants/{merchant-id}
openapi: 3.0.1
info:
  title: Criteo API
  description: Criteo API - RetailMedia
  version: 2027-01
servers:
  - url: https://api.criteo.com
security:
  - oauth: []
tags:
  - name: Accounts
  - name: Analytics
  - name: Audience
  - name: Balance
  - name: Billing
  - name: Campaign
  - name: Catalog
  - name: Gateway
paths:
  /2027-01/retail-media/catalog/stats/merchants/{merchant-id}:
    get:
      tags:
        - Catalog
      summary: /2027-01/retail-media/catalog/stats/merchants/{merchant-id}
      description: >-
        Get the statistics of the catalog of a merchant over the last
        `last-number-of-hours` hours (24 hours by default)
      operationId: GetCatalogMerchantStats
      parameters:
        - name: last-number-of-hours
          in: query
          description: >-
            The number of past hours covered by the statistics (1 to 1000, 24 by
            default).
          schema:
            type: integer
            format: int32
        - name: merchant-id
          in: path
          description: The id of the merchant whose catalog statistics are requested.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: The statistics object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatisticsOkResponse'
      security:
        - oauth:
            - RetailMedia_Catalog_Read
components:
  schemas:
    StatisticsOkResponse:
      required:
        - data
      type: object
      properties:
        data:
          $ref: '#/components/schemas/MerchantCatalogStatisticsResource'
        errors:
          type: array
          items:
            $ref: '#/components/schemas/ProductImporterError'
          description: Omitted when empty.
          nullable: true
        warnings:
          type: array
          items:
            $ref: '#/components/schemas/ProductImporterWarning'
          description: Omitted when empty.
          nullable: true
      description: The statistics of a merchant catalog.
    MerchantCatalogStatisticsResource:
      required:
        - attributes
        - id
        - type
      type: object
      properties:
        attributes:
          $ref: '#/components/schemas/MerchantCatalogStatisticsAttributes'
        id:
          type: string
          description: The merchant id.
        type:
          type: string
          description: The type of the resource.
      description: The statistics of a merchant catalog over a time window.
    ProductImporterError:
      required:
        - code
        - detail
        - instance
        - title
        - traceId
        - type
      type: object
      properties:
        code:
          type: string
          description: >-
            A MACHINE-READABLE error code string in kebab-case. Unique across
            Criteo
        detail:
          type: string
          description: >-
            A HUMAN-READABLE detailed explanation specific to this occurrence of
            the problem. This should not be more that 1 paragraph
        instance:
          type: string
          description: >-
            A MACHINE-READABLE URI reference that identifies the specific
            occurrence of the problem. This could be useful when we want to the
            return the API Endpoint identifying the exact resource related to
            the error.
        title:
          type: string
          description: >-
            A short, HUMAN-READABLE summary of the problem type. It should not
            change from occurrence to occurrence of the problem, except for
            purposes of localization.
        traceId:
          type: string
          description: The MACHINE-READABLE correlation ID provided by the gateway
        type:
          type: string
          description: >-
            A MACHINE-READABLE code specifying error category. This information
            is used on client side to focus on certain type of error, to either
            retry some processing or display only certain type of errors.
      description: Error descriptor.
    ProductImporterWarning:
      required:
        - code
        - detail
        - instance
        - title
        - traceId
        - type
      type: object
      properties:
        code:
          type: string
          description: >-
            A MACHINE-READABLE error code string in kebab-case. Unique across
            Criteo
        detail:
          type: string
          description: >-
            A HUMAN-READABLE detailed explanation specific to this occurrence of
            the problem. This should not be more that 1 paragraph
        instance:
          type: string
          description: >-
            A MACHINE-READABLE URI reference that identifies the specific
            occurrence of the problem. This could be useful when we want to the
            return the API Endpoint identifying the exact resource related to
            the error.
        title:
          type: string
          description: >-
            A short, HUMAN-READABLE summary of the problem type. It should not
            change from occurrence to occurrence of the problem, except for
            purposes of localization.
        traceId:
          type: string
          description: The MACHINE-READABLE correlation ID provided by the gateway
        type:
          type: string
          description: >-
            A MACHINE-READABLE code specifying error category. This information
            is used on client side to focus on certain type of error, to either
            retry some processing or display only certain type of errors.
      description: Warning descriptor.
    MerchantCatalogStatisticsAttributes:
      required:
        - records
      type: object
      properties:
        records:
          type: array
          items:
            $ref: '#/components/schemas/CatalogStatisticsRecord'
          description: One record per time bucket of the requested window.
      description: The attributes of the statistics of a merchant catalog.
    CatalogStatisticsRecord:
      required:
        - added
        - blacklisted
        - deleted
        - displayable
        - endDate
        - missingDescription
        - missingImage
        - missingName
        - missingPrice
        - missingUrl
        - nonDisplayable
        - outOfStock
        - startDate
        - total
        - updated
        - variant
      type: object
      properties:
        added:
          type: integer
          description: The number of inserted products between startDate and endDate.
          format: int64
        blacklisted:
          type: integer
          description: The number of total blacklisted products at endDate moment.
          format: int64
        deleted:
          type: integer
          description: The number of deleted products between startDate and endDate.
          format: int64
        displayable:
          type: integer
          description: The number of total displayable products at endDate moment.
          format: int64
        endDate:
          type: string
          description: End date (ISO-8601) of the period.
        missingDescription:
          type: integer
          description: The number of total missing description products at endDate moment.
          format: int64
        missingImage:
          type: integer
          description: The number of total missing image products at endDate moment.
          format: int64
        missingName:
          type: integer
          description: The number of total missing name products at endDate moment.
          format: int64
        missingPrice:
          type: integer
          description: The number of total missing price products at endDate moment.
          format: int64
        missingUrl:
          type: integer
          description: The number of total missing url products at endDate moment.
          format: int64
        nonDisplayable:
          type: integer
          description: The number of total non-displayable products at endDate moment.
          format: int64
        outOfStock:
          type: integer
          description: The number of total out-of-stock products at endDate moment.
          format: int64
        startDate:
          type: string
          description: Start date (ISO-8601) of the period.
        total:
          type: integer
          description: The number of total products at endDate moment.
          format: int64
        updated:
          type: integer
          description: The number of updated products between startDate and endDate.
          format: int64
        variant:
          type: integer
          description: The number of total variant products at endDate moment.
          format: int64
      description: >-
        The statistics of a merchant catalog for a period between startDate and
        endDate.
  securitySchemes:
    oauth:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://api.criteo.com/oauth2/token
          scopes:
            RetailMedia_Accounts_Manage: >-
              Grants Manage access to the capabilities from the Accounts domain,
              for RetailMedia applications
            RetailMedia_Accounts_Read: >-
              Grants Read access to the capabilities from the Accounts domain,
              for RetailMedia applications
            RetailMedia_Analytics_Read: >-
              Grants Read access to the capabilities from the Analytics domain,
              for RetailMedia applications
            RetailMedia_Audience_Manage: >-
              Grants Manage access to the capabilities from the Audience domain,
              for RetailMedia applications
            RetailMedia_Audience_Read: >-
              Grants Read access to the capabilities from the Audience domain,
              for RetailMedia applications
            RetailMedia_Balance_Manage: >-
              Grants Manage access to the capabilities from the Balance domain,
              for RetailMedia applications
            RetailMedia_Balance_Read: >-
              Grants Read access to the capabilities from the Balance domain,
              for RetailMedia applications
            RetailMedia_Billing_Read: >-
              Grants Read access to the capabilities from the Billing domain,
              for RetailMedia applications
            RetailMedia_Campaign_Manage: >-
              Grants Manage access to the capabilities from the Campaign domain,
              for RetailMedia applications
            RetailMedia_Campaign_Read: >-
              Grants Read access to the capabilities from the Campaign domain,
              for RetailMedia applications
            RetailMedia_Catalog_Manage: >-
              Grants Manage access to the capabilities from the Catalog domain,
              for RetailMedia applications
            RetailMedia_Catalog_Read: >-
              Grants Read access to the capabilities from the Catalog domain,
              for RetailMedia applications
        authorizationCode:
          authorizationUrl: https://api.criteo.com/oauth2
          tokenUrl: https://api.criteo.com/oauth2/token
          scopes:
            RetailMedia_Accounts_Manage: >-
              Grants Manage access to the capabilities from the Accounts domain,
              for RetailMedia applications
            RetailMedia_Accounts_Read: >-
              Grants Read access to the capabilities from the Accounts domain,
              for RetailMedia applications
            RetailMedia_Analytics_Read: >-
              Grants Read access to the capabilities from the Analytics domain,
              for RetailMedia applications
            RetailMedia_Audience_Manage: >-
              Grants Manage access to the capabilities from the Audience domain,
              for RetailMedia applications
            RetailMedia_Audience_Read: >-
              Grants Read access to the capabilities from the Audience domain,
              for RetailMedia applications
            RetailMedia_Balance_Manage: >-
              Grants Manage access to the capabilities from the Balance domain,
              for RetailMedia applications
            RetailMedia_Balance_Read: >-
              Grants Read access to the capabilities from the Balance domain,
              for RetailMedia applications
            RetailMedia_Billing_Read: >-
              Grants Read access to the capabilities from the Billing domain,
              for RetailMedia applications
            RetailMedia_Campaign_Manage: >-
              Grants Manage access to the capabilities from the Campaign domain,
              for RetailMedia applications
            RetailMedia_Campaign_Read: >-
              Grants Read access to the capabilities from the Campaign domain,
              for RetailMedia applications
            RetailMedia_Catalog_Manage: >-
              Grants Manage access to the capabilities from the Catalog domain,
              for RetailMedia applications
            RetailMedia_Catalog_Read: >-
              Grants Read access to the capabilities from the Catalog domain,
              for RetailMedia applications

````