API Pública
Todos os dados do site estão disponíveis em JSON, de graça e sem chave de API. Consuma de qualquer linguagem ou direto do navegador: o CORS é liberado para qualquer origem (Access-Control-Allow-Origin: *).
1 requisição a cada 5 segundos, por IP e por endpoint. Acima disso a API responde 429 com o header Retry-After indicando quantos segundos esperar. Os placares são cacheados no servidor por 4-20s, então consultar mais rápido que isso não traria dado mais novo de qualquer forma.
Base
https://live.jhou.tec.br
Endpoints
/api/liveVarre todas as ligas do catálogo e devolve só os jogos em andamento agora, já enriquecidos com estatísticas e gols. O resultado é cacheado por 20s no servidor.
{ "live": MatchEvent[] }https://live.jhou.tec.br/api/live
/api/scoreboard/{sport}/{league}Jogos de uma liga: ao vivo, próximos (até 6), últimos resultados (até 20) e fases de mata-mata quando a competição tem.
| sport | soccer · basketball · football · baseball · hockey |
| league | slug da liga (ver catálogo abaixo, ex: bra.1) |
| dates | opcional — dia (YYYYMMDD) ou intervalo (YYYYMMDD-YYYYMMDD); padrão: janela em torno de hoje |
| details | opcional — details=1 embute estatísticas e gols nos jogos ao vivo e encerrados |
{ "live": MatchEvent[], "upcoming": MatchEvent[], "finished": MatchEvent[], "knockout": [{ "stage", "label", "events": MatchEvent[] }], "leagueName": string }https://live.jhou.tec.br/api/scoreboard/soccer/bra.1?details=1
/api/standings/{sport}/{league}Classificação da liga, agrupada (grupos, conferências ou tabela única). Ligas 100% mata-mata não têm classificação e devolvem lista vazia.
| sport | soccer · basketball · football · baseball · hockey |
| league | slug da liga (ex: eng.1) |
{ "groups": [{ "name": string, "rows": [{ "rank", "teamId", "teamName", "teamAbbr", "logo", "stats": [{ "key", "label", "value" }] }] }] }https://live.jhou.tec.br/api/standings/soccer/eng.1
/api/groups/fifa-worldComposição fixa dos grupos da Copa do Mundo (A-L, 4 times por grupo).
{ "groups": [{ "name": string, "teams": [{ "teamId", "teamName", "teamAbbr", "logo" }] }] }https://live.jhou.tec.br/api/groups/fifa-world
/api/featuredJogos marcados como destaque público no site.
| live | opcional — live=1 enriquece cada destaque com placar/status ao vivo |
{ "games": [{ "id", "sportKey", "leagueSlug", "eventId", "homeTeam", "awayTeam", "addedAt", ... }] }https://live.jhou.tec.br/api/featured?live=1
/api/f1/{resource}Fórmula 1 (dados via Blacktop/OpenF1). Recursos: session-info (sessão atual ou próxima), leaderboard (posições ao vivo), race-control (direção de prova), events (calendário do ano), event-detail (sessões de um evento), meetings, sessions, championship (mundiais de pilotos e construtores), qualifying-segments e live-status (diagnóstico).
| year | events e meetings — ano da temporada; padrão: ano atual |
| eventId | obrigatório em event-detail |
| meetingKey | obrigatório em sessions |
varia por recurso; ex. championship: { "championship": { "drivers": [...], "constructors": [...] } }https://live.jhou.tec.br/api/f1/championship
/api/ciclismo/{resource}Tour de France (dados via ASO). Recursos: stages (etapas e etapa atual), rankings (classificações de uma etapa: geral, pontos, montanha...), winners (vencedores por etapa) e live (telemetria da etapa em andamento).
| year | opcional — edição do Tour; padrão: edição atual |
| stage | rankings — número da etapa (1-21); padrão: etapa mais recente |
| demo | live — demo=1 simula uma etapa em andamento pra testes |
varia por recurso; ex. stages: { "stages": [...], "currentStage": number }https://live.jhou.tec.br/api/ciclismo/rankings?stage=9
O objeto MatchEvent
Todo "jogo" devolvido por /api/live, /api/scoreboard e /api/featured usa o mesmo formato:
| id | identificador único do jogo |
| sportKey / leagueSlug | esporte (soccer, nba...) e liga a que o jogo pertence |
| date | data/hora do jogo em ISO 8601 (UTC) |
| state | "pre" (agendado), "in" (ao vivo) ou "post" (encerrado) |
| detail / clock / period | status textual, relógio e tempo/período (quando ao vivo) |
| home / away | times: { id, name, abbr, logo, score, winner } |
| venue / attendance | estádio e público (quando disponíveis) |
| stats | estatísticas do jogo (posse, chutes...) — só com details=1 |
| goals | gols com autor e minuto (futebol) — só com details=1 |
| stage | fase do torneio (ex: semifinals) em competições com mata-mata |
Exemplo rápido
curl "https://live.jhou.tec.br/api/scoreboard/soccer/fifa.world?details=1"
// ou no navegador / Node:
const res = await fetch("https://live.jhou.tec.br/api/live");
const { live } = await res.json();Catálogo de ligas
Valores aceitos em {sport} e {league} nas rotas de scoreboard e classificação. Outros slugs de futebol válidos (ex: rsa.1) também funcionam, mesmo fora desta lista. Fórmula 1 e ciclismo não entram neste catálogo — têm endpoints próprios (/api/f1/… e /api/ciclismo/…, documentados acima).
| fifa.world | Copa do Mundo |
| fifa.wwc | Copa do Mundo Feminina |
| fifa.world.u20 | Mundial Sub-20 |
| fifa.world.u17 | Mundial Sub-17 |
| fifa.friendly | Amistosos Internacionais |
| fifa.shebelieves | SheBelieves Cup |
| uefa.euro | Eurocopa |
| uefa.nations | Liga das Nações (UEFA) |
| conmebol.america | Copa América |
| uefa.champions | Champions League |
| uefa.europa | Europa League |
| uefa.europa.conf | Conference League |
| uefa.wchampions | Champions League Feminina |
| conmebol.libertadores | Libertadores |
| conmebol.sudamericana | Sul-Americana |
| concacaf.leagues.cup | Leagues Cup |
| campeones.cup | Campeones Cup |
| bra.1 | Brasileirão Série A |
| bra.2 | Brasileirão Série B |
| bra.3 | Brasileirão Série C |
| bra.copa_do_brazil | Copa do Brasil |
| eng.1 | Premier League |
| eng.2 | Championship (Inglaterra) |
| esp.1 | La Liga |
| esp.2 | La Liga 2 |
| ger.1 | Bundesliga |
| ger.2 | 2. Bundesliga |
| ita.1 | Serie A (Itália) |
| ita.2 | Serie B (Itália) |
| fra.1 | Ligue 1 |
| fra.2 | Ligue 2 |
| por.1 | Primeira Liga (Portugal) |
| ned.1 | Eredivisie |
| bel.1 | Jupiler Pro League |
| tur.1 | Süper Lig |
| sco.1 | Scottish Premiership |
| nor.1 | Eliteserien (Noruega) |
| nor.2 | 1. Division (Noruega) |
| usa.1 | MLS |
| mex.1 | Liga MX |
| arg.1 | Liga Profesional (Argentina) |
| chi.1 | Primera División (Chile) |
| col.1 | Primera A (Colômbia) |
| per.1 | Liga 1 (Peru) |
| uru.1 | Primera División (Uruguai) |
| par.1 | División Profesional (Paraguai) |
| ecu.1 | LigaPro (Equador) |
| ven.1 | Primera División (Venezuela) |
| bol.1 | División Profesional (Bolívia) |
| jpn.1 | J1 League |
| chn.1 | Chinese Super League |
| aus.1 | A-League |
| ksa.1 | Saudi Pro League |
| eng.fa | FA Cup |
| eng.league_cup | Carabao Cup |
| esp.copa_del_rey | Copa del Rey |
| ger.dfb_pokal | DFB-Pokal |
| ita.coppa_italia | Coppa Italia |
| usa.nwsl | NWSL |
| nba | NBA |
| wnba | WNBA |
| nfl | NFL |
| mlb | MLB |
| nhl | NHL |
Os dados vêm de fontes públicas e podem mudar ou sair do ar sem aviso. Use com bom senso — o limite existe pra API continuar de graça pra todo mundo.