Documentação da API

Autenticação

Header obrigatório

Envie x-betapi-key em todas as chamadas autenticadas. Para compatibilidade com a API original, x-apisports-key também é aceito como alias.

Uso recomendado

Faça chamadas server-to-server ou a partir do backend do seu produto.

Base padrão

https://betapi.site/app/v1/

Exemplo mínimo

GET https://betapi.site/app/v1/fixtures/?live=all
Header: x-betapi-key: SUA_CHAVE_BETAPI
Alias compatível: x-apisports-key: SUA_CHAVE_BETAPI

Limites e consumo

Os planos e recargas da BetAPI trabalham com requests por dia. Use /v1/status/ para acompanhar disponibilidade e métricas operacionais da sua integração.

Plano principal

Define a franquia diária incluída na sua conta.

Recargas

Complementam o volume disponível sem alterar o plano principal.

Observabilidade

Monitore saldo restante e comportamento do serviço via headers e endpoint de status.

Headers de resposta

Além do payload JSON, a BetAPI devolve headers úteis para billing, cache e monitoramento da integração.

Header	Tipo	Descrição
X-BetAPI-Requests-Remaining	integer	Saldo restante de requests após a chamada.
X-BetAPI-Request-Charged	integer	1 quando a chamada consumiu quota; 0 quando não consumiu.
x-ratelimit-requests-limit	integer	Limite diário exposto em formato compatível com a API original.
x-ratelimit-requests-remaining	integer	Requests restantes no período diário.
X-RateLimit-Limit	integer	Limite operacional por minuto informado ao cliente.
X-RateLimit-Remaining	integer	Saldo operacional por minuto informado ao cliente.
X-BetAPI-Cache	string	Presente em odds/cache. Valores comuns: HIT ou MISS.
X-BetAPI-Stale	integer	Presente em odds ao vivo. 1 indica resposta stale, 0 resposta atual.

Códigos de resposta

Código	Label	Descrição
200	OK	Resposta bem-sucedida.
204	No Content	Sem dados para os filtros informados.
400	Bad Request	Parâmetros inválidos.
401	Unauthorized	Chave ausente.
402	Payment Required	Saldo de requests insuficiente.
403	Forbidden	Chave inválida, conta inativa ou acesso bloqueado.
405	Method Not Allowed	Use apenas GET.
429	Too Many Requests	Limite de chamadas excedido.
500	Internal Error	Erro interno da BetAPI.
502	Bad Gateway	Falha temporária na origem de dados.

Nenhum endpoint corresponde à busca atual.

GET

Timezones

Base

/timezone/

Lista todos os timezones aceitos em endpoints de fixtures.

URL base do endpoint

https://betapi.site/app/v1/timezone/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada sem débito de saldo.

Notas

Equivalente ao endpoint /timezone da API original.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/timezone/' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/timezone/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/timezone/', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "timezone",
    "parameters": [],
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Países

Base

/countries/

Lista países disponíveis para filtros de ligas e competições.

URL base do endpoint

