​

Geographic Analytics

​

Endpoints

​

Workspace geography

• GET /api/analytics/workspace/regions
• GET /api/analytics/workspace/continents
• GET /api/analytics/city/breakdown
• GET /api/analytics/workspace/coordinates

​

Link geography

• GET /api/analytics/:linkId/geo
• GET /api/analytics/:linkId/cities
• GET /api/analytics/:linkId/regions
• GET /api/analytics/:linkId/continents
• GET /api/analytics/:linkId/coordinates

​

Query parameters

​

Request example

curl -X GET "https://api.linquid.io/api/analytics/workspace/regions?days=30&country=US&limit=20" \
  -H "Authorization: Bearer <session_or_api_key>" \
  -H "X-Workspace-Id: ws_123"

​

Response example

{
  "success": true,
  "data": [
    {
      "country": "US",
      "dimension": "California",
      "clicks": 5200,
      "unique_clicks": 4110,
      "percentage": 41.5
    }
  ]
}

​

Notes

• Geographic rows return click totals and percentages for the selected window.
• Map coordinate endpoints may return empty arrays when coordinate pipelines are not enabled for your dataset.
• Use link-scoped routes for per-link geo diagnostics; use workspace routes for top-level distribution.