Introduction - GeoRank Docs

Overview

The GeoRank API lets you programmatically access your AI visibility data — GEO Scores, keywords, mentions, competitors, and usage metrics. Use it to build custom dashboards, integrate with your analytics stack, or automate workflows.

API access is available on Starter, Pro, Agency, and Enterprise plans.

Base URL

https://api.georank.site/api/v1

Authentication

All API requests require an API key passed via the X-API-Key header.

curl -H "X-API-Key: your_api_key_here" \
  https://api.georank.site/api/v1/dashboard/metrics

Getting your API key

Log in to your GeoRank dashboard
Go to Settings > API Keys
Click Create API Key
Copy the key — it’s only shown once

Keep your API key secret. Do not expose it in client-side code or public repositories.

Rate limits

API requests are rate limited to prevent abuse. If you exceed the limit, you’ll receive a 429 Too Many Requests response.

Response format

All responses follow this structure:

{
  "success": true,
  "data": { ... },
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 100,
    "total_pages": 5
  }
}

Error responses:

{
  "success": false,
  "error": {
    "code": 401,
    "message": "Unauthorized",
    "details": "Invalid or missing API key"
  }
}

Available endpoints

Dashboard Metrics

Get your GEO Score, mention counts, and platform breakdown.

Visibility Over Time

Get visibility data points for trend analysis.

Keywords

List and filter your tracked keywords with scores and trends.

Competitors

List competitors with GEO Scores and comparison data.

Usage

Check your current resource usage and plan limits.

​Overview

​Base URL

​Authentication

​Getting your API key

​Rate limits

​Response format

​Available endpoints

Dashboard Metrics

Visibility Over Time

Keywords

Competitors

Usage

Overview

Base URL

Authentication

Getting your API key

Rate limits

Response format

Available endpoints