LogoLogo
Support
Product Discovery Developer Guide
Product Discovery Developer Guide
  • Product Discovery Developer Guide
  • 🛒Item catalog management
    • What is the Items API?
    • How to work with Items
      • Item Schema
        • Attributes
        • Nested Item Schemas
        • Using the Item Schema API
        • DefaultLocale API
        • Onboarding on/migrating to Fredhopper
        • List of Reserved Attributes
      • Category Tree
        • Using the Category Tree API
        • Onboarding on XO
      • Item Catalog
        • Using the Catalog API
      • Items
        • Using the streaming Items API
        • Using the batch Items API
    • Step by Step guide
      • Step by step guide for Fredhopper customers
    • Feedback
      • Using the Feedback API
    • Authorization to APIs
    • Troubleshooting API errors
  • 🎯XO Recommendations
    • Introduction
    • Using the Recommendations API
    • Setting up the Chrome extension
    • Micro-segmentation
    • XO Legacy APIs
  • 🔎XO Search
    • Introduction
    • Getting started
    • API Reference
      • Search API
      • Autocomplete API (Beta)
      • Product Suggest API
    • API Parameters
      • Search
      • Pagination
      • Faceting
      • Sorting
      • Grouping
      • Filtering
      • Disable features
      • Response mask
      • Context
    • Configuration limitation
  • 🧪A/B testing
    • Fredhopper A/B testing
      • Integration steps for a non-caching solution
      • Integration steps for a caching solution
        • Java SDK Integration
          • Setup
          • Retrieve running A/B tests - Java SDK
          • Filter and request variant - Java SDK
          • Extending the SDK
        • Manual A/B tests integration
          • Retrieve running A/B tests
          • Filter out irrelevant A/B tests
          • Assign variants to user
          • Request variant for page
        • Limitations and Best Practices
  • 📚Resources
    • Glossary
    • Best Practices
      • Tracker Best Practices
      • Items API Best Practices
      • Fredhopper Data Configuration Best Practices
      • Fredhopper Query Response Best Practices
      • Fredhopper Merchandising Studio Best Practices
    • Privacy Notice
  • Archived Pages
    • FHR Tracking plan
    • XO Tracking plan
    • The Tracking API and JS Library
      • What to Track
        • Generic Actions
          • View
          • Click
          • Add to Cart
          • Remove from Cart
          • Purchase
        • Custom Actions
      • Initializing the JavaScript Library
      • REST API Technical Documentation
Powered by GitBook

Copyright @ 2024 Crownpeak Technology, Inc. All rights reserved.

On this page
  • Definition
  • Structure
  1. Item catalog management
  2. How to work with Items

Item Catalog

A catalog is a group of items with a structure defined by one or more item schemas.

Definition

Registering a catalog creates a version. Only one catalog version can be activated. The activated catalog version is set to "active" and will be used by the search and recommendation. Only 2 catalogs at the same time are managed by the API. If this limit is reached, one catalogue must be deleted to create another one.

Having different versions of the catalog allows preparing a version to be activated, or to go back and activate an old version.

Structure

Name

type

Description

tenant

string

Tenant of the account

environment

string

Environment to use

version

integer

Automatically created

name

string

Optional catalog name

state

List of states: INACTIVE, ACTIVATING, ACTIVE

catalogItemSchemas

list

List of itemSchema used in the catalog

catalogCategoryTrees

list

List of categoryTreed used in the catalog

The catalog_item_schemas and catalogCategoryTrees fields are a list of objects containing the name and version of the item schema/category tree and should look like this:

[
    {
        "name": "product",
        "version": 2
    }
]
PreviousOnboarding on XONextUsing the Catalog API

Last updated 3 months ago

🛒