A FastAPI + uv service for exploring public HackerRank profiles, stats, and activity.

Live dashboard at the root route (/) — enter any public HackerRank username to get a full profile view with heatmap, badges, recent submissions, and contest history.

All endpoints accept a public HackerRank username and return JSON.

GET /{username}#

Aggregated stats: solved challenge count, best active practice-track rank, practice score, reputation, profile level, and submission calendar.

{
  "status": "success",
  "totalSolved": 8,
  "ranking": 527450,
  "contributionPoints": 5,
  "practiceScore": 70,
  "reputation": 0,
  "submissionCalendar": {}
}

GET /{username}/profile#

Full profile: avatar, real name, country, company, school, skill tags, bio, social links, badges, recent submissions, and per-track submission stats.

GET /{username}/heatmap#

Daily contribution heatmap built from submission history, including current streak, longest streak, active days, and per-day activity levels (0–4).

Note: HackerRank’s public submission history endpoint may return empty data for some profiles even when activity exists.

GET /{username}/badges#

Awarded badges and the inferred active badge (highest stars/level).

GET /{username}/contests#

Contest participation history, rating, global ranking, and top percentile. Returns an empty history for users with no contest participation.

uv sync
uv run uvicorn main:app --reload --host 0.0.0.0 --port 58352

Open:

• http://localhost:58352/ — visual profile dashboard
• http://localhost:58352/docs — Swagger UI

# Quick smoke test with a known public profile
curl http://localhost:58352/shauryarahlon_10

# Run unit tests
uv run python -m unittest discover -s tests

• All data comes from public HackerRank endpoints — no authentication required.
• practiceScore is HackerRank’s per-track score total. It is not the same thing as solved challenge count.
• ranking is the best rank among tracks with non-zero practice score. It is not a global profile rank.
• Difficulty breakdown (easy/medium/hard), platform-wide totals, and acceptance rate are not available from public HackerRank data and default to neutral/null values in the canonical payload.