Primeiros passos

Assine o plano grátis, copie sua chave e faça a primeira chamada em poucos minutos.

1. Assine um plano

A assinatura é feita pela RapidAPI. Crie sua conta, abra a página da API Dados Futebol e assine o plano BASIC, que é gratuito e tem 100 requisições por dia. Você pode mudar de plano a qualquer momento.

2. Copie sua chave

Depois de assinar, a RapidAPI mostra sua chave pessoal (x-rapidapi-key) nos exemplos de código da página da API. Guarde a chave em uma variável de ambiente e nunca a publique no código do seu site ou app.

3. Faça a primeira chamada

Toda requisição precisa de dois cabeçalhos:

Cabeçalho	Valor
`x-rapidapi-host`	`futapi.p.rapidapi.com`
`x-rapidapi-key`	Sua chave

curl --request GET \
  --url 'https://futapi.p.rapidapi.com/v1/competitions' \
  --header 'x-rapidapi-host: futapi.p.rapidapi.com' \
  --header 'x-rapidapi-key: SUA_CHAVE'

const response = await fetch("https://futapi.p.rapidapi.com/v1/competitions", {
  headers: {
    "x-rapidapi-host": "futapi.p.rapidapi.com",
    "x-rapidapi-key": process.env.RAPIDAPI_KEY,
  },
});
const { data } = await response.json();

import os
import requests

response = requests.get(
    "https://futapi.p.rapidapi.com/v1/competitions",
    headers={
        "x-rapidapi-host": "futapi.p.rapidapi.com",
        "x-rapidapi-key": os.environ["RAPIDAPI_KEY"],
    },
)
data = response.json()["data"]

Resposta:

{
  "data": [
    {
      "id": "cp_4k6Pew8vntAF",
      "name": "Premier League",
      "country_code": "ENG",
      "type": "league",
      "current_season": "2026/2027"
    }
  ],
  "paging": null,
  "meta": null
}

4. Siga o fluxo mais comum

GET /v1/competitions para obter o id da competição (cp_...).
GET /v1/competitions/{competition_id}/seasons para ver as temporadas.
GET /v1/competitions/{competition_id}/matches?season=2025/2026 para o calendário, ou GET /v1/matches?date=2026-11-07 para todos os jogos de um dia.
Com o id da partida (mt_...):
- GET /v1/matches/{match_id} para placar, formações, estádio e árbitro
- /events, /lineups e /stats para os detalhes da partida (PRO)
- /players para estatísticas, xG e ratings dos jogadores (ULTRA)
- /prediction e /h2h para os próximos jogos (ULTRA)
Ids de times (tm_...) e jogadores (pl_...) que aparecem nas respostas podem ser consultados em /v1/teams/{team_id} e /v1/players/{player_id}.