Circana · Schema

CategoryDetail

Detailed category information

AnalyticsConsumer DataMarket ResearchRetailCPGPoint-of-SaleConsumer InsightsBusiness Intelligence

Properties

Name	Type	Description
category_id	string	Unique category identifier
name	string	Category name
description	string	Category description
parent_id	string	Parent category identifier
industry	string	Industry vertical
level	integer	Depth level in the category hierarchy
subcategories	array	Direct subcategories
data_coverage	object	Data availability and coverage information

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/circana/refs/heads/main/json-schema/liquid-data-category-detail-schema.json",
  "title": "CategoryDetail",
  "description": "Detailed category information",
  "type": "object",
  "properties": {
    "category_id": {
      "type": "string",
      "description": "Unique category identifier",
      "example": "cpg-beverages"
    },
    "name": {
      "type": "string",
      "description": "Category name",
      "example": "Beverages"
    },
    "description": {
      "type": "string",
      "description": "Category description",
      "example": "All beverage categories including carbonated, juice, water, and energy drinks"
    },
    "parent_id": {
      "type": "string",
      "description": "Parent category identifier",
      "example": "cpg"
    },
    "industry": {
      "type": "string",
      "description": "Industry vertical",
      "example": "cpg"
    },
    "level": {
      "type": "integer",
      "description": "Depth level in the category hierarchy",
      "example": 2
    },
    "subcategories": {
      "type": "array",
      "description": "Direct subcategories",
      "items": {
        "type": "object",
        "properties": {
          "category_id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "parent_id": {
            "type": "string"
          },
          "industry": {
            "type": "string"
          },
          "level": {
            "type": "integer"
          },
          "subcategory_count": {
            "type": "integer"
          }
        }
      }
    },
    "data_coverage": {
      "type": "object",
      "description": "Data availability and coverage information",
      "properties": {
        "pos_available": {
          "type": "boolean",
          "description": "Whether POS data is available"
        },
        "panel_available": {
          "type": "boolean",
          "description": "Whether consumer panel data is available"
        },
        "earliest_date": {
          "type": "string",
          "format": "date",
          "description": "Earliest available data date"
        },
        "latest_date": {
          "type": "string",
          "format": "date",
          "description": "Latest available data date"
        }
      }
    }
  }
}

Work with this as data

Every JSON Schema 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 schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema in the catalog.
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 JSON Schema

curl "https://apis.io/api/v1/json-schemas/liquid-data-category-detail"

All schemas

curl "https://apis.io/api/v1/json-schemas?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.