Open Data Platform

API ஆவணங்கள் Civic Intelligence API

Access politician profiles, gap scores, election data, and promise tracking for Tamil Nadu. Free tier includes 100 requests/day. No API key required.

Interactive Swagger UI → OpenAPI Spec ↗

Quick Start

Get started in seconds. No authentication required for the free tier.

bash

# Fetch the gap score leaderboard
curl -s https://api.greatidude.com/api/v1/leaderboard?type=gap | jq '.data'

# Get a single politician's profile
curl -s https://api.greatidude.com/api/v1/politician/mk-stalin

# Search for a politician or topic
curl -s "https://api.greatidude.com/api/v1/search?q=education+promise"

# TN 2026 election insights
curl -s https://api.greatidude.com/api/v1/election/tn-assembly-2026/insights

Authentication

Free Tier

100 requests/day. No API key needed. Includes core politician data, leaderboard, and search.

Premium Tier

10,000 requests/day. Includes detailed scores, methodology metadata, source citations, and financial disclosures.

Authorization: Bearer YOUR_API_KEY

Endpoint Reference

Politicians

GET /api/v1/politicians List all politicians (paginated)

GET /api/v1/politician/:id Get politician profile with gap score

GET /api/v1/politician/:id/candidacies Election history across all cycles

GET /api/v1/politician/:id/corrections Data correction history

GET /api/v1/politician/:id/evidence Source evidence for scoring

Elections

GET /api/v1/elections List all tracked elections

GET /api/v1/election/:id/insights Compact election insights (party tally, margins)

GET /api/v1/election/:id/winners All winners for an election

GET /api/v1/candidates All candidates across elections

Constituencies

GET /api/v1/constituencies List all constituencies

GET /api/v1/constituency/:name/history Historical election results for a constituency

GET /api/v1/constituency/:name/summary Constituency overview with dominant party

Promises & Government Watch

GET /api/v1/promises/:politicianId Promises for a politician

GET /api/v1/manifesto Government manifesto tracker items

GET /api/v1/government-watch/summary Manifesto progress summary stats

Leaderboard & Search

GET /api/v1/leaderboard?type=gap|reality Top and bottom-ranked politicians

GET /api/v1/search?q=query Semantic + full-text search

GET /api/v1/myvote/lookup?pincode=600001 Pincode → constituency resolution

Machine-Consumable Snapshots

GET /api/v1/snapshots/politician/:id Citation-backed answer object

GET /api/v1/snapshots/leaderboard Compact leaderboard for AI extraction

GET /api/v1/snapshots/constituency/:name Compact constituency snapshot

Alerts & Subscriptions

POST /api/v1/alerts/subscribe Subscribe to politician/constituency alerts

POST /api/v1/alerts/verify Verify OTP for subscription

GET /api/v1/alerts/manage?contact=... List active subscriptions

Try It Live

Enter an endpoint path and see the response in real time.

// Response will appear here

Data Licence & Citation

📜 Licence

All data is available under CC BY-NC 4.0. Free for academic research, journalism, and non-commercial civic applications. Commercial use requires a Premium API key.

📝 Citation Format

Greatidude Civic Intelligence Platform.
"Tamil Nadu Politician Gap Scores."
https://greatidude.com, accessed 1/6/2026.
Licence: CC BY-NC 4.0.

Embed Widget for Publishers

Embed a live politician scorecard in your news article or blog with one line of code. No cookies, no tracking on your domain.

<div data-greatidude-embed="mk-stalin"></div>
<script src="https://greatidude.com/embed.js" async></script>

Preview embed demo →

Rate Limits

Rate limit headers are returned with every response:

Header	Description
`X-RateLimit-Limit`	Daily request cap for your tier
`X-RateLimit-Remaining`	Requests remaining today
`X-RateLimit-Reset`	Unix timestamp of midnight UTC reset