API Documentation

Free tier மற்றும் premium tier இரண்டிற்கும் ஒரே endpoint surface; premium key இருந்தால் விரிவான fields கிடைக்கும்.

Base URL

/api/v1

Authentication

Optional Bearer token: Authorization: Bearer <API_KEY>

Endpoints

  • GET /api/v1/health
  • GET /api/v1/politicians?page=1&pageSize=20
  • GET /api/v1/politician/:id
  • GET /api/v1/promises/:politicianId
  • GET /api/v1/leaderboard?type=gap|reality|dark_horse
  • GET /api/v1/search?q=query&topK=10
  • POST /api/v1/webhooks/stripe

Quick Start

curl -s https://greatidude.com/api/v1/leaderboard?type=gap

curl -s https://greatidude.com/api/v1/politician/mk-stalin \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -s "https://greatidude.com/api/v1/search?q=education"