Overview Endpoint

GET /v1/ai-visibility/:appId/overview

​

Path parameters

​

Query parameters

​

Response

{
  "data": {
    "appId": "1234567890",
    "country": "us",
    "modelSlug": "chatgpt",
    "scoredAt": "2026-05-12",
    "visibilityScore": {
      "score": 92,
      "label": "excellent"
    },
    "sentimentPct": 75,
    "intentsTotal": 8,
    "intentsCovered": 7,
    "trend": {
      "visibilityScorePrev": 88,
      "sentimentPctPrev": 71
    }
  }
}

​

Reading the score

• 80–100 (excellent): AI assistants reliably recommend your app for the intents you care about, near the top of their lists, with positive framing.
• 60–79 (good): You’re a top-of-mind option but not always the first one mentioned. Look at per-intent visibility to find where you’re weak.
• 40–59 (fair): You appear sometimes, often near the end of lists or with neutral language. Significant ASO + content opportunities.
• 0–39 (poor): AI assistants rarely surface you for these intents. Consider whether your intents accurately reflect what you do, and whether your app’s discoverability outside the App Store (web presence, reviews, mentions in content the assistants train on) is enough.

​

Code examples

curl "https://api.appeeky.com/v1/ai-visibility/1234567890/overview?country=us&model=chatgpt" \
  -H "X-API-Key: YOUR_API_KEY"

const params = new URLSearchParams({ country: "us", model: "chatgpt" });
const res = await fetch(
  `https://api.appeeky.com/v1/ai-visibility/1234567890/overview?${params}`,
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const { data } = await res.json();

console.log(`AI Visibility: ${data.visibilityScore.score} (${data.visibilityScore.label})`);
console.log(`Sentiment: ${data.sentimentPct}%`);
console.log(`Intents: ${data.intentsCovered}/${data.intentsTotal} covered`);

import requests

r = requests.get(
  "https://api.appeeky.com/v1/ai-visibility/1234567890/overview",
  params={"country": "us", "model": "chatgpt"},
  headers={"X-API-Key": "YOUR_API_KEY"},
)
data = r.json()["data"]
print(f"Score: {data['visibilityScore']['score']} ({data['visibilityScore']['label']})")

​

Pattern: render gauges for all enabled models side-by-side

const models = ["chatgpt", "claude", "gemini", "perplexity"];
const all = await Promise.all(
  models.map((m) =>
    fetch(
      `https://api.appeeky.com/v1/ai-visibility/1234567890/overview?country=us&model=${m}`,
      { headers: { "X-API-Key": "YOUR_API_KEY" } }
    ).then((r) => r.json())
  )
);
all.forEach((res, i) =>
  console.log(`${models[i]}: ${res.data.visibilityScore.score}`)
);

​

Credits

• 2 credits per call.

​

Errors

​

See also

• Bootstrap — required before this endpoint returns scored data
• Intents endpoint — per-intent breakdown that drives the score
• Competitors — apps appearing alongside or instead of you
• AI Visibility overview — concept page