Documentação da API — CentiLogos Sport
API RESTful de dados esportivos estruturados para portais, aplicativos, dashboards e sistemas de análise do futebol brasileiro e sul-americano.
Base URL de Produção:
https://sentilogos.com/api2. Autenticação e Limites de Uso
Todas as chamadas devem incluir uma chave de API ativa no cabeçalho HTTP Authorization utilizando o formato Bearer:
HTTP Headers
Authorization: Bearer nxl_live_sua_chave_aqui Accept: application/json
Rate Limit & Planos
O limite de rajada é de 60 requisições por minuto por chave (120 req/min por IP). Toda resposta traz o consumo atualizado em meta.usage e o teto em meta.limit.
Desenvolvimento5.000 requisições / mês
Starter75.000 requisições / mês
Pro500.000 requisições / mês
3. Catálogo de Endpoints (v1)
| Endpoint | Método | Parâmetros | Descrição |
|---|---|---|---|
/status.php | GET | — | Status operacional da API e consumo atual do plano. |
/seasons.php | GET | competition | Lista as temporadas disponíveis para a competição. |
/stages.php | GET | competition, season | Retorna as fases da competição (liga, grupos, mata-mata). |
/groups.php | GET | competition, season | Lista os grupos (aplicável a copas como Libertadores). |
/teams.php | GET | competition, season | Lista os clubes participantes, escudos e IDs numéricos. |
/standings.php | GET | competition, season | Classificação completa (opcional: &group=A para grupos). |
/matches.php | GET | competition, season | Partidas, datas, horários e placares registrados. |
/next-match.php | GET | competition, season, team | Próximo jogo agendado do clube (ID numérico). |
/team-stats.php | GET | competition, season, team | Estatísticas consolidadas do clube na temporada (ID numérico). |
/team-insight.php | GET | competition, season, team | Resumo analítico de desempenho do clube (ID numérico). |
/insights.php | GET | competition, season | Destaques estatísticos gerais da competição. |
Atenção ao parâmetro
team: Nos endpoints /next-match.php, /team-stats.php e /team-insight.php, informe o ID inteiro do clube (ex.: team=85 para SE Palmeiras), obtido previamente em GET /teams.php.
4. Códigos Principais de Competição
brasileirao— Campeonato Brasileiro Série Acopa-do-brasil— Copa do Brasillibertadores— CONMEBOL Libertadorespaulistao— Campeonato Paulista
5. Exemplos de Integração
cURL
Bash / Terminal
# Classificação do Brasileirão 2026 curl -X GET "https://sentilogos.com/api/standings.php?competition=brasileirao&season=2026" \ -H "Authorization: Bearer nxl_live_sua_chave_aqui" \ -H "Accept: application/json" # Próximo jogo do Palmeiras (ID 85) curl -X GET "https://sentilogos.com/api/next-match.php?competition=brasileirao&season=2026&team=85" \ -H "Authorization: Bearer nxl_live_sua_chave_aqui" \ -H "Accept: application/json"
PHP (cURL Nativo)
PHP 8.1+
<?php
$apiKey = 'nxl_live_sua_chave_aqui';
$url = 'https://sentilogos.com/api/standings.php?competition=brasileirao&season=2026';
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 10,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $apiKey,
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$data = json_decode($response, true);
if ($httpCode === 200 && ($data['ok'] ?? false) === true) {
foreach ($data['data']['standings'] as $row) {
echo "#{$row['position']} {$row['team']['name']} - {$row['points']} pts ({$row['played']}J)\n";
}
} else {
echo "Erro ({$httpCode}): " . ($data['error']['message'] ?? 'Falha na requisição');
}
JavaScript / Node.js
ES2022 / Fetch API
const API_KEY = 'nxl_live_sua_chave_aqui';
const BASE_URL = 'https://sentilogos.com/api';
async function getStandings(competition = 'brasileirao', season = 2026) {
const response = await fetch(
`${BASE_URL}/standings.php?competition=${competition}&season=${season}`,
{
headers: {
'Authorization': `Bearer ${API_KEY}`,
'Accept': 'application/json'
}
}
);
const payload = await response.json();
if (!response.ok || !payload.ok) {
throw new Error(payload.error?.message || `HTTP ${response.status}`);
}
return payload.data.standings;
}
getStandings().then(rows => console.table(rows.slice(0, 5)));
6. Exemplo de Resposta (200 OK)
JSON Payload
{
"ok": true,
"data": {
"competition": {
"id": 4,
"code": "brasileirao",
"name": "Campeonato Brasileiro Série A",
"country": "Brasil",
"type": "liga"
},
"season": {
"id": 4,
"year": 2026,
"status": "ativa"
},
"standings": [
{
"position": 1,
"team": {
"id": 68,
"name": "CR Flamengo",
"country": "BRA",
"crest": "https://sentilogos.com/assets/escudos/flamengo.png"
},
"points": 76,
"played": 34,
"won": 23,
"drawn": 7,
"lost": 4,
"goals_for": 68,
"goals_against": 26,
"goal_difference": 42,
"percentage": 74.51
}
]
},
"meta": {
"format": "league",
"standing_count": 20,
"plan": "Starter",
"usage": 142,
"limit": 75000
}
}
7. Tratamento de Erros
| HTTP | Código (error.code) |
Causa |
|---|---|---|
400 | missing_competition / invalid_team | Parâmetro obrigatório ausente ou team não informado como ID numérico. |
401 | invalid_api_key | Cabeçalho Authorization: Bearer ausente, inválido ou chave revogada. |
404 | competition_not_found / standings_not_found | Competição, temporada ou classificação inexistente para os filtros enviados. |
422 | invalid_parameters / invalid_group | Ano inválido ou uso do filtro group em torneio de pontos corridos. |
429 | rate_limit_exceeded | Limite por minuto ou cota mensal do plano atingida. |