Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.rolearn.dev/llms.txt

Use this file to discover all available pages before exploring further.

The RoLearn API provides programmatic access to all platform data — trending games, forecasts, genre analytics, and more.

​
Base URL

https://rolearn.dev/api

​
Authentication

Most endpoints require a JWT token obtained via the login endpoint. Include it as a Bearer token: 
curl -H "Authorization: Bearer YOUR_TOKEN" https://rolearn.dev/api/trending
Some read-only endpoints (trending, market overview) work without authentication but return limited data based on plan.

​
Rate Limits

Rate limits vary by plan and endpoint. The API returns standard HTTP 429 responses when limits are exceeded.

​
Response Format

All responses are JSON. Successful responses return the data directly. Errors return: 
{
  "detail": "Error description"
}

​
Plan-Based Access

Many endpoints gate their response based on your subscription plan:
  • Explorer (Free): Limited data (e.g., 10 trending games, score-only ML predictions)
  • Builder: Extended data (e.g., 50 trending games, detailed predictions)
  • Studio: Full access (unlimited results, AI features, confidence intervals)
Some fields are restricted based on your plan level. Upgrade to access additional data.