API docs
BETAPI (v1)
Documentação da API de revenda da betapi.site. O cliente consome a nossa chave x-betapi-key, enquanto a chave master da API-Football fica protegida no backend.
Authentication
Envie sua chave no header
Todas as chamadas autenticadas da BetAPI usam requisições GET com o header x-betapi-key. O endpoint status permanece sem débito de quota para monitoramento e debugging.
GET https://app.betapi.site/v1/fixtures/?live=all x-betapi-key: SUA_CHAVE_BETAPI
Base URL
Estrutura dos endpoints
GET
https://app.betapi.site/v1/leagues/?current=true
A documentação foi organizada em diretórios estáveis para funcionar em PHP puro, com rotas consistentes da BetAPI para integração rápida.
Status
Endpoint sem débito de quota
Use o endpoint de status para validar disponibilidade da integração sem consumir requests do cliente.
GET
https://app.betapi.site/v1/status/
Errors
Códigos HTTP
200
OK
—
Request processada com sucesso.
204
No Content
—
Sem dados para retornar.
400
Bad Request
—
Parâmetros insuficientes ou inválidos.
401
Unauthorized
—
Falha de autenticação no gateway.
402
Payment Required
—
Saldo insuficiente de requests.
403
Forbidden
—
Chave inválida ou usuário bloqueado.
500
Internal Server Error
—
Erro interno no proxy ou na origem.
Sample Scripts
Exemplos rápidos
cURL
curl --request GET "https://app.betapi.site/v1/leagues/?current=true" \ --header "x-betapi-key: SUA_CHAVE_BETAPI"
PHP
$ch = curl_init("https://app.betapi.site/v1/fixtures/?live=all");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["x-betapi-key: SUA_CHAVE_BETAPI"]
]);
$response = curl_exec($ch);
echo $response;
JavaScript
fetch("https://app.betapi.site/v1/standings/?league=39&season=2025", {
headers: { "x-betapi-key": "SUA_CHAVE_BETAPI" }
}).then(r => r.json()).then(console.log);
JSON download
Baixe a documentação em JSON
Use este arquivo para alimentar ferramentas internas, painéis, SDKs, IA ou automações com a especificação atual da BetAPI.
GET
/v1/timezone/
Timezone
Lista os fusos suportados pela origem e utilizados nos filtros de fixtures.
Request sample
GET https://app.betapi.site/v1/timezone/ x-betapi-key: SUA_CHAVE_BETAPI
Response sample
{
"get": "timezone",
"parameters": [],
"results": 2,
"response": [
"America/Fortaleza",
"Europe/London"
]
}
GET
/v1/countries/
Countries
Retorna países disponíveis para filtro de ligas e times.
Query Parameters
Parâmetro
Tipo
Obrigatório
Descrição
name
string
no
Nome do país.
code
string
no
Código ISO do país.
Request sample
GET https://app.betapi.site/v1/countries/?code=BR x-betapi-key: SUA_CHAVE_BETAPI
Response sample
{
"get": "countries",
"parameters": {
"code": "BR"
},
"results": 1,
"response": [
{
"name": "Brazil",
"code": "BR"
}
]
}
GET
/v1/leagues/
Leagues
Competições, copas e ligas disponíveis na origem.
Query Parameters
Parâmetro
Tipo
Obrigatório
Descrição
id
integer
no
ID da liga.
name
string
no
Nome da competição.
country
string
no
Nome do país.
season
integer
no
Temporada.
current
boolean
no
Filtra apenas ligas atuais.
Request sample
GET https://app.betapi.site/v1/leagues/?season=2025¤t=true x-betapi-key: SUA_CHAVE_BETAPI
Response sample
{
"get": "leagues",
"parameters": {
"current": "true"
},
"results": 1,
"response": [
{
"league": {
"id": 39,
"name": "Premier League"
}
}
]
}
GET
/v1/teams/
Teams
Busca times por liga, temporada, país ou nome.
Query Parameters
Parâmetro
Tipo
Obrigatório
Descrição
id
integer
no
ID do time.
league
integer
no
ID da liga.
season
integer
no
Temporada.
name
string
no
Nome do time.
country
string
no
País do time.
Request sample
GET https://app.betapi.site/v1/teams/?league=39&season=2025 x-betapi-key: SUA_CHAVE_BETAPI
Response sample
{
"get": "teams",
"parameters": {
"league": "39",
"season": "2025"
},
"results": 1,
"response": [
{
"team": {
"id": 33,
"name": "Manchester United"
}
}
]
}
GET
/v1/fixtures/
Fixtures
Jogos ao vivo, por data, por liga, time ou temporada.
Query Parameters
Parâmetro
Tipo
Obrigatório
Descrição
id
integer
no
ID do fixture.
live
string
no
Use all para jogos ao vivo.
league
integer
no
ID da liga.
season
integer
no
Temporada.
team
integer
no
ID do time.
date
YYYY-MM-DD
no
Data específica.
timezone
string
no
Timezone do retorno.
Request sample
GET https://app.betapi.site/v1/fixtures/?live=all&league=39&season=2025&timezone=America/Fortaleza x-betapi-key: SUA_CHAVE_BETAPI
Response sample
{
"get": "fixtures",
"parameters": {
"live": "all"
},
"results": 1,
"response": [
{
"fixture": {
"id": 198772,
"date": "2026-03-17T19:00:00+00:00"
}
}
]
}
GET
/v1/standings/
Standings
Tabelas de classificação por liga e temporada.
Query Parameters
Parâmetro
Tipo
Obrigatório
Descrição
league
integer
yes
ID da liga.
season
integer
yes
Temporada.
team
integer
no
Filtra um time específico.
Request sample
GET https://app.betapi.site/v1/standings/?league=39&season=2025 x-betapi-key: SUA_CHAVE_BETAPI
Response sample
{
"get": "standings",
"parameters": {
"league": "39",
"season": "2025"
},
"results": 1,
"response": [
{
"league": {
"standings": [
[
{
"rank": 1,
"team": {
"name": "Arsenal"
}
}
]
]
}
}
]
}
GET
/v1/odds/
Odds
Odds pré-jogo e live, conforme disponibilidade da origem.
Query Parameters
Parâmetro
Tipo
Obrigatório
Descrição
fixture
integer
no
ID do jogo.
league
integer
no
ID da liga.
season
integer
no
Temporada.
date
YYYY-MM-DD
no
Data específica.
Request sample
GET https://app.betapi.site/v1/odds/?fixture=164327&league=39&season=2025 x-betapi-key: SUA_CHAVE_BETAPI
Response sample
{
"get": "odds",
"parameters": {
"fixture": "164327"
},
"results": 1,
"response": [
{
"bookmakers": []
}
]
}
GET
/v1/predictions/
Predictions
Predições e análises disponíveis para um fixture.
Query Parameters
Parâmetro
Tipo
Obrigatório
Descrição
fixture
integer
yes
ID do jogo.
Request sample
GET https://app.betapi.site/v1/predictions/?fixture=164327 x-betapi-key: SUA_CHAVE_BETAPI
Response sample
{
"get": "predictions",
"parameters": {
"fixture": "198772"
},
"results": 1,
"response": [
{
"predictions": {
"winner": {
"name": "Home Team"
}
}
}
]
}