canonical: https://jentic.com/apis/ballranks.com/ballranks # Ball Ranks API The Ball Ranks API serves read-only fantasy basketball and football rankings and projections produced by the Ball Ranks model. It returns weekly and season rankings and per-player rankings and projections, so fantasy tools can pull model output directly rather than scraping a site. Anonymous requests receive lower limits and Model v0 output, while an API key unlocks higher model versions. ## For AI agents Fetch read-only fantasy basketball and football rankings and per-player projections from the Ball Ranks model, for weekly and season horizons. An API key unlocks higher model versions. ## Scope Does not handle live scores, betting odds, or roster transactions. Use for fantasy basketball and football rankings and projections only. ## Capabilities - Get weekly fantasy football rankings for the current slate - Retrieve season-long fantasy rankings - Look up an individual player's season ranking - Get a player's projection from the Ball Ranks model - Access higher projection model versions by sending a Ball Ranks API key ## Use cases ### Agent-driven lineup assistant An AI agent helping with a fantasy lineup can pull the current weekly rankings and a specific player's projection and turn them into a start-or-sit recommendation. Because the Ball Ranks API returns model output directly, the agent works from the same projections the model produces rather than parsing a web page. Example prompt: Get this week's fantasy football rankings and the projection for a named player, then recommend start or sit ### Draft preparation Before a fantasy draft, a manager needs season-long rankings to build a board. The Ball Ranks API returns season rankings and per-player season rankings, so a draft tool can assemble a ranked board and look up any individual player on demand. An API key raises the model version used for the numbers. Example prompt: Retrieve the season rankings and the season ranking for a specific player to seed a draft board ### Weekly projection sync A fantasy app that refreshes each game week can pull the weekly rankings and player projections on a schedule to keep its own views current. The API's weekly and per-player endpoints give a stable shape to sync, and anonymous access covers Model v0 while a key moves the sync to a higher model version. Example prompt: Fetch the weekly rankings and a player's weekly projection on a schedule to refresh an app's fantasy views ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/api/v1/rankings/weekly` | Get weekly fantasy football rankings | | GET | `/api/v1/rankings/season` | Get season rankings | | GET | `/api/v1/players/{player}/rankings` | Get a player's season ranking | | GET | `/api/v1/players/{player}/projections` | Get a player's projection | ## Key resources - **Rankings** — Weekly and season fantasy rankings - **Players** — Per-player season rankings and projections ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 69 / 100 - **Maturity:** AI-Aware - **Dimensions:** - Foundational Compliance: 100 / 100 - Developer Experience & Jentic Compatibility: 70 / 100 - AI-Readiness & Agent Experience: 50 / 100 - Agent Usability: 94 / 100 - Security: 60 / 100 - AI Discoverability: 69 / 100 - **View full report:** https://jentic.com/apis/ballranks.com/ballranks/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring the Ball Ranks API by hand means handling its optional bearer key, the anonymous-versus-keyed model-version difference, and parsing each ranking and projection shape yourself. Through Jentic you install once, import Ball Ranks from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** Ball Ranks exposes only read operations, and a rule bounds which of them your agent may call, such as rankings and projections. You choose the operations it may call, so the agent cannot reach beyond the reads you allow. - **Credential handling:** Your Ball Ranks key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'get fantasy rankings' or 'get a player's projection', and Jentic returns the matching Ball Ranks operation with its input schema so the agent calls the right endpoint without reading the reference docs. ## Related APIs - **Sportmonks** — Sportmonks provides broad sports data and stats, where Ball Ranks focuses on fantasy rankings and model projections. - **API-Sports** — API-Sports offers fixtures, scores, and statistics across sports, where Ball Ranks returns ranked fantasy output. - **PandaScore** — PandaScore adds esports and live match data alongside Ball Ranks fantasy projections. ## FAQ ### What authentication does the Ball Ranks API use? The Ball Ranks API accepts an optional Ball Ranks API key as a bearer token, as declared in its OpenAPI spec. Anonymous requests are allowed with lower limits and Model v0 output. Through Jentic the key is stored once and injected at call time, so it never appears in your agent's prompt or logs. ### Does an API key change what the Ball Ranks API returns? Yes. Anonymous requests receive Model v0 output and lower limits, while sending a Ball Ranks API key as a bearer token unlocks higher model versions for the rankings and projections. ### What are the rate limits for the Ball Ranks API? The OpenAPI spec notes that anonymous requests receive lower limits than keyed ones but does not state numeric values. Check the vendor documentation at https://ballranks.com for current limits before running frequent syncs. ### How do I get fantasy rankings through Jentic with the Ball Ranks API? Search Jentic for 'get fantasy rankings', which returns the GET `/api/v1/rankings/weekly` operation with its input schema, then call it. To run it on your own infrastructure, install Jentic One from its GitHub repo. ### Can I limit what my agent is allowed to do with the Ball Ranks API? Yes. Write a rule that allows only the rankings and projections read operations, so the agent can fetch fantasy data and nothing else, and every call it makes is logged. Ball Ranks exposes only read endpoints, so no rule can let it write.