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"