Cartola FC — Free Brazilian Fantasy Football API (No Key)

TL;DR

Cartola FC is Brazil's biggest fantasy football game, and its unofficial API exposes team scores, player performance data, round results, and league standings. Check partial scores during matches, view top players per round, and track your team's performance. The API is used by thousands of developers to build companion apps, stat trackers, and bots. No official API key is required for public endpoints.

Quick start: https://api.cartolafc.globo.com/atletas/pontuados

No API key needed — free fantasy football data!

How to Use This API

1. Get Scored Athletes for Current Round

Returns all players who have scored points in the current round, with their scores:

https://api.cartolafc.globo.com/atletas/pontuados

2. Get Round Marketplace Data

View all players available in the market with their prices and ownership stats:

https://api.cartolafc.globo.com/mercado/status

3. Get Team by Slug

https://api.cartolafc.globo.com/time/slug/seu-time-aqui

4. JavaScript — Top Scorers

fetch('https://api.cartolafc.globo.com/atletas/pontuados')
  .then(r => r.json())
  .then(data => {
    const scored = Object.values(data.atletas);
    scored.sort((a, b) => b.pontuacao - a.pontuacao);
    scored.slice(0, 10).forEach((p, i) => {
      console.log(`${i+1}. ${p.apelido} (${p.clube}) - ${p.pontuacao} pts`);
    });
  });

5. Python — Check Round Status

import requests

status = requests.get(
    'https://api.cartolafc.globo.com/mercado/status'
).json()

print(f"Round: {status['rodada_atual']}")
print(f"Status: {status['status_mercado']}")
print(f"Open: {status['mercado_aberto']}")

Scored athletes: https://api.cartolafc.globo.com/atletas/pontuados

Try This URL Now

Frequently Asked Questions

Is this the official Cartola FC API?: This is an unofficial API that mirrors the data used by the Globo.com Cartola FC platform. It exposes public endpoints used by the official website and app.
What data is available for each player?: Each athlete entry includes apelido (nickname), clube (club), posicao (position), pontuacao (score), preco (price), media (average points), and escudo (team badge URL).
How often is the data updated?: Player scores update in near real-time during matches. The marketplace data updates after each round closes. Status endpoint reflects current game state.
Can I search for specific teams or players?: Yes — you can query team data by slug (URL-friendly name) via /time/slug/{slug}. Player data is available through the scored athletes and marketplace endpoints.
Is there documentation for all endpoints?: The Cartola FC API is community-documented on GitHub. The most popular reference is the wgenial/cartrolandofc repository which catalogs endpoints, authentication, and response schemas.
Does this work for past rounds?: The primary endpoints focus on the current round. Historical round data may be available through some community endpoints but is not officially documented.

API Details

API URL: https://api.cartolafc.globo.com/
Documentation: github.com/wgenial/cartrolandofc
Category: Sports
Authentication: Not Required
Geographic Coverage: Brazil — Brazilian Série A fantasy football

What You Can Build

Fantasy football dashboard showing real-time team scores and rankings
Player price tracker and value analysis tool for market decisions
League manager app comparing performance across friends' teams
Top scorers leaderboard updated during matches
Bot for Discord or Telegram posting round results and milestones