Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.appeeky.com/llms.txt

Use this file to discover all available pages before exploring further.

GET /v1/ai-visibility/:appId/trend
Returns a daily series of AI Visibility metrics. Use it to draw the chart on your dashboard — score over time, sentiment over time, prompt coverage over time — for a single (app, country, model) combination. The series can be scoped to either:
  • the whole app (default) — the same numbers the headline gauge shows in GET /overview, one row per scored day.
  • a single intent — pass intentId to drill into how visibility for that one user goal moved over time.

​
Path parameters

NameTypeRequiredDescription
appIdstringYesApple App ID (numeric)

​
Query parameters

NameTypeDefaultDescription
countrystringusISO country code
modelstringchatgptOne of chatgpt, claude, gemini, perplexity
windowDaysint30Lookback window. Min 1, max 90.
intentIdstring—Optional. If provided, restricts the series to that one intent. Otherwise returns the app-level series (intent_id IS NULL).

​
Response

{
  "data": [
    {
      "date": "2026-04-12",
      "visibilityScore": 31,
      "visibilityPct": 22.2,
      "sentimentPct": 64,
      "positionAvg": 3.1,
      "promptsTotal": 54,
      "promptsWithOwner": 12
    },
    {
      "date": "2026-04-15",
      "visibilityScore": 38,
      "visibilityPct": 27.8,
      "sentimentPct": 67,
      "positionAvg": 2.7,
      "promptsTotal": 54,
      "promptsWithOwner": 15
    },
    {
      "date": "2026-04-18",
      "visibilityScore": 42,
      "visibilityPct": 31.5,
      "sentimentPct": 70,
      "positionAvg": 2.4,
      "promptsTotal": 54,
      "promptsWithOwner": 17
    }
  ]
}
Rows are returned oldest → newest so a chart library can plot them directly. Days without a scan are omitted (the series isn’t densified) — pass windowDays=30 and you’ll get however many days actually have data inside that window.
FieldTypeDescription
datestringISO date (YYYY-MM-DD) the scan was scored on
visibilityScoreint0–100 composite score for that day
visibilityPctnumber% of prompts that mentioned your app
sentimentPctnumber | nullAverage sentiment of mentions, expressed 0–100. Null when there were no mentions.
positionAvgnumber | nullAverage rank position of your app in mentions. Null when there were no mentions.
promptsTotalintHow many prompts were scanned that day
promptsWithOwnerintHow many of those mentioned your app

​
Examples

​
App-level 30-day trend (default)

curl https://api.appeeky.com/v1/ai-visibility/1234567890/trend \
  -H "Authorization: Bearer $JWT"

​
Single intent, 90-day window

curl "https://api.appeeky.com/v1/ai-visibility/1234567890/trend?intentId=8c3a-xxxx&windowDays=90" \
  -H "Authorization: Bearer $JWT"

​
Compare models side-by-side

Call the endpoint once per model and overlay the series: 
for m in chatgpt claude gemini perplexity; do
  curl "https://api.appeeky.com/v1/ai-visibility/1234567890/trend?model=$m" \
    -H "Authorization: Bearer $JWT" > "trend-$m.json"
done

​
Credits

This is a read endpoint billed against the AI Visibility credit pool: 1 credit per call. See Overview & pricing for the full pricing table.