Docs · v1.4

Getting started

Upnamed needs three things: your domain, your category, and the competitors you care about. The first run takes about 20 minutes and produces a baseline you can compare every later week against.

  1. Create a workspace and add your domain. Brand aliases (product names, old names) go in the same field.
  2. Pick a category. We generate a prompt set from buyer language in that category; review and edit it before the first run.
  3. Add competitors. Anything named in an answer that isn’t on your list shows up under “Unlisted” so you can promote it.
  4. Run. Results and the first visibility score arrive in the Engines view.

Prompt sets

A prompt set is the list of questions run against every engine on each refresh. Sets are grouped by intent so you can see where you are weakest.

IntentExample
comparison“Gusto vs Rippling for a 20-person company”
budget“cheapest payroll with contractor payments”
integration“payroll that integrates with QuickBooks”
use case“payroll for remote teams under 50 people”

Scoring method

The visibility score is the share of prompts in which your brand is named, weighted by each engine’s share of AI referral traffic. Weights are updated quarterly from published traffic data and shown in the app.

score = Σ engine_weight × (prompts_named / prompts_total) × 100

engine_weight (Q3 2026)
  chatgpt     0.70
  perplexity  0.12
  gemini      0.12
  claude      0.06

“Named” means the brand or an alias appears in the answer text as a recommendation, not merely as a mention in passing. Position within the answer is recorded separately as rank.

Gap workflow

A gap is a prompt where at least one engine names a competitor and not you. Gaps carry a status: open, in_progress, closed. A gap closes automatically when you are named on two consecutive refreshes in every engine that previously missed you.

Authentication

API keys are created per workspace under Settings → API. Send the key as a bearer token.

curl https://api.upnamed.com/v1/engines \
  -H "Authorization: Bearer up_live_…"

Endpoints

GET/v1/engines — share of voice and status per engine
GET/v1/prompts — prompt set with latest results
GET/v1/gaps — open gaps ranked by impact
GET/v1/score/history — weekly visibility score
POST/v1/prompts — add custom prompts

Webhooks

Subscribe to run.completed, gap.opened and gap.closed. Payloads are signed with your webhook secret.

GA4 channel group

GA4 buckets AI referrals under Referral by default. Create a custom channel group with the source regex below so AI traffic reports as its own channel next to your Upnamed score.

chatgpt\.com|chat\.openai\.com|perplexity\.ai|gemini\.google\.com|claude\.ai

Slack

Connect a channel under Settings → Integrations to receive a summary after each run: score, delta, and any gaps opened or closed.