Exemplos

Chamadas prontas para os casos de uso mais comuns.

Nos exemplos abaixo, cp_4k6Pew8vntAF é a Premier League. Envie os cabeçalhos x-rapidapi-host e x-rapidapi-key em todas as chamadas, como em Primeiros passos.

Jogos de hoje no horário de Brasília

GET /v1/matches?timezone=America/Sao_Paulo

Jogos de um período

GET /v1/competitions/cp_4k6Pew8vntAF/matches?from=2026-11-01&to=2026-11-30&timezone=America/Sao_Paulo

Jogos de um time na temporada

GET /v1/teams/{team_id}/matches?competition=cp_4k6Pew8vntAF&season=2025/2026&status=finished

Tabela só com jogos em casa de uma temporada anterior

GET /v1/competitions/cp_4k6Pew8vntAF/standings?season=2024/2025&venue=home

Artilharia

GET /v1/competitions/cp_4k6Pew8vntAF/players/stats?sort=goals&limit=10

Melhores ratings com pelo menos 900 minutos (ULTRA)

GET /v1/competitions/cp_4k6Pew8vntAF/players/stats?sort=rating&min_minutes=900&limit=10

Líderes de xG (ULTRA)

GET /v1/competitions/cp_4k6Pew8vntAF/players/stats?sort=xg&limit=10

Médias em casa de todos os times: escanteios, cartões e gols (PRO)

GET /v1/competitions/cp_4k6Pew8vntAF/teams/stats?venue=home

Estatísticas do segundo tempo de uma partida (PRO)

GET /v1/matches/{match_id}/stats?period=second_half

Probabilidades e confronto direto dos jogos de hoje (ULTRA)

GET /v1/matches?status=scheduled&timezone=America/Sao_Paulo
GET /v1/matches/{match_id}/prediction
GET /v1/matches/{match_id}/h2h

Percorrer todas as páginas de uma lista

async function fetchAll(path) {
  const items = [];
  let cursor = null;
  do {
    const url = new URL(`https://futapi.p.rapidapi.com${path}`);
    url.searchParams.set("limit", "100");
    if (cursor) url.searchParams.set("cursor", cursor);
    const response = await fetch(url, {
      headers: {
        "x-rapidapi-host": "futapi.p.rapidapi.com",
        "x-rapidapi-key": process.env.RAPIDAPI_KEY,
      },
    });
    const body = await response.json();
    items.push(...body.data);
    cursor = body.paging?.next_cursor ?? null;
  } while (cursor);
  return items;
}

const matches = await fetchAll("/v1/competitions/cp_4k6Pew8vntAF/matches");