Hackathons and stats

These endpoints read the hackathon database: one hackathon by id, a filtered CSV export, and four market stats endpoints. All of them need an API key. See Authentication and keys.

Fetch one hackathon

GET /api/hackathons/{id} returns one hackathon with its sponsors, organizers and quality score. {id} is either the UUID or the slug from the hackathon's page URL (/database/hackathon/<slug>).

curl https://www.hackathonradar.com/api/hackathons/treeline-hacks \
  -H "Authorization: Bearer $HACKATHONRADAR_API_KEY"

{
  "id": "6fa487e4-c891-456f-81f1-2a4bedc12967",
  "slug": "treeline-hacks",
  "title": "TreeLine Hacks",
  "start_at": "2026-03-06T16:45:00.000Z",
  "end_at": "2026-03-08T16:45:00.000Z",
  "timezone": "America/Los_Angeles",
  "type": "online",
  "categories": ["AI/ML", "Sustainability"],
  "prize_pool": 5000,
  "prize_currency": "USD",
  "prize_pool_usd": 5000,
  "city": null,
  "country": null,
  "website_url": "https://treelinehacks.example.com",
  "registration_url": "https://treelinehacks.example.com/register",
  "participant_count": 250,
  "student_only": false,
  "data_quality_score": 85,
  "is_deleted": false,
  "sponsors": [{ "id": "...", "name": "Acme Cloud", "domain": "acme.com", "email": null }],
  "organizers": [{ "id": "...", "name": "Treeline Hacks", "email": "team@treelinehacks.example.com", "email_confidence": 0.92 }],
  "quality_score": { "score_total": 55, "confidence": 0.81, "score_version": "v2", "breakdown_json": {}, "reasons_json": [], "computed_at": "..." }
}

An unknown id returns 404 Hackathon not found.

The hackathon object

The response can include other fields. Only the fields in this table are supported, so do not build on the rest.

Export hackathons as CSV

There is no JSON list or search endpoint for hackathons. To pull many at once, use GET /api/hackathons/export, which returns a CSV file (hackathons-export-YYYY-MM-DD.csv).

curl "https://www.hackathonradar.com/api/hackathons/export?active=true&type=in-person&country=United%20Kingdom&columns=title,start_at,end_at,city,prize_pool,organizers,primary_organizer_email,website_url" \
  -H "Authorization: Bearer $HACKATHONRADAR_API_KEY" \
  -o hackathons.csv

Column keys: title, description, type, start_at, end_at, duration, participant_count, prize_pool, location, city, country, organizers, primary_organizer_email, categories, sponsors, student_only, cash_prizes, vibe_code_friendly, travel_support, language, timezone, venue_name, address, website_url, first_seen_at, last_seen_at. Columns always come out in this order, whatever order you pass.

CSV values are formatted for reading: dates as DD/MM/YYYY, website_url as the bare domain, prize_pool as 5,000 USD, student_only and cash_prizes as Yes or No, and lists joined with ; .

Stats endpoints

All four are GET requests that return JSON computed across the whole database. The figures refresh about once an hour.

On /api/stats/trends and /api/stats/prize-pools, timeRange (week, month, quarter, year or all) sets the window for the time series. It defaults to year on trends and all on prize pools.

curl "https://www.hackathonradar.com/api/stats/trends?timeRange=quarter" \
  -H "Authorization: Bearer $HACKATHONRADAR_API_KEY"

Percentage fields (percentage and growthRate) are already percentages, so 22.4 means 22.4%. Money values are in USD. generatedAt is when the figures were computed, so use it to label charts ("as of ...").