Categories API

Product taxonomy that makes sense. To shoppers, not just merchandisers.

The Prodx Categories API organizes products into intuitive, shopper-friendly category groups with hierarchical child categories. Request a top-level category and get structured groups with products, subcategories, and logical organization that matches how people actually think about grocery shopping.

See It In Action

View Documentation

Why Browse Paths Break Down

Retailer category trees are usually built for internal merchandising, not for how shoppers actually think or navigate.

Internal Taxonomy Bias

Products sit where they make sense internally, not where shoppers expect them.

Weak Hierarchy

Flat or inconsistent trees create friction across browse and landing pages.

Limited Personalization

Category paths rarely adapt to shopper behavior or merchandising goals.

How Prodx Structures Shopper-Friendly Navigation

Prodx returns broad groups and individual categories in a clean hierarchy, while still allowing hybrid retailer structures and category-level merchandising logic.

Returns 10,000+ standardized categories with browse-to-category hierarchy.
Supports both broad groups and individual category outputs.
Allows retailer-specific custom paths, groupings, and filtered outputs.
Integrates with category-level merchandising and personalization logic.
Powers department menus, category landing pages, breadcrumbs, and browse layers.

Measurable Impact

When product data is clean, every metric improves.

Cleaner

Navigation paths

Shoppers reach the right place with less friction.

Better

Browse-to-cart flow

Category pages can be merchandised and personalized more intelligently.

Fewer

Support tickets about finding products

Taxonomy starts to match shopper expectations.

How a Top-10 Grocer Transformed Their Search Experience

See how structured product data eliminated "no results" pages and drove a measurable lift in online conversion.

Read the Full Story

Technical Specifications

Every Prodx API is designed for real-world retail environments — high volume, low latency, and continuous data updates. From authentication to uptime guarantees, everything is engineered to integrate cleanly and scale with your business.

Response Format

JSON

Authentication

API key (provided at onboarding)

Rate Limits

Configured per retailer at contract level

Hosting

Prodx-managed cloud infrastructure

Latency

Sub-200ms typical response times

Availability

99.9% + uptime SLA

Data Refresh

Continuous. Product data updates propagate within minutes of catalog changes.

Integration

RESTful API. Standard HTTPS. No SDKs required.

Onboarding

Three weeks typical. Send us your product feed, we handle the rest.

Support

Dedicated account team. Direct engineering access for integration questions.

GET /v1/categories?catalogId=GEN_CATALOG &categoryId=BABY &count=100
{
  "categoriesGroups": [
    {
      "id": "BABY_BATH_AND_SKIN_CARE",
      "name": "Baby Bath & Skin Care",
      "categoriesProducts": [
        { "productId": "960412033", "score": 92 },
        { "productId": "960412045", "score": 87 }
      ],
      "childCategories": [
        { "id": "BABY_LOTION", "name": "Baby Lotion" },
        { "id": "BABY_WASH", "name": "Baby Wash" }
      ]
    },
    {
      "id": "BABY_FORMULA",
      "name": "Baby Formula",
      "categoriesProducts": [
        { "productId": "960500100", "score": 95 }
      ],
      "childCategories": [
        { "id": "INFANT_FORMULA", "name": "Infant Formula" },
        { "id": "TODDLER_FORMULA", "name": "Toddler Formula" }
      ]
    },
    {
      "id": "DIAPERING",
      "name": "Diapering",
      "categoriesProducts": [
        { "productId": "960600200", "score": 90 }
      ],
      "childCategories": [
        { "id": "DIAPERS", "name": "Diapers" },
        { "id": "WIPES", "name": "Wipes" }
      ]
    }
  ],
  "categoriesRequest": {
    "catalogId": "GEN_CATALOG",
    "categoryId": "BABY"
  }
}