Bloomreach

Bloomreach View Catalogs data API

The View Catalogs data API from Bloomreach — 2 operation(s) for view catalogs data.

GitHub OpenAPI

Operations 2

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /accounts/{account_name}/catalogs List an account's catalogs · Get all catalogs #
Ask an LLM
“Which catalogs exist under my Bloomreach account?”
“How do I find the catalog names available to my account?”
Tell an agent
List all catalogs in account {account}.
Show me every catalog that account {account} owns.
GET /accounts/{account_name}/catalogs/{catalog_name}/environments/{environment_name} View a catalog with all its records · Get catalog details #
Ask an LLM
“How can I get the whole catalog, including its product and item records, in one call?”
“What is the current state of a catalog in staging versus production?”
Tell an agent
Get the full contents of catalog {catalog} in account {account} on {environment}.
Show catalog {catalog} with all product and item records for account {account} in {environment}.

Documentation

📖
Documentation
https://documentation.bloomreach.com/discovery/reference/welcome
📖
RateLimits
https://documentation.bloomreach.com/discovery/reference/api-rate-limits
📖
Documentation
https://documentation.bloomreach.com/discovery/reference/catalog-management-api-v3
📖
RateLimits
https://documentation.bloomreach.com/discovery/reference/catalog-data-management-api-rate-limits
📖
Documentation
https://documentation.bloomreach.com/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/bloomreach/refs/heads/main/openapi/bloomreach-view-catalogs-data-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bloomreach/refs/heads/main/json-schema/bloomreach-product-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bloomreach/refs/heads/main/json-schema/bloomreach-search-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bloomreach/refs/heads/main/json-schema/bloomreach-suggest-response-schema.json

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/bloomreach/refs/heads/main/overlays/bloomreach-view-catalogs-data-overlay.yaml
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/bloomreach/refs/heads/main/examples/bloomreach-product-search-request-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/bloomreach/refs/heads/main/examples/bloomreach-product-search-response-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/bloomreach/refs/heads/main/examples/bloomreach-autosuggest-response-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/bloomreach/refs/heads/main/examples/bloomreach-catalog-product-put-example.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/bloomreach:bloomreach-view-catalogs-data-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

bloomreach-view-catalogs-data-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Catalog management View Catalogs data API
  version: 3.0.0
servers:
- url: https://discovery.bloomreach.com/dataconnect/api/v3
security:
- bearerAuth: []
tags:
- name: View Catalogs data
paths:
  /accounts/{account_name}/catalogs:
    parameters:
    - $ref: '#/components/parameters/AccountName'
    get:
      tags:
      - View Catalogs data
      summary: Get all catalogs
      description: Get all the catalogs present for an account.
      responses:
        200:
          description: OK. Click to see the response structure.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      catalogs:
                        type: array
                        items:
                          oneOf:
                          - $ref: '#/components/schemas/ProductCatalog'
                          - $ref: '#/components/schemas/ContentCatalog'
        401:
          description: Unauthorized
        404:
          description: Not found
        429:
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/429Response'
        500:
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/500Response'
      operationId: getAccountsByAccountNameCatalogs
      x-operation-id-source: derived
  /accounts/{account_name}/catalogs/{catalog_name}/environments/{environment_name}:
    parameters:
    - $ref: '#/components/parameters/AccountName'
    - $ref: '#/components/parameters/CatalogName'
    - $ref: '#/components/parameters/EnvironmentName'
    get:
      tags:
      - View Catalogs data
      summary: Get catalog details
      description: View the current state of a catalog. This returns the entire catalog with product and item feed record data.
      responses:
        200:
          description: OK. Click to see the response structure.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      catalog:
                        oneOf:
                        - $ref: '#/components/schemas/ProductCatalog'
                        - $ref: '#/components/schemas/ContentCatalog'
        401:
          description: Unauthorized
        400:
          description: Bad request
          content:
            application/json:
              schema:
                type: object
                properties:
                  details:
                    type: array
                    items:
                      $ref: '#/components/schemas/ErrorResponse'
        404:
          description: Not found
        429:
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/429Response'
        500:
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/500Response'
      operationId: getAccountsByAccountNameCatalogsByCatalogNameEnvironmentsByEnvironmentName
      x-operation-id-source: derived
