Trend

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

Name	Type	Required	Description
appId	string	Yes	Apple App ID (numeric)

Query parameters

Name	Type	Default	Description
country	string	`us`	ISO country code
model	string	`chatgpt`	One of `chatgpt`, `claude`, `gemini`, `perplexity`
windowDays	int	`30`	Lookback window. Min 1, max 90.
intentId	string	—	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.

Field	Type	Description
date	string	ISO date (`YYYY-MM-DD`) the scan was scored on
visibilityScore	int	0–100 composite score for that day
visibilityPct	number	% of prompts that mentioned your app
sentimentPct	number \| null	Average sentiment of mentions, expressed 0–100. Null when there were no mentions.
positionAvg	number \| null	Average rank position of your app in mentions. Null when there were no mentions.
promptsTotal	int	How many prompts were scanned that day
promptsWithOwner	int	How 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.

Getting Started

Apps

My Data - Appeeky Web

Keywords

ASO Tools

AI Visibility

Search & Discovery

Market Intelligence

RevenueCat

App Store Connect

Google Play Console

Apple Search Ads

Growth Channels

Reference

Path parameters

Query parameters

Response

Examples

App-level 30-day trend (default)

Single intent, 90-day window

Compare models side-by-side

Credits

​Path parameters

​Query parameters

​Response

​Examples

​App-level 30-day trend (default)

​Single intent, 90-day window

​Compare models side-by-side

​Credits

Path parameters

Query parameters

Response

Examples

App-level 30-day trend (default)

Single intent, 90-day window

Compare models side-by-side

Credits