> ## 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/marketing-solutions/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/marketingsolutions/open-api-specifications.json get /2027-01/marketing-solutions/catalog/stats/merchants/{merchant-id}
openapi: 3.0.1
info:
  title: Criteo API
  description: Criteo API - MarketingSolutions
  version: 2027-01
servers:
  - url: https://api.criteo.com
security:
  - oauth: []
tags:
  - name: Advertiser
  - name: Analytics
  - name: Audience
  - name: Campaign
  - name: Catalog
  - name: Creative
  - name: Gateway
  - name: Reco
paths:
  /2027-01/marketing-solutions/catalog/stats/merchants/{merchant-id}:
    get:
      tags:
        - Catalog
      summary: /2027-01/marketing-solutions/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:
            - MarketingSolutions_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:
            MarketingSolutions_Analytics_Read: >-
              Grants Read access to the capabilities from the Analytics domain,
              for MarketingSolutions applications
            MarketingSolutions_Audience_Manage: >-
              Grants Manage access to the capabilities from the Audience domain,
              for MarketingSolutions applications
            MarketingSolutions_Audience_Read: >-
              Grants Read access to the capabilities from the Audience domain,
              for MarketingSolutions applications
            MarketingSolutions_Campaign_Manage: >-
              Grants Manage access to the capabilities from the Campaign domain,
              for MarketingSolutions applications
            MarketingSolutions_Campaign_Read: >-
              Grants Read access to the capabilities from the Campaign domain,
              for MarketingSolutions applications
            MarketingSolutions_Catalog_Manage: >-
              Grants Manage access to the capabilities from the Catalog domain,
              for MarketingSolutions applications
            MarketingSolutions_Catalog_Read: >-
              Grants Read access to the capabilities from the Catalog domain,
              for MarketingSolutions applications
            MarketingSolutions_Creative_Manage: >-
              Grants Manage access to the capabilities from the Creative domain,
              for MarketingSolutions applications
            MarketingSolutions_Creative_Read: >-
              Grants Read access to the capabilities from the Creative domain,
              for MarketingSolutions applications
            MarketingSolutions_Reco_Manage: >-
              Grants Manage access to the capabilities from the Reco domain, for
              MarketingSolutions applications
            MarketingSolutions_Reco_Read: >-
              Grants Read access to the capabilities from the Reco domain, for
              MarketingSolutions applications
        authorizationCode:
          authorizationUrl: https://api.criteo.com/oauth2
          tokenUrl: https://api.criteo.com/oauth2/token
          scopes:
            MarketingSolutions_Analytics_Read: >-
              Grants Read access to the capabilities from the Analytics domain,
              for MarketingSolutions applications
            MarketingSolutions_Audience_Manage: >-
              Grants Manage access to the capabilities from the Audience domain,
              for MarketingSolutions applications
            MarketingSolutions_Audience_Read: >-
              Grants Read access to the capabilities from the Audience domain,
              for MarketingSolutions applications
            MarketingSolutions_Campaign_Manage: >-
              Grants Manage access to the capabilities from the Campaign domain,
              for MarketingSolutions applications
            MarketingSolutions_Campaign_Read: >-
              Grants Read access to the capabilities from the Campaign domain,
              for MarketingSolutions applications
            MarketingSolutions_Catalog_Manage: >-
              Grants Manage access to the capabilities from the Catalog domain,
              for MarketingSolutions applications
            MarketingSolutions_Catalog_Read: >-
              Grants Read access to the capabilities from the Catalog domain,
              for MarketingSolutions applications
            MarketingSolutions_Creative_Manage: >-
              Grants Manage access to the capabilities from the Creative domain,
              for MarketingSolutions applications
            MarketingSolutions_Creative_Read: >-
              Grants Read access to the capabilities from the Creative domain,
              for MarketingSolutions applications
            MarketingSolutions_Reco_Manage: >-
              Grants Manage access to the capabilities from the Reco domain, for
              MarketingSolutions applications
            MarketingSolutions_Reco_Read: >-
              Grants Read access to the capabilities from the Reco domain, for
              MarketingSolutions applications

````