v1 API

API Documentation

Access Geo Scorely data programmatically. The public API provides domain scores, citation data, and leaderboard rankings.

Base URL

https://geoscorely.com/api/v1

Authenticated endpoints require a Bearer token in the Authorization header. Get your API key from the Dashboard → Settings → API Keys.

Authorization: Bearer YOUR_API_KEY

GET/api/v1?domain=example.comPublic

Returns the GEO score and grade for a domain.

Query Parameters

domainstring, required — the domain to look up (e.g. "example.com")

Example Response

{
  "domain": "example.com",
  "score": 72,
  "grade": "B",
  "siteType": "business",
  "scannedAt": "2026-04-10T14:32:00Z"
}

GET/api/v1/indexPublic

Returns a list of domains with their scores (leaderboard data).

Query Parameters

limitinteger, optional — max results (default 20, max 100)

offsetinteger, optional — pagination offset (default 0)

GET/api/healthPublic

Health check endpoint. Returns 200 when the API is operational.

400Bad Request — missing or invalid parameters

401Unauthorized — missing or invalid API key

403Forbidden — plan limit reached or access denied

404Not Found — domain not in our index yet

429Too Many Requests — rate limit exceeded

500Internal Server Error — something went wrong on our end