Verticals

A "vertical" in 42A is a prompt-template category - awareness, consideration, comparison, or technical. These map roughly to journey stages: discovering you, evaluating you, comparing you with alternatives, technical deep-dives.

Strongest vertical

Org-wide visibility rolled up by category. Items are sorted by visibility_score desc, so the first item is your strongest vertical.

curl -H "Authorization: Bearer $KEY" \
  "https://api.42a.ai/api/v1/vitals/by-category?from=2026-04-15&to=2026-05-14"

const res = await fetch(
  "https://api.42a.ai/api/v1/vitals/by-category?from=2026-04-15&to=2026-05-14",
  { headers: { Authorization: `Bearer ${KEY}` } },
).then((r) => r.json());

const strongest = res.data.items[0];
console.log(`Strongest: ${strongest.category} @ ${strongest.visibility_score}`);

import requests

res = requests.get(
    "https://api.42a.ai/api/v1/vitals/by-category",
    params={"from": "2026-04-15", "to": "2026-05-14"},
    headers={"Authorization": f"Bearer {KEY}"},
).json()

strongest = res["data"]["items"][0]
print(f"Strongest: {strongest['category']} @ {strongest['visibility_score']}")

The window is set with from / to (ISO 8601 date or datetime, inclusive). Both default to today (00:00 UTC → now). Maximum range: 30 days.

Response

{
  "data": {
    "from": "2026-04-15T00:00:00.000Z",
    "to": "2026-05-14T23:59:59.999Z",
    "items": [
      {
        "category": "awareness",
        "visibility_score": 0.51,
        "mention_count": 920,
        "total_queries": 1800,
        "avg_position": 2.9,
        "prompt_template_count": 4
      },
      {
        "category": "comparison",
        "visibility_score": 0.38,
        "mention_count": 410,
        "total_queries": 1100,
        "avg_position": 4.1,
        "prompt_template_count": 3
      }
    ]
  }
}

prompt_template_count is how many prompt templates in your org are tagged with that category - useful for sanity-checking the rollup. If a category has only 1 template, the score swings wildly with that single prompt's performance.

Org-wide vitals

For the headline org-wide visibility number (no per-category breakdown), use /api/v1/vitals:

curl -H "Authorization: Bearer $KEY" \
  "https://api.42a.ai/api/v1/vitals?from=2026-04-15&to=2026-05-14"

This returns the same shape as /brands/{id}/stats but aggregated across every brand and prompt in the org.

Top cited domains in a vertical

Once you know which vertical matters, find which sites the LLMs are citing in it. See Leaderboards → Top cited websites in a vertical.

curl -H "Authorization: Bearer $KEY" \
  "https://api.42a.ai/api/v1/categories/comparison/top-websites?from=2026-05-08&to=2026-05-14"

Common questions this answers

"What's my strongest vertical?" → vitals/by-category, look at items[0].
"Where am I losing ground?" → call twice with two windows (e.g. last 30 days vs last 7 days) and compare visibility_score deltas per category.
"Which prompts in comparison matter?" → after picking a category, see projects/{id}/top-prompts and filter the results to category: "comparison".