Verticals API

Access your brand's vertical classification profiles. Verticals help AI agents understand what categories your products belong to and how to present them.

Scope: verticals:read

Management API preview

Vertical classification powers the live platform-specific config adapters (Anthropic, OpenAI, Google, Meta, Perplexity). The brand-facing read API documented here ships with the public Management API release.

GET/verticals

List your brand's detected vertical profiles with confidence scores.

bash

curl https://api.cresva.ai/api/storefront/[brandId]/verticals \
  -H "Authorization: Bearer cresva_ak_..."

javascript

const res = await fetch("https://api.cresva.ai/api/storefront/[brandId]/verticals", {
  headers: { Authorization: "Bearer " + process.env.CRESVA_API_KEY },
});
const { data } = await res.json();

Example Response

JSON

{
  "data": [
    { "vertical": "electronics", "confidence": 0.94, "enabled": true, "detectedAt": "2026-03-01T00:00:00Z" },
    { "vertical": "accessories", "confidence": 0.87, "enabled": true, "detectedAt": "2026-03-01T00:00:00Z" },
    { "vertical": "lifestyle", "confidence": 0.62, "enabled": false, "detectedAt": "2026-03-15T00:00:00Z" }
  ]
}

GET/verticals/attributes

Retrieve product-level vertical attributes. Filterable by product ID and vertical.

Query Parameters

productIdstringFilter by product ID

verticalstringFilter by vertical name

bash

curl "https://api.cresva.ai/api/storefront/[brandId]/verticals/attributes?productId=prod_a1b2c3d4&vertical=electronics" \
  -H "Authorization: Bearer cresva_ak_..."

javascript

const res = await fetch(
  "https://api.cresva.ai/api/storefront/[brandId]/verticals/attributes?productId=prod_a1b2c3d4&vertical=electronics",
  { headers: { Authorization: "Bearer " + process.env.CRESVA_API_KEY } }
);
const { data } = await res.json();

Example Response

JSON

{
  "data": [
    {
      "productId": "prod_a1b2c3d4",
      "vertical": "electronics",
      "attributes": {
        "subcategory": "audio",
        "connectivity": "wireless",
        "priceRange": "mid",
        "targetAudience": "consumer"
      }
    }
  ]
}

Vertical object

JSON

{
  "vertical": "electronics",
  "confidence": 0.94,
  "enabled": true,
  "detectedAt": "2026-03-01T00:00:00Z"
}