CentiLogos Sport API v1 • Operacional

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/api

2. 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.phpGET—Status operacional da API e consumo atual do plano.
/seasons.phpGETcompetitionLista as temporadas disponíveis para a competição.
/stages.phpGETcompetition, seasonRetorna as fases da competição (liga, grupos, mata-mata).
/groups.phpGETcompetition, seasonLista os grupos (aplicável a copas como Libertadores).
/teams.phpGETcompetition, seasonLista os clubes participantes, escudos e IDs numéricos.
/standings.phpGETcompetition, seasonClassificação completa (opcional: &group=A para grupos).
/matches.phpGETcompetition, seasonPartidas, datas, horários e placares registrados.
/next-match.phpGETcompetition, season, teamPróximo jogo agendado do clube (ID numérico).
/team-stats.phpGETcompetition, season, teamEstatísticas consolidadas do clube na temporada (ID numérico).
/team-insight.phpGETcompetition, season, teamResumo analítico de desempenho do clube (ID numérico).
/insights.phpGETcompetition, seasonDestaques 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 A
  • copa-do-brasil — Copa do Brasil
  • libertadores — CONMEBOL Libertadores
  • paulistao — 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
400missing_competition / invalid_teamParâmetro obrigatório ausente ou team não informado como ID numérico.
401invalid_api_keyCabeçalho Authorization: Bearer ausente, inválido ou chave revogada.
404competition_not_found / standings_not_foundCompetição, temporada ou classificação inexistente para os filtros enviados.
422invalid_parameters / invalid_groupAno inválido ou uso do filtro group em torneio de pontos corridos.
429rate_limit_exceededLimite por minuto ou cota mensal do plano atingida.