Analytics API

Access trend predictions and cross-engine analytics data.

Get Analytics

GET/api/v1/analytics

Returns analytics data based on the specified type.

Query Parameters

Parameter	Type	Required	Description
`type`	string	Yes	`trends` or `engines`

Trends Response

GET /api/v1/analytics?type=trends

{
  "store_prediction": {
    "trajectory": "improving",
    "confidence": "high",
    "current_score": 72.5,
    "predicted_2w": 76.3,
    "predicted_4w": 80.1
  },
  "product_predictions": [
    {
      "product_id": "uuid",
      "product_name": "Nike Air Max 90",
      "trajectory": "improving",
      "confidence": "medium",
      "current_score": 68.0,
      "predicted_2w": 72.5
    }
  ]
}

Engines Response

GET /api/v1/analytics?type=engines

{
  "engine_stats": {
    "google_ai": {
      "avg_score": 71.2,
      "mention_rate": 0.85,
      "avg_position": 2.1,
      "sentiment": { "positive": 0.6, "neutral": 0.3, "negative": 0.1 },
      "avg_citations": 1.4,
      "recommendation_rate": 0.45
    }
  },
  "correlation_matrix": {
    "google_ai": { "chatgpt": 0.82, "perplexity": 0.75 },
    "chatgpt": { "google_ai": 0.82, "perplexity": 0.68 }
  }
}

Required scope: read

Tip: The trends endpoint requires at least 3 completed scans to generate meaningful predictions. More data points improve prediction confidence.