https://betapi.site/app/v1/countries/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
name	string	Não	Nome do país.
code	string	Não	Código do país.
search	string	Não	Busca textual com pelo menos 3 caracteres.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/countries/?name=Brazil' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/countries/?name=Brazil');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/countries/?name=Brazil', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "countries",
    "parameters": {
        "exemplo": "name=Brazil"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Troféus

Carreira

/trophies/

Lista troféus de jogador ou técnico.

URL base do endpoint

https://betapi.site/app/v1/trophies/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
player	integer	Não	ID do jogador.
players	string	Não	Até 20 IDs de jogadores separados por hífen.
coach	integer	Não	ID do técnico.
coachs	string	Não	Até 20 IDs de técnicos separados por hífen.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/trophies/?player=276' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/trophies/?player=276');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/trophies/?player=276', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "trophies",
    "parameters": {
        "exemplo": "player=276"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Sidelined

Carreira

/sidelined/

Lista períodos fora de jogadores ou técnicos.

URL base do endpoint

https://betapi.site/app/v1/sidelined/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
player	integer	Não	ID do jogador.
players	string	Não	Até 20 IDs de jogadores separados por hífen.
coach	integer	Não	ID do técnico.
coachs	string	Não	Até 20 IDs de técnicos separados por hífen.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/sidelined/?player=276' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/sidelined/?player=276');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/sidelined/?player=276', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "sidelined",
    "parameters": {
        "exemplo": "player=276"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Standings

Classificação

/standings/

Retorna classificação por liga/time e temporada.

URL base do endpoint

https://betapi.site/app/v1/standings/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
league	integer	Não	ID da liga.
season	integer	Sim	Temporada YYYY.
team	integer	Não	ID do time.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/standings/?league=39&season=2026' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/standings/?league=39&season=2026');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/standings/?league=39&season=2026', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "standings",
    "parameters": {
        "exemplo": "league=39&season=2026"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Status da conta

Conta

/status/

Retorna status operacional, plano ativo e consumo da conta BetAPI.

URL base do endpoint

https://betapi.site/app/v1/status/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada sem débito de saldo.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/status/' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/status/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/status/', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "status",
    "parameters": [],
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Estádios

/venues/

Consulta estádios por ID, nome, cidade, país ou busca.

URL base do endpoint

https://betapi.site/app/v1/venues/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
id	integer	Não	ID do estádio.
name	string	Não	Nome.
city	string	Não	Cidade.
country	string	Não	País.
search	string	Não	Busca textual.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/venues/?city=London' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/venues/?city=London');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/venues/?city=London', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "venues",
    "parameters": {
        "exemplo": "city=London"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Fixtures

/fixtures/

Lista jogos por fixture, live, data, liga, time, período, status, estádio e timezone.

URL base do endpoint

https://betapi.site/app/v1/fixtures/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
id	integer	Não	ID do fixture.
ids	string	Não	IDs separados por hífen, máximo 20.
live	string	Não	all ou IDs de ligas separados por hífen.
date	string	Não	Data YYYY-MM-DD.
league	integer	Não	ID da liga.
season	integer	Não	Temporada YYYY.
team	integer	Não	ID do time.
last	integer	Não	Últimos X jogos.
next	integer	Não	Próximos X jogos.
from	string	Não	Data inicial YYYY-MM-DD.
to	string	Não	Data final YYYY-MM-DD.
round	string	Não	Rodada.
status	string	Não	Status como NS, FT, NS-PST-FT.
venue	integer	Não	ID do estádio.
timezone	string	Não	Timezone válido.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/fixtures/?live=all' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/fixtures/?live=all');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/fixtures/?live=all', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "fixtures",
    "parameters": {
        "exemplo": "live=all"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Rodadas

Fixtures

/fixtures/rounds/

Lista rodadas de uma liga/copa por temporada.

URL base do endpoint

https://betapi.site/app/v1/fixtures/rounds/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
league	integer	Sim	ID da liga.
season	integer	Sim	Temporada YYYY.
current	boolean	Não	Retornar apenas rodada atual.
dates	boolean	Não	Incluir datas de cada rodada.
timezone	string	Não	Timezone válido.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/fixtures/rounds/?league=39&season=2026&current=true' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/fixtures/rounds/?league=39&season=2026&current=true');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/fixtures/rounds/?league=39&season=2026&current=true', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "fixtures/rounds",
    "parameters": {
        "exemplo": "league=39&season=2026&current=true"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Head to head

Fixtures

/fixtures/headtohead/

Consulta confrontos diretos entre dois times.

URL base do endpoint

https://betapi.site/app/v1/fixtures/headtohead/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
h2h	string	Sim	IDs dos times no formato ID-ID.
date	string	Não	Data YYYY-MM-DD.
league	integer	Não	ID da liga.
season	integer	Não	Temporada YYYY.
last	integer	Não	Últimos X jogos.
next	integer	Não	Próximos X jogos.
from	string	Não	Data inicial.
to	string	Não	Data final.
status	string	Não	Status.
venue	integer	Não	ID do estádio.
timezone	string	Não	Timezone válido.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/fixtures/headtohead/?h2h=33-34&last=5' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/fixtures/headtohead/?h2h=33-34&last=5');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/fixtures/headtohead/?h2h=33-34&last=5', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "fixtures/headtohead",
    "parameters": {
        "exemplo": "h2h=33-34&last=5"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Estatísticas do fixture

Fixtures

/fixtures/statistics/

Retorna estatísticas de um jogo.

URL base do endpoint

https://betapi.site/app/v1/fixtures/statistics/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
fixture	integer	Sim	ID do fixture.
team	integer	Não	ID do time.
type	string	Não	Tipo de estatística.
half	boolean	Não	Incluir dados por tempo.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/fixtures/statistics/?fixture=215662' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/fixtures/statistics/?fixture=215662');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/fixtures/statistics/?fixture=215662', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "fixtures/statistics",
    "parameters": {
        "exemplo": "fixture=215662"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Eventos do fixture

Fixtures

/fixtures/events/

Retorna gols, cartões, substituições e VAR de um jogo.

URL base do endpoint

https://betapi.site/app/v1/fixtures/events/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
fixture	integer	Sim	ID do fixture.
team	integer	Não	ID do time.
player	integer	Não	ID do jogador.
type	string	Não	Tipo: goal, card, subst, var.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/fixtures/events/?fixture=215662' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/fixtures/events/?fixture=215662');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/fixtures/events/?fixture=215662', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "fixtures/events",
    "parameters": {
        "exemplo": "fixture=215662"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Escalações

Fixtures

/fixtures/lineups/

Retorna escalações, técnico, titulares, reservas e formação.

URL base do endpoint

https://betapi.site/app/v1/fixtures/lineups/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
fixture	integer	Sim	ID do fixture.
team	integer	Não	ID do time.
player	integer	Não	ID do jogador.
type	string	Não	Tipo como startXI.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/fixtures/lineups/?fixture=592872' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/fixtures/lineups/?fixture=592872');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/fixtures/lineups/?fixture=592872', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "fixtures/lineups",
    "parameters": {
        "exemplo": "fixture=592872"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Estatísticas de jogadores no fixture

Fixtures

/fixtures/players/

Retorna estatísticas dos jogadores em um jogo.

URL base do endpoint

https://betapi.site/app/v1/fixtures/players/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
fixture	integer	Sim	ID do fixture.
team	integer	Não	ID do time.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/fixtures/players/?fixture=169080' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/fixtures/players/?fixture=169080');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/fixtures/players/?fixture=169080', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "fixtures/players",
    "parameters": {
        "exemplo": "fixture=169080"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Temporadas de jogadores

Jogadores

/players/seasons/

Lista temporadas disponíveis para estatísticas de jogadores.

URL base do endpoint

https://betapi.site/app/v1/players/seasons/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
player	integer	Não	ID do jogador opcional.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/players/seasons/' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/players/seasons/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/players/seasons/', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "players/seasons",
    "parameters": [],
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Perfis de jogadores

Jogadores

/players/profiles/

Lista perfis de jogadores disponíveis, com paginação.

URL base do endpoint

https://betapi.site/app/v1/players/profiles/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
player	integer	Não	ID do jogador.
search	string	Não	Busca por sobrenome.
page	integer	Não	Página.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/players/profiles/?search=ney' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/players/profiles/?search=ney');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/players/profiles/?search=ney', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "players/profiles",
    "parameters": {
        "exemplo": "search=ney"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Estatísticas de jogadores

Jogadores

/players/

Retorna estatísticas de jogadores por jogador, time, liga, temporada, busca e página.

URL base do endpoint

https://betapi.site/app/v1/players/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
id	integer	Não	ID do jogador.
team	integer	Não	ID do time.
league	integer	Não	ID da liga.
season	integer	Não	Temporada YYYY.
search	string	Não	Busca por nome.
page	integer	Não	Página.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/players/?team=33&season=2026&page=1' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/players/?team=33&season=2026&page=1');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/players/?team=33&season=2026&page=1', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "players",
    "parameters": {
        "exemplo": "team=33&season=2026&page=1"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Elencos

Jogadores

/players/squads/

Retorna elenco atual de um time ou times associados a um jogador.

URL base do endpoint

https://betapi.site/app/v1/players/squads/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Notas

Informe team ou player.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
team	integer	Não	ID do time.
player	integer	Não	ID do jogador.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/players/squads/?team=33' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/players/squads/?team=33');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/players/squads/?team=33', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "players/squads",
    "parameters": {
        "exemplo": "team=33"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Times do jogador

Jogadores

/players/teams/

Lista times e temporadas da carreira de um jogador.

URL base do endpoint

https://betapi.site/app/v1/players/teams/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
player	integer	Sim	ID do jogador.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/players/teams/?player=276' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/players/teams/?player=276');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/players/teams/?player=276', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "players/teams",
    "parameters": {
        "exemplo": "player=276"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Artilheiros

Jogadores

/players/topscorers/

Retorna os 20 maiores artilheiros de uma liga/copa.

URL base do endpoint

https://betapi.site/app/v1/players/topscorers/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
league	integer	Sim	ID da liga.
season	integer	Sim	Temporada YYYY.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/players/topscorers/?league=61&season=2026' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/players/topscorers/?league=61&season=2026');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/players/topscorers/?league=61&season=2026', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "players/topscorers",
    "parameters": {
        "exemplo": "league=61&season=2026"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Top assistências

Jogadores

/players/topassists/

Retorna os 20 jogadores com mais assistências.

URL base do endpoint

https://betapi.site/app/v1/players/topassists/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
league	integer	Sim	ID da liga.
season	integer	Sim	Temporada YYYY.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/players/topassists/?league=61&season=2026' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/players/topassists/?league=61&season=2026');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/players/topassists/?league=61&season=2026', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "players/topassists",
    "parameters": {
        "exemplo": "league=61&season=2026"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Top cartões amarelos

Jogadores

/players/topyellowcards/

Retorna os 20 jogadores com mais cartões amarelos.

URL base do endpoint

https://betapi.site/app/v1/players/topyellowcards/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
league	integer	Sim	ID da liga.
season	integer	Sim	Temporada YYYY.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/players/topyellowcards/?league=61&season=2026' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/players/topyellowcards/?league=61&season=2026');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/players/topyellowcards/?league=61&season=2026', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "players/topyellowcards",
    "parameters": {
        "exemplo": "league=61&season=2026"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Top cartões vermelhos

Jogadores

/players/topredcards/

Retorna os 20 jogadores com mais cartões vermelhos.

URL base do endpoint

https://betapi.site/app/v1/players/topredcards/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
league	integer	Sim	ID da liga.
season	integer	Sim	Temporada YYYY.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/players/topredcards/?league=61&season=2026' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/players/topredcards/?league=61&season=2026');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/players/topredcards/?league=61&season=2026', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "players/topredcards",
    "parameters": {
        "exemplo": "league=61&season=2026"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Lesões e ausências

Lesões

/injuries/

Lista jogadores ausentes ou questionáveis por fixture, liga, time, jogador ou data.

URL base do endpoint

https://betapi.site/app/v1/injuries/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Notas

Requer ao menos um filtro relevante.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
league	integer	Não	ID da liga.
season	integer	Não	Temporada YYYY.
fixture	integer	Não	ID do fixture.
team	integer	Não	ID do time.
player	integer	Não	ID do jogador.
date	string	Não	Data YYYY-MM-DD.
ids	string	Não	IDs de fixtures separados por hífen.
timezone	string	Não	Timezone válido.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/injuries/?fixture=686314' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/injuries/?fixture=686314');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/injuries/?fixture=686314', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "injuries",
    "parameters": {
        "exemplo": "fixture=686314"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Ligas e copas

Ligas

/leagues/

Lista ligas, copas, temporadas e cobertura de dados.

URL base do endpoint

https://betapi.site/app/v1/leagues/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
id	integer	Não	ID da liga.
name	string	Não	Nome da liga.
country	string	Não	País.
code	string	Não	Código do país.
season	integer	Não	Temporada YYYY.
team	integer	Não	ID do time.
type	string	Não	league ou cup.
current	boolean	Não	true ou false para temporadas ativas.
search	string	Não	Busca por liga ou país.
last	integer	Não	Últimas ligas adicionadas.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/leagues/?country=Brazil&season=2026' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/leagues/?country=Brazil&season=2026');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/leagues/?country=Brazil&season=2026', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "leagues",
    "parameters": {
        "exemplo": "country=Brazil&season=2026"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Temporadas disponíveis

Ligas

/leagues/seasons/

Lista todas as temporadas disponíveis na API.

URL base do endpoint

https://betapi.site/app/v1/leagues/seasons/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/leagues/seasons/' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/leagues/seasons/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/leagues/seasons/', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "leagues/seasons",
    "parameters": [],
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Transferências

Mercado

/transfers/

Lista transferências por jogador ou time.

URL base do endpoint

https://betapi.site/app/v1/transfers/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
player	integer	Não	ID do jogador.
team	integer	Não	ID do time.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/transfers/?player=35845' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/transfers/?player=35845');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/transfers/?player=35845', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "transfers",
    "parameters": {
        "exemplo": "player=35845"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Odds ao vivo

Odds

/odds/live/

Retorna odds in-play para fixtures em andamento.

URL base do endpoint

https://betapi.site/app/v1/odds/live/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Notas

Atualização rápida; use cache e evite polling excessivo.

Headers específicos

Header	Tipo	Descrição
X-BetAPI-Cache	string	HIT ou MISS quando o endpoint usa cache interno.
X-BetAPI-Stale	integer	1 quando a resposta de odds ao vivo foi servida como stale; 0 quando atualizada.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
fixture	integer	Não	ID do fixture.
league	integer	Não	ID da liga.
bet	integer	Não	ID do mercado/bet.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/odds/live/?fixture=164327' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/odds/live/?fixture=164327');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/odds/live/?fixture=164327', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "odds/live",
    "parameters": {
        "exemplo": "fixture=164327"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Mercados de odds ao vivo

Odds

/odds/live/bets/

Lista mercados disponíveis para odds ao vivo.

URL base do endpoint

https://betapi.site/app/v1/odds/live/bets/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
id	string	Não	ID do mercado.
search	string	Não	Busca textual.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/odds/live/bets/' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/odds/live/bets/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/odds/live/bets/', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "odds/live/bets",
    "parameters": [],
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Odds pré-jogo

Odds

/odds/

Retorna odds pré-jogo por fixture, liga/temporada, data, bookmaker, bet e página.

URL base do endpoint

https://betapi.site/app/v1/odds/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Notas

Endpoint com cache local quando disponível.

Headers específicos

Header	Tipo	Descrição
X-BetAPI-Cache	string	HIT ou MISS quando o endpoint usa cache interno.
X-BetAPI-Stale	integer	1 quando a resposta de odds ao vivo foi servida como stale; 0 quando atualizada.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
fixture	integer	Não	ID do fixture.
league	integer	Não	ID da liga.
season	integer	Não	Temporada YYYY.
date	string	Não	Data YYYY-MM-DD.
timezone	string	Não	Timezone válido.
page	integer	Não	Página.
bookmaker	integer	Não	ID da casa.
bet	integer	Não	ID do mercado.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/odds/?fixture=164327' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/odds/?fixture=164327');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/odds/?fixture=164327', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "odds",
    "parameters": {
        "exemplo": "fixture=164327"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Mapping de odds

Odds

/odds/mapping/

Lista fixtures disponíveis para odds pré-jogo, com paginação.

URL base do endpoint

https://betapi.site/app/v1/odds/mapping/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
page	integer	Não	Página.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/odds/mapping/?page=1' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/odds/mapping/?page=1');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/odds/mapping/?page=1', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "odds/mapping",
    "parameters": {
        "exemplo": "page=1"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Bookmakers

Odds

/odds/bookmakers/

Lista casas disponíveis para filtros de odds.

URL base do endpoint

https://betapi.site/app/v1/odds/bookmakers/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
id	integer	Não	ID da casa.
search	string	Não	Busca por nome.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/odds/bookmakers/' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/odds/bookmakers/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/odds/bookmakers/', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "odds/bookmakers",
    "parameters": [],
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Mercados pré-jogo

Odds

/odds/bets/

Lista mercados disponíveis para odds pré-jogo.

URL base do endpoint

https://betapi.site/app/v1/odds/bets/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
id	string	Não	ID do mercado.
search	string	Não	Busca por nome.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/odds/bets/' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/odds/bets/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/odds/bets/', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "odds/bets",
    "parameters": [],
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Predictions

Previsões

/predictions/

Retorna previsões e comparativos para um fixture.

URL base do endpoint

https://betapi.site/app/v1/predictions/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
fixture	integer	Sim	ID do fixture.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/predictions/?fixture=198772' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/predictions/?fixture=198772');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/predictions/?fixture=198772', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "predictions",
    "parameters": {
        "exemplo": "fixture=198772"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Times

/teams/

Consulta informações de times por ID, liga, temporada, país, código, estádio ou busca.

URL base do endpoint

https://betapi.site/app/v1/teams/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
id	integer	Não	ID do time.
name	string	Não	Nome do time.
league	integer	Não	ID da liga.
season	integer	Não	Temporada YYYY.
country	string	Não	País.
code	string	Não	Código do time.
venue	integer	Não	ID do estádio.
search	string	Não	Busca textual.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/teams/?league=39&season=2026' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/teams/?league=39&season=2026');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/teams/?league=39&season=2026', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "teams",
    "parameters": {
        "exemplo": "league=39&season=2026"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Estatísticas do time

Times

/teams/statistics/

Retorna estatísticas de um time em uma liga e temporada.

URL base do endpoint

https://betapi.site/app/v1/teams/statistics/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
league	integer	Sim	ID da liga.
season	integer	Sim	Temporada YYYY.
team	integer	Sim	ID do time.
date	string	Não	Data limite YYYY-MM-DD.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/teams/statistics/?league=39&season=2026&team=33' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/teams/statistics/?league=39&season=2026&team=33');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/teams/statistics/?league=39&season=2026&team=33', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "teams/statistics",
    "parameters": {
        "exemplo": "league=39&season=2026&team=33"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Temporadas do time

Times

/teams/seasons/

Lista temporadas disponíveis para um time.

URL base do endpoint

https://betapi.site/app/v1/teams/seasons/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
team	integer	Sim	ID do time.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/teams/seasons/?team=33' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/teams/seasons/?team=33');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/teams/seasons/?team=33', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "teams/seasons",
    "parameters": {
        "exemplo": "team=33"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Países de times

Times

/teams/countries/

Lista países disponíveis no endpoint de times.

URL base do endpoint

https://betapi.site/app/v1/teams/countries/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/teams/countries/' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/teams/countries/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/teams/countries/', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "teams/countries",
    "parameters": [],
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

GET

Técnicos

/coachs/

Consulta técnicos por ID, time ou busca.

URL base do endpoint

https://betapi.site/app/v1/coachs/

Autenticação

x-betapi-key: SUA_CHAVE_BETAPI

Comportamento

Chamada cobrável conforme plano.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
id	integer	Não	ID do técnico.
team	integer	Não	ID do time.
search	string	Não	Busca pelo nome do técnico.

Exemplos

cURL

curl -X GET 'https://betapi.site/app/v1/coachs/?team=33' \
  -H 'x-betapi-key: SUA_CHAVE_BETAPI'

PHP

$ch = curl_init('https://betapi.site/app/v1/coachs/?team=33');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-betapi-key: SUA_CHAVE_BETAPI'],
]);
echo curl_exec($ch);
curl_close($ch);

