Traffi GEO API

# cURL example
curl -X POST https://traffi.app/api/public/geo/register \
  -H "Content-Type: application/json" \
  -d '{"email": "dev@example.com", "name": "Jane Dev"}'

// Response
{
  "success": true,
  "api_key": "tgeo_live_a1b2c3d4...",    // SAVE THIS — shown once only
  "key_prefix": "tgeo_live_a1b2",
  "email": "dev@example.com",
  "tier": "free",
  "daily_limit": 100,
  "attribution_required": true,
  "message": "Free tier activated (100 req/day). Attribution required.",
  "docs": "https://traffi.app/geo-api/docs",
  "note": "Save your API key — it will not be shown again."
}

GET /api/public/geo/v1/score?domain=notion.so&api_key=YOUR_KEY

{
  "api_version": "v1",
  "domain": "notion.so",
  "geo_score": 74,
  "engines": {
    "chatgpt": 82,
    "perplexity": 71,
    "claude": 68,
    "gemini": 73,
    "grok": 76
  },
  "vertical": "SaaS",
  "global_rank": 142,
  "vertical_rank": 23,
  "status": "completed",
  "last_updated": "2026-04-07T00:00:00.000Z",
  "powered_by": "Traffi GEO Index — traffi.app",
  "attribution_required": true,
  "attribution_html": "<a href='https://traffi.app'>Powered by Traffi GEO</a>"
}

GET /api/public/geo/v1/history?domain=notion.so&period=90d&api_key=YOUR_KEY

{
  "api_version": "v1",
  "domain": "notion.so",
  "period": "90d",
  "data_points": 13,
  "history": [
    { "week": "2026-01-05", "score": 68 },
    { "week": "2026-01-12", "score": 71 },
    // ...
  ],
  "powered_by": "Traffi GEO Index — traffi.app"
}

GET /api/public/geo/v1/leaderboard?vertical=SaaS&limit=10&api_key=YOUR_KEY

{
  "api_version": "v1",
  "vertical": "SaaS",
  "count": 10,
  "results": [
    {
      "rank": 1,
      "domain": "notion.so",
      "geo_score": 91,
      "engines": { "chatgpt": 95, "perplexity": 88, ... },
      "vertical": "SaaS",
      "last_updated": "2026-04-07T00:00:00.000Z"
    }
  ],
  "powered_by": "Traffi GEO Index — traffi.app"
}

GET /api/public/geo/v1/compare?domains=notion.so,linear.app,figma.com&api_key=YOUR_KEY

{
  "api_version": "v1",
  "count": 3,
  "leader": "figma.com",
  "comparison": [
    { "domain": "notion.so", "geo_score": 74, "engines": {...}, ... },
    { "domain": "linear.app", "geo_score": 68, "engines": {...}, ... },
    { "domain": "figma.com", "geo_score": 86, "engines": {...}, ... }
  ],
  "powered_by": "Traffi GEO Index — traffi.app"
}

GET /api/public/geo/v1/verticals?api_key=YOUR_KEY

{
  "api_version": "v1",
  "count": 12,
  "verticals": [
    { "vertical": "SaaS",          "domain_count": 1840, "avg_score": 64 },
    { "vertical": "AITools",       "domain_count": 920,  "avg_score": 71 },
    { "vertical": "Cybersecurity", "domain_count": 340,  "avg_score": 58 },
    // ...
  ],
  "powered_by": "Traffi GEO Index — traffi.app"
}

GET /api/public/geo/v1/stats?api_key=YOUR_KEY

{
  "api_version": "v1",
  "total_domains":  12840,
  "public_domains": 10200,
  "completed":      9880,
  "avg_score":      62,
  "by_vertical": [
    { "vertical_category": "SaaS", "count": "1840", "avg_score": "64" }
  ],
  "last_updated":   "2026-04-07T09:52:05.000Z",
  "powered_by":     "Traffi GEO Index — traffi.app"
}