components:
  parameters:
    CatalogName:
      description: '"Catalog name" is also called domain key. Use the same value as your domain key in your search API requests.'
      name: catalog_name
      in: path
      schema:
        type: string
        minLength: 1
        maxLength: 64
      required: true
      example: homeoasis_fr
    EnvironmentName:
      description: The type of environment you want to use for the request (Production/Staging).
      name: environment_name
      in: path
      schema:
        type: string
        minLength: 1
        maxLength: 64
        enum:
        - production
        - staging
      required: true
    AccountName:
      description: Your unique account name.
      name: account_name
      in: path
      schema:
        type: string
        minLength: 1
        maxLength: 64
      required: true
      example: homeoasis
  schemas:
    ContentCatalogStats:
      type: object
      properties:
        last_index_update_config_etag:
          description: ''
          type: string
          example: 5613f704b80030ef908f1395100fbd1d
        last_index_update_at:
          description: ''
          format: date-time
          type: string
          example: '2024-01-01T00:00:00.000000Z'
        last_feed_full_update_at:
          description: ''
          format: date-time
          type: string
          example: '2024-01-01T00:00:00.000000Z'
        last_feed_delta_update_at:
          description: ''
          format: date-time
          type: string
          example: '2024-01-01T00:00:00.000000Z'
        item_doc_count:
          description: ''
          format: date-time
          type: string
          example: '2024-01-01T00:00:00.000000Z'
        item_record_count:
          description: ''
          format: date-time
          type: string
          example: '2024-01-01T00:00:00.000000Z'
        item_view_override_record_count:
          description: ''
          type: integer
    ProductCatalog:
      type: object
      properties:
        name:
          type: string
        language:
          type: string
        data_type:
          type: string
        environment:
          type: string
        config_etag:
          type: string
        stats:
          $ref: '#/components/schemas/ProductCatalogStats'
        properties:
          $ref: '#/components/schemas/ProductCatalogProperties'
    ContentCatalog:
      type: object
      properties:
        name:
          type: string
        language:
          type: string
        data_type:
          type: string
        environment:
          type: string
        config_etag:
          type: string
        stats:
          $ref: '#/components/schemas/ContentCatalogStats'
    ErrorResponse:
      type: object
      properties:
        type:
          type: string
        title:
          type: string
        detail:
          type: string
        class:
          type: string
          enum:
          - error
          - warning
    ProductCatalogProperties:
      type: object
      properties:
        feed_version:
          description: ''
          type: integer
        index_version:
          description: ''
          type: integer
    500Response:
      description: Internal Server Error
      type: object
      properties:
        details:
          type: array
          items:
            $ref: '#/components/schemas/ErrorResponse'
    ProductCatalogStats:
      type: object
      properties:
        last_index_update_config_etag:
          description: ''
          type: string
          example: 5613f704b80030ef908f1395100fbd1d
        last_index_update_at:
          description: ''
          format: date-time
          type: string
          example: '2024-01-01T00:00:00.000000Z'
        last_index_refresh_at:
          description: ''
          format: date-time
          type: string
          example: '2024-01-01T00:00:00.000000Z'
        last_feed_full_update_at:
          description: ''
          format: date-time
          type: string
          example: '2024-01-01T00:00:00.000000Z'
        last_feed_delta_update_at:
          description: ''
          format: date-time
          type: string
          example: '2024-01-01T00:00:00.000000Z'
        last_keyword_suggest_refresh_at:
          description: ''
          format: date-time
          type: string
          example: '2024-01-01T00:00:00.000000Z'
        product_record_count:
          description: ''
          type: integer
        variant_record_count:
          description: ''
          type: integer
        product_doc_count:
          description: ''
          type: integer
        product_doc_byte_count:
          description: ''
          type: integer
        variant_doc_count:
          description: ''
          type: integer
        variant_doc_byte_count:
          description: ''
          type: integer
        catalog_searchable_byte_count:
          description: ''
          type: integer
        catalog_displayable_byte_count:
          description: ''
          type: integer
        catalog_facetable_manual_byte_count:
          description: ''
          type: integer
        catalog_facetable_auto_byte_count:
          description: ''
          type: integer
        product_view_override_record_count:
          description: ''
          type: integer
        variant_view_override_record_count:
          description: ''
          type: integer
        unique_view_count:
          description: ''
          type: integer
    429Response:
      description: Too Many Requests
      type: object
      properties:
        details:
          type: array
          items:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key