Geography

Returns scan counts grouped by country for the authenticated workspace. Country codes follow the ISO 3166-1 alpha-2 standard. Results are sorted by count in descending order.

GET /v1/analytics/geography

analytics:read

Parameters

This endpoint takes no parameters.

Request examples

curl

curl https://xqr.co/api/v1/analytics/geography \
  -H "Authorization: Bearer YOUR_API_KEY"

TypeScript

const res = await fetch("https://xqr.co/api/v1/analytics/geography", {
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
  },
});

const { data, meta } = await res.json();

Python

import httpx

res = httpx.get(
    "https://xqr.co/api/v1/analytics/geography",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)

countries = res.json()["data"]

Response

200 OK

{
  "data": [
    { "country": "US", "count": 8421 },
    { "country": "DE", "count": 3892 },
    { "country": "JP", "count": 2145 },
    { "country": "GB", "count": 1876 },
    { "country": "FR", "count": 1203 },
    { "country": "BR", "count": 987 },
    { "country": "CA", "count": 754 }
  ],
  "meta": {
    "request_id": "req_j1k2l3",
    "rate_limit": {
      "remaining": 91,
      "reset_at": "2026-03-21T12:01:00Z"
    }
  }
}