Circana · JSON Structure

Circana Structure

Structural overview of the Circana API surface; extracted from openapi/.

Type: Properties: 0

AnalyticsConsumer DataMarket ResearchRetailCPGPoint-of-SaleConsumer InsightsBusiness Intelligence

Circana Structure is a JSON Structure definition published by Circana.

Meta-schema:

JSON Structure

{
  "provider": "Circana",
  "providerId": "circana",
  "kind": "json-structure",
  "description": "Structural overview of the Circana API surface; extracted from openapi/.",
  "schemaCount": 26,
  "operationCount": 14,
  "schemas": [
    {
      "name": "POSDataResponse",
      "type": "object",
      "propertyCount": 2,
      "required": []
    },
    {
      "name": "POSRecord",
      "type": "object",
      "propertyCount": 9,
      "required": []
    },
    {
      "name": "MarketShareResponse",
      "type": "object",
      "propertyCount": 2,
      "required": []
    },
    {
      "name": "MarketShareRecord",
      "type": "object",
      "propertyCount": 5,
      "required": []
    },
    {
      "name": "ConsumerPurchaseResponse",
      "type": "object",
      "propertyCount": 2,
      "required": []
    },
    {
      "name": "ConsumerPurchaseRecord",
      "type": "object",
      "propertyCount": 7,
      "required": []
    },
    {
      "name": "ConsumerSegmentResponse",
      "type": "object",
      "propertyCount": 2,
      "required": []
    },
    {
      "name": "ConsumerSegment",
      "type": "object",
      "propertyCount": 6,
      "required": []
    },
    {
      "name": "CategoryListResponse",
      "type": "object",
      "propertyCount": 2,
      "required": []
    },
    {
      "name": "CategorySummary",
      "type": "object",
      "propertyCount": 6,
      "required": []
    },
    {
      "name": "CategoryDetail",
      "type": "object",
      "propertyCount": 8,
      "required": []
    },
    {
      "name": "DataCoverage",
      "type": "object",
      "propertyCount": 4,
      "required": []
    },
    {
      "name": "BrandListResponse",
      "type": "object",
      "propertyCount": 2,
      "required": []
    },
    {
      "name": "BrandSummary",
      "type": "object",
      "propertyCount": 5,
      "required": []
    },
    {
      "name": "BrandDetail",
      "type": "object",
      "propertyCount": 6,
      "required": []
    },
    {
      "name": "MarketPresence",
      "type": "object",
      "propertyCount": 3,
      "required": []
    },
    {
      "name": "RetailerListResponse",
      "type": "object",
      "propertyCount": 2,
      "required": []
    },
    {
      "name": "RetailerSummary",
      "type": "object",
      "propertyCount": 5,
      "required": []
    },
    {
      "name": "ReportListResponse",
      "type": "object",
      "propertyCount": 2,
      "required": []
    },
    {
      "name": "ReportSummary",
      "type": "object",
      "propertyCount": 6,
      "required": []
    },
    {
      "name": "ReportDetail",
      "type": "object",
      "propertyCount": 9,
      "required": []
    },
    {
      "name": "CreateReportRequest",
      "type": "object",
      "propertyCount": 7,
      "required": [
        "name",
        "report_type",
        "category_id",
        "start_date",
        "end_date"
      ]
    },
    {
      "name": "CreateExportRequest",
      "type": "object",
      "propertyCount": 4,
      "required": [
        "source_type",
        "source_id",
        "format"
      ]
    },
    {
      "name": "ExportDetail",
      "type": "object",
      "propertyCount": 7,
      "required": []
    },
    {
      "name": "Pagination",
      "type": "object",
      "propertyCount": 3,
      "required": []
    },
    {
      "name": "ErrorResponse",
      "type": "object",
      "propertyCount": 4,
      "required": []
    }
  ],
  "operations": [
    {
      "method": "GET",
      "path": "/market-data/pos",
      "operationId": "getPointOfSaleData",
      "summary": "Circana Get Point of Sale Data",
      "tags": [
        "Market Data"
      ]
    },
    {
      "method": "GET",
      "path": "/market-data/share",
      "operationId": "getMarketShare",
      "summary": "Circana Get Market Share Data",
      "tags": [
        "Market Data"
      ]
    },
    {
      "method": "GET",
      "path": "/consumer-panel/purchases",
      "operationId": "getConsumerPurchases",
      "summary": "Circana Get Consumer Purchase Data",
      "tags": [
        "Consumer Panel"
      ]
    },
    {
      "method": "GET",
      "path": "/consumer-panel/segments",
      "operationId": "getConsumerSegments",
      "summary": "Circana Get Consumer Segments",
      "tags": [
        "Consumer Panel"
      ]
    },
    {
      "method": "GET",
      "path": "/categories",
      "operationId": "listCategories",
      "summary": "Circana List Categories",
      "tags": [
        "Categories"
      ]
    },
    {
      "method": "GET",
      "path": "/categories/{category_id}",
      "operationId": "getCategory",
      "summary": "Circana Get Category Details",
      "tags": [
        "Categories"
      ]
    },
    {
      "method": "GET",
      "path": "/brands",
      "operationId": "listBrands",
      "summary": "Circana List Brands",
      "tags": [
        "Brands"
      ]
    },
    {
      "method": "GET",
      "path": "/brands/{brand_id}",
      "operationId": "getBrand",
      "summary": "Circana Get Brand Details",
      "tags": [
        "Brands"
      ]
    },
    {
      "method": "GET",
      "path": "/retailers",
      "operationId": "listRetailers",
      "summary": "Circana List Retailers",
      "tags": [
        "Retailers"
      ]
    },
    {
      "method": "GET",
      "path": "/reports",
      "operationId": "listReports",
      "summary": "Circana List Reports",
      "tags": [
        "Reports"
      ]
    },
    {
      "method": "POST",
      "path": "/reports",
      "operationId": "createReport",
      "summary": "Circana Create Report",
      "tags": [
        "Reports"
      ]
    },
    {
      "method": "GET",
      "path": "/reports/{report_id}",
      "operationId": "getReport",
      "summary": "Circana Get Report Details",
      "tags": [
        "Reports"
      ]
    },
    {
      "method": "POST",
      "path": "/exports",
      "operationId": "createExport",
      "summary": "Circana Create Data Export",
      "tags": [
        "Exports"
      ]
    },
    {
      "method": "GET",
      "path": "/exports/{export_id}",
      "operationId": "getExport",
      "summary": "Circana Get Export Status",
      "tags": [
        "Exports"
      ]
    }
  ]
}

Work with this as data

Every JSON Structure 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 json structure

4 MCP tools reach this

find_json_structuresBrowse and filter every JSON Structure 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 Structure

curl "https://apis.io/api/v1/json-structures/circana-structure"

All json structure

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