Duolingo Tracker Skill

Fetch Duolingo user stats via the unofficial Duolingo API. No official API key required — uses the same endpoints the Duolingo web app uses.

Authentication setup

Duolingo does not offer an official public API. The tracker uses the cookie-based session token from an active browser session.

One-time setup:

1. Log in to duolingo.com in your browser
2. Open DevTools → Application → Cookies → duolingo.com
3. Copy the value of the jwt_token cookie
4. Save it: export DUOLINGO_JWT="your_token_here"

Alternatively the user can provide their username only — a subset of public stats is available without auth.

Base URL

https://www.duolingo.com/2017-06-30

All requests should include:

Accept: application/json
Content-Type: application/json
Authorization: Bearer $DUOLINGO_JWT   # omit if unauthenticated

Fetch user profile and streak

curl -s "https://www.duolingo.com/2017-06-30/users?username=USERNAME&fields=streak,xpGoal,xpGoalMetToday,lingots,totalXp,currentCourse,courses,streakData" \
  -H "Authorization: Bearer $DUOLINGO_JWT" \
  -H "Accept: application/json"

Key fields to surface:

Fetch leaderboard / league info

# Get user ID first from profile, then:
curl -s "https://duolingo-leaderboards-prod.duolingo.com/leaderboards/7d9f5dd1-8423-491a-91f2-2532052038d8/users/USER_ID?get_users_only=true" \
  -H "Authorization: Bearer $DUOLINGO_JWT"

League tiers (low → high): Bronze, Silver, Gold, Sapphire, Ruby, Emerald, Amethyst, Pearl, Obsidian, Diamond.

Fetch XP summary (last 7 days)

curl -s "https://www.duolingo.com/2017-06-30/users/USER_ID/xp_summaries?startDate=YYYY-MM-DD" \
  -H "Authorization: Bearer $DUOLINGO_JWT"

Set startDate to 7 days ago. Returns daily XP totals — use these to show a mini chart or bar summary.

Displaying results

Present stats in this format:

🔥 Streak: 47 days  (longest: 93 days)
⭐ Today: 150 XP / 100 XP goal ✓
📚 Active course: Spanish (es) — 3,420 XP, 42 crowns
🏆 League: Gold  |  Weekly XP: 892

Weekly XP:
Mon ████████ 180
Tue ██████   120
Wed █████    100
Thu ████████ 160
Fri ██████   132
Sat ███      60 
Sun ████████ 140

If the daily goal is not yet met, flag it clearly so the user knows to practice today.

Public stats (no auth required)

For users who don't want to share their JWT, these endpoints work without auth for public profiles:

curl -s "https://www.duolingo.com/users/USERNAME" \
  -H "Accept: application/json"

Returns streak, learning_language, level, totalXp, courses. Fewer fields but sufficient for a quick summary.

Common issues

Privacy note

Always remind the user that their JWT token is sensitive — treat it like a password. Never log it or include it in outputs.