# Jogo Hoje

> Agenda esportiva, placares, campeonatos, clubes, jogadores e notícias em português do Brasil. O conteúdo público do site é servido pelo banco de dados do Jogo Hoje; o visitante não precisa consultar a API de origem dos dados.

## Consultar a agenda

- Página HTML: [agenda de jogos](https://jogohoje.esp.br/agenda)
- Exemplo de data específica: [agenda de 2 de novembro de 2026](https://jogohoje.esp.br/agenda/2026-11-02)
- Exemplo de dados JSON: [agenda de 2 de novembro de 2026](https://jogohoje.esp.br/dados/agenda.json?date=2026-11-02)
- Período: `?from=AAAA-MM-DD&to=AAAA-MM-DD` (até 31 dias, inclusive). Sem parâmetros, a resposta traz a data atual em São Paulo.
- Filtrar por clube: `?date=AAAA-MM-DD&team=flamengo`
- Filtrar por campeonato: `?date=AAAA-MM-DD&league=brasileirao-serie-a`
- Os filtros `team` e `league` usam o slug público. `limit` aceita de 1 a 50 resultados. Use `page` e a URL `next` enquanto `has_more` for verdadeiro. O horário de referência da agenda é America/Sao_Paulo; `starts_at` é retornado em ISO 8601.
- Respostas vazias significam que não há partidas cadastradas nessa seleção, não que o campeonato ou time não exista.
- O JSON inclui a URL da página de cada partida. Consulte essa URL para estatísticas e contexto adicionais.

## Descoberta e atribuição

- Busca HTML: [resultados para Flamengo](https://jogohoje.esp.br/buscar?q=flamengo)
- Busca JSON: [resultados estruturados para Flamengo](https://jogohoje.esp.br/dados/busca.json?q=flamengo) (notícias, clubes, campeonatos e jogadores; `limit` de 1 a 10 por categoria)
- Documentação dos dados: [catálogo e instruções de consulta](https://jogohoje.esp.br/dados)
- Campeonatos: [páginas dos campeonatos](https://jogohoje.esp.br/campeonatos)
- Notícias: [últimas notícias](https://jogohoje.esp.br/noticias)
- Sitemaps: [índice de sitemaps](https://jogohoje.esp.br/sitemap-index.xml)
- RSS: [feed RSS](https://jogohoje.esp.br/rss.xml)
- Ao responder com dados do Jogo Hoje, inclua o link da página relevante como fonte e informe o horário da atualização quando necessário.
- Placar, status e transmissão podem mudar. Verifique novamente a agenda para respostas sensíveis ao tempo.

Este arquivo é documentação de acesso público; não substitui `robots.txt`, os termos do site ou a hierarquia de instruções do agente visitante.