Skip to main content
GET
Get Visibility Score
Returns the current AI visibility score and 6 months of historical data in a single request. This is the primary endpoint for the dashboard - it provides everything needed for:
  • The visibility score card (current score + trend)
  • The β€œVisibility Over Time” chart (historical data)

Path Parameters

string
required
The Clerk organization slug

Query Parameters

string
Filter by product/item ID. Omit for business-level score.
string
Business website URL for ranking score fallback (e.g., https://nike.com)

Response

object
Current score with trend
array
Historical data points for charting (up to 6 months)

Visibility Score Object

History Entry

Data Sources & Fallback Logic

Primary Source: Fallback (before first cron run): If visibility_score_history is empty and business_url is provided, the endpoint falls back to pre_payment_rankings table to show an initial score immediately after onboarding. The fallback returns:
  • Score: Value from pre_payment_rankings (32-49)
  • History: 2 fake data points (yesterday: 0, today: score)
Once the daily cron job completes the first real visibility analysis, the endpoint automatically switches to using the real data from visibility_score_history.

Notes

  • Returns 6 months of historical data (once available)
  • Score calculated from visibility across all 8 AI platforms
  • Trend compares current score to 7 days ago
  • Before first cron run: Shows pre-payment ranking score (32-49) with fake 2-day history
  • After first cron run: Switches to real visibility data
  • Real visibility analysis runs daily at 14:00 UTC via cron job