JavaScript

fetch('https://betapi.site/app/v1/coachs/?team=33', {
  method: 'GET',
  headers: { 'x-betapi-key': 'SUA_CHAVE_BETAPI' }
}).then(r => r.json()).then(console.log);

Resposta de exemplo JSON

application/json

{
    "get": "coachs",
    "parameters": {
        "exemplo": "team=33"
    },
    "errors": [],
    "results": 1,
    "paging": {
        "current": 1,
        "total": 1
    },
    "response": [
        {}
    ]
}

FAQ

A API ainda usa app.betapi.site?

Não. A base recomendada agora é https://betapi.site/app/v1/.

Posso usar o mesmo header da API original?

Sim. x-apisports-key é aceito como alias, mas o header principal da BetAPI é x-betapi-key.

A resposta é compatível com a origem?

Sim. Os endpoints proxy preservam o formato get, parameters, errors, results, paging e response retornado pela origem.

Quais endpoints foram adicionados nesta atualização?

players/seasons, players/squads, players/topscorers, players/topassists, players/topyellowcards e players/topredcards, além da documentação completa atualizada.

Documentação atualizada da API de Futebol da BetAPI

Autenticação

Limites e consumo

Headers de resposta

Códigos de resposta

Timezones

Notas

Exemplos

Países

Parâmetros

Exemplos

Troféus

Parâmetros

Exemplos

Sidelined

Parâmetros

Exemplos

Standings

Parâmetros

Exemplos

Status da conta

Exemplos

Estádios

Parâmetros

Exemplos

Fixtures

Parâmetros

Exemplos

Rodadas

Parâmetros

Exemplos

Head to head

Parâmetros

Exemplos

Estatísticas do fixture

Parâmetros

Exemplos

Eventos do fixture

Parâmetros

Exemplos

Escalações

Parâmetros

Exemplos

Estatísticas de jogadores no fixture

Parâmetros

Exemplos

Temporadas de jogadores

Parâmetros

Exemplos

Perfis de jogadores

Parâmetros

Exemplos

Estatísticas de jogadores

Parâmetros

Exemplos

Elencos

Notas

Parâmetros

Exemplos

Times do jogador

Parâmetros

Exemplos

Artilheiros

Parâmetros

Exemplos

Top assistências

Parâmetros

Exemplos

Top cartões amarelos

Parâmetros

Exemplos

Top cartões vermelhos

Parâmetros

Exemplos

Lesões e ausências

Notas

Parâmetros

Exemplos

Ligas e copas

Parâmetros