PendiumDocs

Look up a public brand score

Look up any brand's public AI visibility score from the Pendium Brand Index — no API key required.

Look up any brand's public AI visibility score from the Pendium Brand Index. This is the only visibility tool that works without an API key — search by URL, brand name, or slug.

When to use

  • Reach for this when you want an already-computed public score for any brand — yours or a competitor's — without running a scan or holding an API key.
  • Need to generate a fresh report instead? Run a full scan for an agent you own, or a shareable brand preview for any URL.

Typical sequence

  1. lookup_brand_score — resolve a brand by slug, url, or name and read its public score. Prefer slug for the fastest, most precise lookup; fall back to a returned slug if a name search reports multiple matches.

Tools

lookup_brand_score

Look up a brand's public AI visibility score from the Pendium Brand Index. Provide at least one of url, name, or slug.

Authentication: Public (no API key required).

ParameterTypeRequiredDescription
urlstringAt least one of url/name/slugWebsite URL to look up (e.g., https://example.com).
namestringAt least one of url/name/slugBrand name to search for (e.g., "Pendium").
slugstringAt least one of url/name/slugBrand Index slug (e.g., "pendium"). Most precise lookup.
include_query_rankingsbooleanNo (default false)Include the full per-query, per-platform competitor rankings. Default false keeps per-query scores, platform-level position/snippet/sentiment, and the target brand's ranking entry, but strips the competitor list per query (the aggregated competitors list is always returned). Set true for the full breakdown — it is much larger.

Resolution order:

  • slug: direct lookup by Brand Index slug. Fastest and most precise.
  • url: extracts the domain and matches against known brand websites.
  • name: fuzzy search by brand name. Returns an error if multiple brands match — use slug to disambiguate.

Responses: on a match, returns brand (slug, name, website), overallScore, visibilityLevel, scanDate, personas, queries, competitors, brandMentionCount, summary, insights (strengths/gaps/opportunities), platformScores, topics, scanStats, reportUrl, and brandIndexUrl. When no brand is found, returns error with code: "BRAND_NOT_FOUND". When a name search matches several brands, returns code: "MULTIPLE_MATCHES" with a matches array — use a slug from it to make a precise lookup.

Claim URLs: when looking up a brand with an API key, the response may include a one-time-use claimUrl that lets the brand owner claim and manage their Brand Index listing. Claim URLs are only included in authenticated responses.

On this page