GEO Score API

Access GEO Score data programmatically.

Get Current GEO Score

GET /v1/brands/{brand_id}/geo-score

Response

{
  "success": true,
  "data": {
    "score": 72,
    "change": 3,
    "change_period": "7d",
    "breakdown": {
      "citation_frequency": 68,
      "domain_authority": 75,
      "platform_diversity": 80,
      "technical_factors": 65
    },
    "updated_at": "2024-01-15T10:00:00Z"
  }
}

Get Historical Scores

GET /v1/brands/{brand_id}/geo-score/history?period=30d

Parameters

Response

{
  "success": true,
  "data": {
    "scores": [
      { "date": "2024-01-15", "score": 72 },
      { "date": "2024-01-14", "score": 71 },
      { "date": "2024-01-13", "score": 69 }
    ],
    "period": "30d",
    "granularity": "daily"
  }
}

Get Score Breakdown

GET /v1/brands/{brand_id}/geo-score/breakdown

Response

{
  "success": true,
  "data": {
    "citation_frequency": {
      "score": 68,
      "total_citations": 142,
      "platforms": {
        "chatgpt": 45,
        "perplexity": 52,
        "claude": 28,
        "google_ai": 17
      }
    },
    "domain_authority": {
      "score": 75,
      "backlinks": 12500,
      "referring_domains": 890
    },
    "platform_diversity": {
      "score": 80,
      "platforms_present": 4,
      "platforms_total": 5
    },
    "technical_factors": {
      "score": 65,
      "schema_implemented": true,
      "mobile_friendly": true,
      "page_speed": 72
    }
  }
}