Scores for pay

Agencies pay their tutors on their own schedule. To support that, Telureo publishes every tutor’s and every agency’s score for any period, updated as YouTube reports each lecture.

The scores API

Ask for a UTC day, a Monday-to-Sunday week, or a calendar month with period, and any date in it:

curl "https://web-production-eecc0.up.railway.app/api/scores?period=week&date=2026-10-14"

For every lecture so far, ask for period=all, with no date.

For any range of up to 366 days, use from and to:

curl "https://web-production-eecc0.up.railway.app/api/scores?from=2026-10-01T00:00:00Z&to=2026-11-01T00:00:00Z"

The response lists tutors and agencies, best first:

{
  "period": "range",
  "from": "2026-10-01T00:00:00+00:00",
  "to": "2026-11-01T00:00:00+00:00",
  "awaiting_lectures": 4,
  "tutors": [
    { "rank": 1, "tutor_id": "…", "name": "Amara Okafor", "score": 77740, "lectures": 9, "awaiting": 1,
      "agency": { "hotkey": "5F…", "name": "Bright Minds Academy" } }
  ],
  "agencies": [
    { "rank": 1, "hotkey": "5F…", "name": "Bright Minds Academy", "score": 220970, "lectures": 45, "tutors": 5,
      "awaiting": 2, "registered": true }
  ]
}

• score is the sum of the live watch-minutes of the lectures that ended in the period.
• lectures counts the lectures with a score. awaiting counts lectures that ended but have no score from YouTube yet.
• An agency’s score counts the lectures booked under it, even if a tutor has moved on since.
• A tutor’s row counts all their lectures in the period, under any agency, and its agency is the agency they’re in now. After a tutor switches agency, pay from your agency’s own row and lecture list, not from the tutor’s total.
• Equal scores share a rank.
• generated_at is when the response was made.
• from and to need a time zone, such as Z for UTC. A lecture that ends exactly at to belongs to the next range.

When the numbers are final

YouTube reports a lecture about 48 hours after it ends. We update the number every 30 minutes, and it’s final 120 hours (5 days) after the end. So:

• for running estimates, read the current period at any time
• for final pay, read a period at least 5 days after it ends

Your own report

edu miner report shows your agency’s tutors, their lectures, and their contribution to your current score in the validators’ scoring window. Add --json for everything.