Documentacao API

Autenticacao

Todas as requisicoes exigem o parametro token na query string. O token e gerado automaticamente ao criar sua conta e pode ser regenerado no painel.

                    curl "https://metadata.epgbr.com.br/api/v1/search?token=SEU_TOKEN&query=breaking+bad"
                

Respostas de erro: Token invalido retorna 401. Conta bloqueada retorna 403.

Token de Teste

Use o token abaixo para testar a API gratuitamente. O token de teste tem um limite de 5 requisicoes por dia.

TOKEN DE TESTE

kIIH15smZRjmV5LUED7xTv2WU6Ka7w2bqe9nd5e-kfQ

Limite: 5 consultas/dia. Para uso comercial, contrate um plano.

Testar agora

Formato de Resposta

Todas as respostas sao em JSON. A estrutura padrao inclui:

Campo	Tipo	Descricao
`query`	string	Termo buscado
`count`	int	Quantidade de resultados
`cost`	string	Custo da consulta
`charged`	boolean	Se houve cobranca
`source`	string	"cache" ou "api" (se buscou ao vivo)
`results`	array	Lista de resultados

Cache inteligente: Resultados ja buscados anteriormente retornam do cache sem cobranca ("charged": false).

Custos por Consulta

R$ 0,50

/search

R$ 0,50

/search/series

R$ 0,06

/cast

R$ 0,10

/enrich

GET /api/v1/trailer

Retorna trailers e videos do YouTube para um filme ou serie. Prioriza videos em pt-BR, com fallback para en-US.

Parametro	Tipo	Obrigatorio	Descricao
`token`	string	Sim	Seu token de API
`tmdb_id`	int	*	ID do TMDB
`imdb_id`	string	*	ID do IMDB
`query`	string	*	Nome do titulo
`media_type`	string	Nao	`movie` ou `tv`
`lang`	string	Nao	Idioma (padrao: pt-BR)

* Informe pelo menos um: tmdb_id, imdb_id ou query

Exemplo de Resposta

{
  "tmdb_id": 37724,
  "total_videos": 3,
  "trailers": [
    {
      "name": "Trailer Oficial Dublado",
      "type": "Trailer",
      "site": "YouTube",
      "url": "https://www.youtube.com/watch?v=rf55HmGA-oo",
      "embed_url": "https://www.youtube.com/embed/rf55HmGA-oo",
      "thumbnail": "https://img.youtube.com/vi/rf55HmGA-oo/hqdefault.jpg",
      "language": "pt-BR"
    }
  ],
  "teasers": [],
  "clips": []
}

GET /api/v1/awards

Retorna premiacoes (Oscar, Golden Globe), ratings de multiplas fontes (IMDB, Rotten Tomatoes, Metacritic) e bilheteria.

Parametro	Tipo	Obrigatorio	Descricao
`token`	string	Sim	Seu token de API
`tmdb_id`	int	*	ID do TMDB
`imdb_id`	string	*	ID do IMDB
`query`	string	*	Nome do titulo

* Informe pelo menos um: tmdb_id, imdb_id ou query

Exemplo de Resposta

{
  "imdb_id": "tt1074638",
  "awards_text": "Won 2 Oscars. 69 wins & 125 nominations total",
  "awards": {
    "oscars": {"won": 2},
    "wins": 69,
    "nominations": 125
  },
  "ratings": [
    {"source": "Internet Movie Database", "value": "7.8/10"},
    {"source": "Rotten Tomatoes", "value": "92%"},
    {"source": "Metacritic", "value": "81/100"}
  ],
  "box_office": "$304,360,277"
}

R$ 0,03

/images

/usage e gratuito. Resultados do cache nao sao cobrados novamente.

Endpoints

GET /api/v1/search Consulte

Busca filmes e series por nome. Retorna metadados completos incluindo sinopse em portugues, elenco, notas IMDB, poster, backdrop e logo.

Parametros

Parametro	Tipo		Descricao
`token`	string	obrigatorio	Seu token de API
`query`	string	obrigatorio	Nome do filme ou serie (min. 2 caracteres)

Exemplo de requisicao

curl "https://metadata.epgbr.com.br/api/v1/search?token=SEU_TOKEN&query=vingadores"

Exemplo de resposta

{
  "query": "vingadores",
  "count": 5,
  "cost": "***",
  "charged": true,
  "source": "api",
  "results": [
    {
      "title": "Vingadores: Ultimato",
      "original_title": "Avengers: Endgame",
      "media_type": "movie",
      "year": 2019,
      "tmdb_id": 299534,
      "imdb_id": "tt4154796",
      "imdb_rating": "8.4",
      "genres": "Acao, Aventura, Ficcao cientifica",
      "certification": "12",
      "runtime": 181,
      "overview": "Apos os eventos devastadores...",
      "poster_url": "https://metadata.epgbr.com.br/images/posters/tmdb_299534.jpg",
      "backdrop_url": "https://metadata.epgbr.com.br/images/backdrops/tmdb_299534.jpg",
      "actors": "Robert Downey Jr., Chris Evans, ...",
      "directors": "Anthony Russo, Joe Russo"
    }
  ]
}
                    

GET /api/v1/search/series Consulte

Busca exclusivamente series com dados completos de temporadas e episodios: sinopse individual de cada episodio, nota, duracao e participacoes especiais.

Parametros

Parametro	Tipo		Descricao
`token`	string	obrigatorio	Seu token de API
`query`	string	obrigatorio	Nome da serie (min. 2 caracteres)

Exemplo de requisicao

curl "https://metadata.epgbr.com.br/api/v1/search/series?token=SEU_TOKEN&query=breaking+bad"

Exemplo de resposta

{
  "query": "breaking bad",
  "count": 1,
  "results": [
    {
      "title": "Breaking Bad",
      "tmdb_id": 1396,
      "seasons": [
        {
          "season_number": 1,
          "name": "Temporada 1",
          "episode_count": 7,
          "episodes": [
            {
              "episode_number": 1,
              "name": "Pilot",
              "air_date": "2008-01-20",
              "runtime": 58,
              "overview": "Walter White, um professor de quimica...",
              "vote_average": 8.1,
              "guest_stars": [...]
            }
          ]
        }
      ]
    }
  ]
}
                    

GET /api/v1/cast Consulte

Retorna elenco (ate 15 atores com foto e personagem) e diretores. Aceita busca por TMDB ID, IMDB ID ou nome. Se nao encontrar no cache, busca automaticamente e salva.

Parametros

Parametro	Tipo		Descricao
`token`	string	obrigatorio	Seu token de API
`tmdb_id`	int	opcional*	ID do TMDB (resultado exato)
`imdb_id`	string	opcional*	ID do IMDB, ex: tt4154796
`query`	string	opcional*	Nome do titulo (min. 2 caracteres, ate 10 resultados)

* Informe pelo menos um: tmdb_id, imdb_id ou query.

Exemplos de requisicao

# Por TMDB ID curl "https://metadata.epgbr.com.br/api/v1/cast?token=SEU_TOKEN&tmdb_id=299534" # Por IMDB ID curl "https://metadata.epgbr.com.br/api/v1/cast?token=SEU_TOKEN&imdb_id=tt4154796" # Por nome curl "https://metadata.epgbr.com.br/api/v1/cast?token=SEU_TOKEN&query=vingadores"

Exemplo de resposta

{
  "query": "tmdb:299534",
  "count": 1,
  "results": [
    {
      "title": "Vingadores: Ultimato",
      "directors": [
        { "name": "Anthony Russo", "photo": "https://image.tmdb.org/t/p/w185/..." }
      ],
      "cast": [
        {
          "name": "Robert Downey Jr.",
          "character": "Tony Stark / Iron Man",
          "photo": "https://image.tmdb.org/t/p/w185/..."
        }
      ]
    }
  ]
}
                    

GET /api/v1/enrich Consulte

Enriquece um titulo do EPG: identifica o conteudo no TMDB e, para series TV, identifica o episodio especifico comparando a sinopse fornecida com a de cada episodio. Ideal para EPGs que enviam o nome do programa sem temporada/episodio, mas com uma breve sinopse.

Parametros

Parametro	Tipo		Descricao
`token`	string	obrigatorio	Seu token de API
`title`	string	obrigatorio	Nome do programa (min. 2 caracteres)
`synopsis`	string	obrigatorio	Trecho da sinopse do EPG (min. 5 caracteres)
`year`	int	opcional	Ano de lancamento para filtrar resultados
`media_type`	string	opcional	`movie` ou `tv` para restringir tipo

Exemplo de requisicao

curl "https://metadata.epgbr.com.br/api/v1/enrich?token=SEU_TOKEN&title=Grey%27s+Anatomy&synopsis=Meredith+repensa+seus+planos+enquanto+os+estagiarios+enfrentam+uma+crise"

Exemplo de resposta (serie com episodio identificado)

{
  "title": "Grey's Anatomy",
  "original_title": "Grey's Anatomy",
  "media_type": "tv",
  "tmdb_id": 1416,
  "imdb_id": "tt0413573",
  "year": 2005,
  "genres": "Drama",
  "certification": "14",
  "tmdb_rating": "8.21",
  "imdb_rating": "7.6",
  "poster": "https://metadata.epgbr.com.br/images/posters/...",
  "backdrop": "https://metadata.epgbr.com.br/images/backdrops/...",
  "overview": "Os medicos do Grey Sloan Memorial...",
  "match_confidence": 0.4762,
  "episode_match": {
    "season": 20,
    "episode": 1,
    "name": "Nos apenas comecamos",
    "overview": "Meredith repensa seus planos...",
    "air_date": "2024-03-14",
    "still_url": "https://image.tmdb.org/t/p/w500/...",
    "runtime": 44,
    "vote_average": 8.6
  },
  "cost": "***",
  "charged": true
}
                    

Campos da resposta

Campo	Tipo	Descricao
`match_confidence`	float	Score de 0 a 1 indicando a confianca do match (sinopse para series, titulo para filmes)
`episode_match`	object\|null	Episodio identificado pela sinopse. `null` para filmes ou se nenhum episodio atingir o threshold
`episode_match.season`	int	Numero da temporada
`episode_match.episode`	int	Numero do episodio
`episode_match.name`	string	Titulo do episodio
`episode_match.overview`	string	Sinopse do episodio (TMDB)
`episode_match.air_date`	string	Data de exibicao
`episode_match.still_url`	string	Imagem do episodio
`episode_match.runtime`	int	Duracao em minutos
`episode_match.vote_average`	float	Nota do episodio no TMDB

GET /api/v1/images/{tmdb_id} Consulte

Retorna todas as imagens disponives (posters, backdrops, logos) de um titulo. O tmdb_id e obtido via /search.

Parametros

Parametro	Tipo		Descricao
`token`	string	obrigatorio	Seu token de API
`tmdb_id`	int	obrigatorio	ID do TMDB (na URL)

Exemplo de requisicao

curl "https://metadata.epgbr.com.br/api/v1/images/1396?token=SEU_TOKEN"

Exemplo de resposta

{
  "tmdb_id": 1396,
  "title": "Breaking Bad",
  "posters": ["https://metadata.epgbr.com.br/images/posters/tmdb_1396.jpg"],
  "backdrops": ["https://metadata.epgbr.com.br/images/backdrops/tmdb_1396.jpg"],
  "logos": ["https://metadata.epgbr.com.br/images/logos/tmdb_1396.png"],
  "cost": "***",
  "charged": true
}
                    

GET /api/v1/usage Gratuito

Retorna estatisticas de uso e custo da API no mes atual. Sem custo.

Parametros

Parametro	Tipo		Descricao
`token`	string	obrigatorio	Seu token de API

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/usage?token=SEU_TOKEN"

Resposta

{
  "total_queries": 42,
  "total_cost": "21.00",
  "month": "2026-02"
}
                    

API de Futebol

Dados ao vivo de campeonatos, jogos, classificação, artilheiros, escalações e muito mais. Sob demanda (pay-per-use) — cada endpoint tem preço próprio (R$ 0,02 a R$ 0,10 por item retornado). Os endpoints marcados com são exclusivos do EPG.BR (cruzam dados de futebol com a nossa grade EPG).

GET /api/v1/football/leagues R$ 0.02/item

Lista campeonatos disponiveis. Filtre por pais, nome ou temporada.

Parametros

Parametro	Tipo		Descricao
`token`	string	obrigatorio	Seu token de API
`country`	string	opcional	Filtrar por pais (ex: Brazil, England)
`search`	string	opcional	Buscar por nome do campeonato
`season`	int	opcional	Temporada (ex: 2026)

IDs de ligas uteis

71 Brasileirao Serie A

72 Brasileirao Serie B

73 Copa do Brasil

13 Libertadores

475 Paulistao

477 Gauchao

604 Catarinense

39 Premier League

2 Champions League

1 Copa do Mundo

Exemplo de requisicao

curl "https://metadata.epgbr.com.br/api/v1/football/leagues?token=SEU_TOKEN&country=Brazil"

Exemplo de resposta

{
  "results": [
    {
      "league_id": 71,
      "name": "Serie A",
      "type": "League",
      "country": "Brazil",
      "logo": "/img/ft/leagues/71.png",
      "season": 2026
    }
  ]
}
                    

GET /api/v1/football/fixtures R$ 0.03/jogo

Lista jogos de um campeonato. Permite filtrar por proximos jogos, ultimos jogos, data especifica ou time.

Parametros

Parametro	Tipo		Descricao
`token`	string	obrigatorio	Seu token de API
`league`	int	obrigatorio	ID do campeonato (ex: 71 = Brasileirao Serie A)
`season`	int	obrigatorio	Temporada (ex: 2026)
`next`	int	opcional	Proximos N jogos (ex: next=5)
`last`	int	opcional	Ultimos N jogos (ex: last=5)
`date`	string	opcional	Data especifica (YYYY-MM-DD)
`team`	int	opcional	Filtrar por ID do time

Exemplo de requisicao

curl "https://metadata.epgbr.com.br/api/v1/football/fixtures?token=SEU_TOKEN&league=71&season=2026&next=3"

Exemplo de resposta

{
  "results": [
    {
      "fixture_id": 1234567,
      "date": "2026-04-05T20:00:00-03:00",
      "status": "Not Started",
      "venue": "Maracana",
      "league": { "id": 71, "name": "Serie A", "round": "Regular Season - 1" },
      "home": { "id": 127, "name": "Flamengo", "logo": "..." },
      "away": { "id": 126, "name": "Sao Paulo", "logo": "..." },
      "goals": { "home": null, "away": null }
    }
  ]
}
                    

GET /api/v1/football/standings R$ 0.03/time

Retorna a tabela de classificacao completa de um campeonato com pontos, vitorias, empates, derrotas, gols e saldo.

Parametros

Parametro	Tipo		Descricao
`token`	string	obrigatorio	Seu token de API
`league`	int	obrigatorio	ID do campeonato (ex: 71)
`season`	int	obrigatorio	Temporada (ex: 2026)

Exemplo de requisicao

curl "https://metadata.epgbr.com.br/api/v1/football/standings?token=SEU_TOKEN&league=71&season=2026"

Exemplo de resposta

{
  "league": { "id": 71, "name": "Serie A", "season": 2026 },
  "standings": [
    {
      "rank": 1,
      "team": { "id": 121, "name": "Palmeiras", "logo": "..." },
      "points": 45,
      "played": 20,
      "win": 13,
      "draw": 6,
      "lose": 1,
      "goals_for": 35,
      "goals_against": 12,
      "goal_diff": 23,
      "form": "WWDWW"
    }
  ]
}
                    

GET /api/v1/football/topscorers R$ 0.03/jogador

Retorna a lista de artilheiros de um campeonato com gols, assistencias e estatisticas.

Parametros

Parametro	Tipo		Descricao
`token`	string	obrigatorio	Seu token de API
`league`	int	obrigatorio	ID do campeonato (ex: 71)
`season`	int	obrigatorio	Temporada (ex: 2026)

Exemplo de requisicao

curl "https://metadata.epgbr.com.br/api/v1/football/topscorers?token=SEU_TOKEN&league=71&season=2026"

Exemplo de resposta

{
  "results": [
    {
      "player": { "id": 10011, "name": "Pedro", "photo": "..." },
      "team": { "id": 127, "name": "Flamengo", "logo": "..." },
      "statistics": {
        "games_played": 20,
        "goals": 15,
        "assists": 4,
        "penalties_scored": 3
      }
    }
  ]
}
                    

GET /api/v1/football/live R$ 0.05/jogo

Dois modos de uso:

Lista de jogos ao vivo (sem fixture): retorna todos os jogos em andamento, com placar, minuto e status.
Estado consolidado de UM jogo (com fixture=X): devolve numa única chamada status + minuto + placar + eventos (gols, cartões, substituições) + estatísticas (posse, finalizações, escanteios). Ideal para acompanhamento em tempo real (poll a cada 30-60s).

Parâmetros

Parâmetro	Tipo		Descrição
`token`	string	obrigatório	Seu token de API
`fixture`	int	opcional	Se informado, ativa o modo consolidado de UM jogo (estado + eventos + stats)
`include_events`	bool	opcional	(modo fixture) inclui eventos. Default `true`.
`include_stats`	bool	opcional	(modo fixture) inclui estatísticas. Default `true`.
`league`	int	opcional	(modo lista) filtra por campeonato
`country`	string	opcional	(modo lista) filtra por país (ex: Brazil)

Exemplo — modo lista

curl "https://metadata.epgbr.com.br/api/v1/football/live?token=SEU_TOKEN&league=71"

Exemplo — modo consolidado de um jogo

curl "https://metadata.epgbr.com.br/api/v1/football/live?token=SEU_TOKEN&fixture=1535259"

Resposta — modo consolidado

{
  "live": true,
  "match": {
    "fixture_id": 1535259,
    "is_live": true,
    "status_short": "2H",
    "status_long": "Second Half",
    "elapsed": 65,
    "extra": null,
    "kickoff": "2026-04-16T19:00:00-03:00",
    "venue": "Estadio Ciudad de Lanus", "city": "Buenos Aires",
    "referee": "Alexis Herrera, Venezuela",
    "round": "Group Stage - 2",
    "league": { "id": 13, "name": "CONMEBOL Libertadores", "season": 2026 },
    "home": { "id": 446, "name": "Lanus", "goals": 0 },
    "away": { "id": 3700, "name": "Always Ready", "goals": 0 },
    "score": { "halftime": { "home": 0, "away": 0 } },
    "events": [
      { "minute": 13, "team": "Lanus", "type": "Card", "detail": "Yellow Card", "player": "J. Canale Dominguez" },
      { "minute": 46, "team": "Lanus", "type": "subst", "player": "F. N. Watson" },
      { "minute": 58, "team": "Lanus", "type": "subst", "player": "A. Medina" }
    ],
    "events_count": 3,
    "statistics": [
      { "team": { "id": 446, "name": "Lanus" }, "stats": { "Ball Possession": "71%", "Total Shots": 13, "Shots on Goal": 2 } },
      { "team": { "id": 3700, "name": "Always Ready" }, "stats": { "Ball Possession": "29%", "Total Shots": 2 } }
    ]
  },
  "cost": "0.05"
}
                    

Polling em tempo real: chame com fixture=X a cada 30-60s; novos eventos são detectáveis comparando events[].minute. Status: 1H/2H (1º/2º tempo), HT (intervalo), ET (prorrogação), P (pênaltis), FT (encerrado), NS (não começou).

GET /api/v1/football/events R$ 0.05/evento

Retorna os eventos de uma partida: gols, cartoes amarelos/vermelhos, substituicoes e penaltis.

Parametros

Parametro	Tipo		Descricao
`token`	string	obrigatorio	Seu token de API
`fixture`	int	obrigatorio	ID da partida (obtido via /fixtures ou /live)

Exemplo de requisicao

curl "https://metadata.epgbr.com.br/api/v1/football/events?token=SEU_TOKEN&fixture=1234568"

Exemplo de resposta

{
  "fixture_id": 1234568,
  "events": [
    {
      "time": 23,
      "team": { "id": 121, "name": "Palmeiras" },
      "player": "Endrick",
      "type": "Goal",
      "detail": "Normal Goal",
      "assist": "Raphael Veiga"
    },
    {
      "time": 62,
      "team": { "id": 131, "name": "Corinthians" },
      "player": "Fagner",
      "type": "Card",
      "detail": "Yellow Card",
      "assist": null
    }
  ]
}
                    

GET /api/v1/football/statistics R$ 0.03/time

Retorna estatisticas detalhadas de uma partida: posse de bola, chutes, escanteios, faltas, impedimentos e passes.

Parametros

Parametro	Tipo		Descricao
`token`	string	obrigatorio	Seu token de API
`fixture`	int	obrigatorio	ID da partida

Exemplo de requisicao

curl "https://metadata.epgbr.com.br/api/v1/football/statistics?token=SEU_TOKEN&fixture=1234568"

Exemplo de resposta

{
  "fixture_id": 1234568,
  "statistics": [
    {
      "team": { "id": 131, "name": "Corinthians" },
      "stats": {
        "Shots on Goal": 4,
        "Total Shots": 12,
        "Ball Possession": "42%",
        "Corner Kicks": 3,
        "Fouls": 18,
        "Passes Accurate": "78%"
      }
    },
    {
      "team": { "id": 121, "name": "Palmeiras" },
      "stats": {
        "Shots on Goal": 7,
        "Total Shots": 14,
        "Ball Possession": "58%",
        "Corner Kicks": 6,
        "Fouls": 12,
        "Passes Accurate": "85%"
      }
    }
  ]
}
                    

GET /api/v1/football/lineups R$ 0.03/escalação

Retorna escalacao e formacao tatica de ambos os times, incluindo titulares, reservas e tecnico.

Parametros

Parametro	Tipo		Descricao
`token`	string	obrigatorio	Seu token de API
`fixture`	int	obrigatorio	ID da partida

Exemplo de requisicao

curl "https://metadata.epgbr.com.br/api/v1/football/lineups?token=SEU_TOKEN&fixture=1234568"

Exemplo de resposta

{
  "fixture_id": 1234568,
  "lineups": [
    {
      "team": { "id": 131, "name": "Corinthians" },
      "formation": "4-3-3",
      "coach": "Mano Menezes",
      "start_xi": [
        { "number": 1, "name": "Cassio", "pos": "G" },
        { "number": 9, "name": "Yuri Alberto", "pos": "F" }
      ],
      "substitutes": [
        { "number": 17, "name": "Giovane", "pos": "F" }
      ]
    }
  ]
}
                    

GET /api/v1/football/predictions R$ 0.05/jogo

Retorna previsoes e probabilidades para uma partida, incluindo chance de vitoria/empate e comparacao de desempenho.

Parametros

Parametro	Tipo		Descricao
`token`	string	obrigatorio	Seu token de API
`fixture`	int	obrigatorio	ID da partida

Exemplo de requisicao

curl "https://metadata.epgbr.com.br/api/v1/football/predictions?token=SEU_TOKEN&fixture=1234568"

Exemplo de resposta

{
  "fixture_id": 1234568,
  "predictions": {
    "winner": { "id": 121, "name": "Palmeiras" },
    "advice": "Palmeiras vence ou empata",
    "percent": { "home": "30%", "draw": "25%", "away": "45%" },
    "comparison": {
      "form": { "home": "65%", "away": "75%" },
      "attack": { "home": "70%", "away": "80%" },
      "defense": { "home": "60%", "away": "75%" }
    }
  }
}
                    

GET /api/v1/football/team R$ 0.02/time

Retorna informacoes de um time: nome, logo, estadio, cidade, fundacao e capacidade.

Parametros

Parametro	Tipo		Descricao
`token`	string	obrigatorio	Seu token de API
`id`	int	opcional*	ID do time
`search`	string	opcional*	Buscar por nome do time (min. 3 caracteres)

* Informe pelo menos um: id ou search.

Exemplo de requisicao

curl "https://metadata.epgbr.com.br/api/v1/football/team?token=SEU_TOKEN&search=Flamengo"

Exemplo de resposta

{
  "results": [
    {
      "team": {
        "id": 127,
        "name": "Flamengo",
        "code": "FLA",
        "country": "Brazil",
        "founded": 1895,
        "logo": "/img/ft/teams/127.png"
      },
      "venue": {
        "name": "Maracana",
        "city": "Rio de Janeiro",
        "capacity": 78838
      }
    }
  ]
}
                    

GET /api/v1/football/headtohead R$ 0.03/jogo

Retorna o historico de confrontos diretos entre dois times, com resultados das ultimas partidas.

Parametros

Parametro	Tipo		Descricao
`token`	string	obrigatorio	Seu token de API
`team1`	int	obrigatorio	ID do primeiro time (ex: 127 = Flamengo)
`team2`	int	obrigatorio	ID do segundo time (ex: 121 = Palmeiras)
`last`	int	opcional	Numero de ultimos confrontos (padrao: 10)

Exemplo de requisicao

curl "https://metadata.epgbr.com.br/api/v1/football/headtohead?token=SEU_TOKEN&team1=127&team2=121&last=5"

Exemplo de resposta

{
  "team1": { "id": 127, "name": "Flamengo" },
  "team2": { "id": 121, "name": "Palmeiras" },
  "total_matches": 5,
  "results": [
    {
      "fixture_id": 1234500,
      "date": "2026-02-15",
      "league": "Serie A",
      "home": { "name": "Flamengo", "goals": 2 },
      "away": { "name": "Palmeiras", "goals": 1 }
    }
  ],
  "summary": {
    "flamengo_wins": 2,
    "palmeiras_wins": 1,
    "draws": 2
  }
}
                    

GET /api/v1/football/players R$ 0.05/jogador

Estatísticas individuais dos jogadores em uma partida específica: nota (rating), gols, assistências, passes, dribles, duelos, faltas, cartões, minutos em campo e mais. Ideal para relatórios pós-jogo e dashboards detalhados.

Parâmetros

Parâmetro	Tipo		Descrição
`token`	string	obrigatório	Seu token de API
`fixture`	int	obrigatório	ID da partida (obtido via `/football/fixtures`)

Exemplo de requisição

curl "https://metadata.epgbr.com.br/api/v1/football/players?token=SEU_TOKEN&fixture=1520634"

Exemplo de resposta

{
  "fixture": 1520634,
  "teams": [
    {
      "team": { "id": 127, "name": "Flamengo" },
      "players": [
        {
          "id": 1100,
          "name": "G. de Arrascaeta",
          "position": "M",
          "rating": "8.4",
          "minutes": 90,
          "goals": 1,
          "assists": 2,
          "shots_total": 3,
          "shots_on": 2,
          "passes_total": 52,
          "passes_key": 4,
          "passes_accuracy": 85,
          "dribbles_attempts": 6,
          "dribbles_success": 4,
          "duels_total": 12,
          "duels_won": 8,
          "fouls_committed": 1,
          "fouls_drawn": 3,
          "yellow_cards": 0,
          "red_cards": 0
        }
      ]
    }
  ],
  "cost": "0.05"
}
                    

Retorna todos os jogadores dos dois times que entraram em campo (inclusive reservas utilizados). Cobrança por jogador retornado.

GET /api/v1/football/injuries R$ 0.03/item

Lista jogadores lesionados ou suspensos (desfalques). Use fixture para uma partida específica, team+season para o elenco de um time, ou league+season para todos os desfalques de uma competição.

Parâmetros

Parâmetro	Tipo		Descrição
`token`	string	obrigatório	Seu token de API
`fixture`	int	opcional*	ID da partida
`league`	int	opcional*	ID da liga
`team`	int	opcional*	ID do time
`season`	int	opcional	Temporada (ex: 2026) — combine com `league` ou `team`

* pelo menos um entre fixture, league ou team é obrigatório.

Exemplo de requisição

curl "https://metadata.epgbr.com.br/api/v1/football/injuries?token=SEU_TOKEN&team=127&season=2026"

Exemplo de resposta

{
  "count": 3,
  "injuries": [
    {
      "player": {
        "id": 35845,
        "name": "Pedro",
        "type": "Missing Fixture",
        "reason": "Knee Injury"
      },
      "team": { "id": 127, "name": "Flamengo" }
    }
  ],
  "cost": "0.03"
}
                    

GET /api/v1/football/broadcast ⭐ EXCLUSIVO R$ 0.05/jogo

Recurso exclusivo EPG.BR — cruza dados de jogos de futebol com a programação dos canais do nosso EPG, retornando apenas partidas com transmissão identificada. Mostra o nome, logo e horário de cada canal transmissor, separando ao vivo e reprises.

Ideal para aplicações que querem mostrar "onde assistir" cada jogo — cruzamos automaticamente a grade de todos os canais esportivos e regionais do nosso EPG com os jogos do dia.

Parâmetros

Parâmetro	Tipo		Descrição
`token`	string	obrigatório	Seu token de API
`date`	string	opcional	Data `YYYY-MM-DD` (default: hoje UTC)
`league`	int	opcional	Filtrar por ID de liga (ex: 71 = Brasileirão)
`only_live`	bool	opcional	Se `true`, exclui reprises (VT/Compacto/Melhores Momentos)
`category`	string	opcional	`all`, `sports`, `regional`, `sports_regional` (default)
`replay_window_hours`	int	opcional	Janela pós-kickoff para considerar reprises (1 a 72h, default `24`)
`content_types`	string	opcional	CSV restringindo tipos: `live,replay_full,highlights,compact`

Exemplo de requisição

curl "https://metadata.epgbr.com.br/api/v1/football/broadcast?token=SEU_TOKEN&date=2026-04-10&league=71"

Exemplo de resposta

{
  "date": "2026-04-10",
  "category": "sports_regional",
  "count": 2,
  "total_channels_mapped": 7,
  "matches": [
    {
      "fixture_id": 1520634,
      "league": { "name": "Serie B", "country": "Brazil" },
      "home": { "name": "Criciuma", "logo": "..." },
      "away": { "name": "Botafogo SP", "logo": "..." },
      "broadcast": {
        "total_channels": 6,
        "live_channels": 3,
        "replay_channels": 3,
        "replay_count": 3,
        "by_type": { "live": 3, "replay_full": 2, "highlights": 1, "compact": 0 },
        "channels": [
          {
            "channel": "ESPN",
            "logo": "/images/logos/ch_47.png",
            "title": "Criciúma x Botafogo-SP - Ao Vivo",
            "is_replay": false,
            "content_type": "live",
            "start": "2026-04-10T19:00:00",
            "stop": "2026-04-10T21:00:00",
            "duration_min": 120
          },
          {
            "channel": "SporTV 2",
            "title": "VT - Criciúma x Botafogo-SP",
            "is_replay": true,
            "content_type": "replay_full",
            "start": "2026-04-11T03:30:00",
            "duration_min": 120
          },
          {
            "channel": "BandSports",
            "title": "Melhores Momentos: Criciúma x Botafogo",
            "is_replay": true,
            "content_type": "highlights",
            "duration_min": 30
          }
        ]
      }
    }
  ],
  "cost": "0.05"
}
                    

Como funciona: cruzamos o horário do jogo com os programas de esportes do EPG, exigindo que o título contenha ambos os times. Janela de ±90min ao vivo e até 72h para reprises (configurável). content_type classifica cada transmissão em live, replay_full (VT integral), highlights (Melhores Momentos) ou compact (Compacto).

GET /api/v1/football/broadcast/week ⭐ EXCLUSIVO R$ 0.10/semana

Recurso exclusivo EPG.BR — retorna uma matriz semanal (segunda a domingo) com a contagem de jogos por dia e por campeonato, já cruzada com a programação dos canais do EPG. Útil para guias semanais, agendas editoriais e grades de programação.

Faz uma consulta por liga no range da semana (com cache de 1 hora). Cada liga retorna o total de jogos por dia e, se solicitado, o detalhamento de canais por jogo. Ideal para montar uma grade semanal de "onde assistir" num único request.

Parâmetros

Parâmetro	Tipo		Descrição
`token`	string	obrigatório	Seu token de API
`leagues`	string	obrigatório	CSV de IDs de ligas (máx. 30). Ex: `71,72,13,2`
`week_start`	string	opcional	Segunda-feira `YYYY-MM-DD`. Default: segunda da semana atual.
`category`	string	opcional	`all`, `sports`, `regional`, `sports_regional` (default)
`only_with_epg`	bool	opcional	Se `true` (default), retorna só jogos com canal mapeado no EPG
`replay_window_hours`	int	opcional	Janela pós-kickoff para reprises (1-72h, default 24)

Exemplo de requisição

curl "https://metadata.epgbr.com.br/api/v1/football/broadcast/week?token=SEU_TOKEN&leagues=71,72,13,2&week_start=2026-04-13"

Exemplo de resposta

{
  "week_start": "2026-04-13",
  "week_end": "2026-04-19",
  "days": [
    { "date": "2026-04-13", "weekday": "Seg" },
    { "date": "2026-04-14", "weekday": "Ter" },
    { "date": "2026-04-19", "weekday": "Dom" }
  ],
  "leagues": [
    {
      "id": 13,
      "name": "CONMEBOL Libertadores",
      "logo": "/api/v1/football/media-proxy/leagues/13.png",
      "season": 2026,
      "totals": { "2026-04-13": 0, "2026-04-14": 7, "2026-04-15": 5, "2026-04-16": 4 },
      "total_week": 16,
      "matches_by_day": {
        "2026-04-14": [
          {
            "fixture_id": 1520789,
            "kickoff": "2026-04-14T21:30:00-03:00",
            "home": { "name": "Flamengo" },
            "away": { "name": "Racing" },
            "broadcast": { "live_channels": 2, "replay_channels": 3 }
          }
        ]
      }
    }
  ],
  "total_matches": 36,
  "cost": "0.10"
}
                    

Cache de 1 hora por liga/semana — múltiplas chamadas seguidas não são reprecificadas pela API upstream.

GET /api/v1/football/replays ⭐ EXCLUSIVO R$ 0.04/jogo

Recurso exclusivo EPG.BR — lista somente reprises (VT integral, Melhores Momentos, Compactos) agendadas nas próximas horas. Cada jogo traz todos os horários e canais em que será reapresentado.

Perfeito para quem perdeu o jogo ao vivo ou para guias editoriais do tipo "onde rever os jogos da rodada". Busca fixtures de ±1 dia / +3 dias e cruza com a grade do EPG, retornando apenas os programas que classificam como reprise.

Parâmetros

Parâmetro	Tipo		Descrição
`token`	string	obrigatório	Seu token de API
`window_hours`	int	opcional	Janela pós-kickoff (1-72h, default 48)
`league`	int	opcional	Filtrar por ID de liga
`category`	string	opcional	`all`, `sports`, `regional`, `sports_regional` (default)
`content_types`	string	opcional	CSV (default `replay_full,highlights,compact`)

Exemplo de requisição

curl "https://metadata.epgbr.com.br/api/v1/football/replays?token=SEU_TOKEN&window_hours=48&league=71"

Exemplo de resposta

{
  "window_hours": 48,
  "count": 12,
  "total_replays": 38,
  "matches": [
    {
      "fixture_id": 1520634,
      "kickoff": "2026-04-15T21:30:00-03:00",
      "league": { "name": "Serie A" },
      "home": { "name": "Flamengo" },
      "away": { "name": "Palmeiras" },
      "replay_count": 5,
      "by_type": { "replay_full": 3, "highlights": 2, "compact": 0 },
      "replays": [
        {
          "channel": "SporTV 2",
          "title": "VT - Flamengo x Palmeiras",
          "content_type": "replay_full",
          "start": "2026-04-16T02:00:00",
          "duration_min": 120
        },
        {
          "channel": "BandSports",
          "title": "Melhores Momentos: Flamengo x Palmeiras",
          "content_type": "highlights",
          "start": "2026-04-16T08:30:00",
          "duration_min": 30
        }
      ]
    }
  ],
  "cost": "0.04"
}
                    

GET /api/v1/football/schedule ⭐ EXCLUSIVO R$ 0.07/consulta

Recurso exclusivo EPG.BR — agenda consolidada de um time ou campeonato: últimos + próximos jogos, já cruzados com a grade EPG. Ideal para páginas "meu time" ou "calendário do Brasileirão".

Aceita team_id, team_search (resolve nome automaticamente) ou league_id. Divide a resposta em past[] (jogos encerrados) e upcoming[] (futuros). Cada jogo vem com canais ao vivo e reprises. Use exclude_fixtures para omitir jogos já exibidos em outra tela (dedup).

Parâmetros

Parâmetro	Tipo		Descrição
`token`	string	obrigatório	Seu token de API
`team_id`	int	opcional*	ID do time
`team_search`	string	opcional*	Nome do time (resolvido automaticamente)
`league_id`	int	opcional*	ID do campeonato
`season`	int	opcional	Temporada (default: ano atual)
`next`	int	opcional	Qtd. jogos futuros (padrão 10, máx 50)
`last`	int	opcional	Qtd. jogos passados (padrão 10, máx 50)
`full_season`	bool	opcional	Ignora next/last e retorna toda a temporada
`exclude_fixtures`	string	opcional	CSV de fixture_ids a omitir (dedup)
`only_with_epg`	bool	opcional	Só retorna jogos com canal EPG mapeado
`replay_window_hours`	int	opcional	Janela pós-kickoff (1-72h, default 24)

* informe team_id, team_search ou league_id. team_* + league_id combinam (restringem à competição).

Exemplo de requisição

curl "https://metadata.epgbr.com.br/api/v1/football/schedule?token=SEU_TOKEN&team_search=Flamengo&next=10&last=10"

Exemplo de resposta

{
  "team": { "id": 127, "name": "Flamengo", "country": "Brazil" },
  "league": null,
  "season": 2026,
  "full_season": false,
  "past_count": 10,
  "upcoming_count": 10,
  "excluded_count": 0,
  "upcoming": [
    {
      "fixture_id": 1492232,
      "kickoff": "2026-04-19T19:30:00-03:00",
      "league": { "name": "Serie A", "round": "Regular Season - 12" },
      "home": { "name": "Flamengo", "goals": null },
      "away": { "name": "Bahia", "goals": null },
      "broadcast": { "live_channels": 3, "replay_channels": 2 }
    }
  ],
  "past": [
    {
      "fixture_id": 1492210,
      "kickoff": "2026-04-12T15:00:00-03:00",
      "home": { "name": "Fluminense", "goals": 1, "winner": false },
      "away": { "name": "Flamengo", "goals": 2, "winner": true },
      "status_short": "FT"
    }
  ],
  "cost": "0.07"
}
                    

Preço fixo por consulta (independente do número de jogos retornados). Use o fixture_id para enriquecer com /events, /statistics, /lineups, /players.

GET /api/v1/football/vt-lookup ⭐ EXCLUSIVO R$ 0.06/consulta

Recurso exclusivo EPG.BR — resolve os metadados de qualquer VT/reprise no EPG a partir do título do programa. Faz parse do título ("VT - Time1 x Time2"), identifica os times na base da API-Football e retorna o fixture histórico mais provável, com nota de confiança.

Ideal para enriquecer um VT que está passando agora no EPG com os dados completos do jogo original — mesmo que a partida tenha acontecido há semanas, meses ou anos. Aceita títulos como VT - X x Y, (R) X x Y, Reapresentação: X x Y, Melhores Momentos: X x Y, Compacto: X x Y.

Parâmetros

Parâmetro	Tipo		Descrição
`token`	string	obrigatório	Seu token de API
`title`	string	opcional*	Título do programa no EPG (ex: `"VT - Chapecoense x Atletico MG"`)
`home`	string	opcional*	Nome do time mandante (use se não tiver o título)
`away`	string	opcional*	Nome do time visitante
`epg_start`	string	opcional	Data/hora do programa no EPG (`YYYY-MM-DD` ou ISO). Usado para escolher o jogo mais próximo.
`league_hint`	string	opcional	Dica de campeonato (ex: `"Brasileirão Série A"`) para desempatar alternativas
`last`	int	opcional	Quantos confrontos históricos considerar (1-15, default 5)

* informe title OU home+away.

Exemplo de requisição

curl "https://metadata.epgbr.com.br/api/v1/football/vt-lookup?token=SEU_TOKEN&title=VT%20-%20Atletico%20Paranaense%20x%20Chapecoense&epg_start=2026-04-16T22:00"

Exemplo de resposta

{
  "title": "VT - Atletico Paranaense x Chapecoense",
  "parsed": {
    "home_query": "Atletico Paranaense",
    "away_query": "Chapecoense",
    "content_type": "replay_full",
    "league_hint": null
  },
  "resolved_teams": {
    "home": { "id": 134, "name": "Atletico Paranaense", "country": "Brazil" },
    "away": { "id": 132, "name": "Chapecoense-sc", "country": "Brazil" }
  },
  "confidence": "medium",
  "best_match": {
    "fixture_id": 1492210,
    "match_score": 80,
    "date": "2026-04-12T14:00:00+00:00",
    "venue": "Arena da Baixada", "city": "Curitiba",
    "referee": "A. Policarpo Bento",
    "league": { "id": 71, "name": "Serie A", "season": 2026, "round": "Regular Season - 11" },
    "home": { "id": 134, "name": "Atletico Paranaense", "goals": 2, "winner": true },
    "away": { "id": 132, "name": "Chapecoense-sc", "goals": 0, "winner": false }
  },
  "alternatives": [
    { "fixture_id": 1353514, "date": "2025-09-17", "league": { "name": "Serie B" } }
  ],
  "cost": "0.06"
}
                    

confidence: high (jogo até 2 dias do epg_start), medium (jogo recente + match de liga), low (só H2H genérico). Use o fixture_id retornado para enriquecer com /events, /statistics, /lineups, /players, /predictions.

URL /epg/{token}.xml Incluido no plano

URL do seu guia de programacao EPG no formato XMLTV. Use esta URL no seu player IPTV ou sistema para receber o guia personalizado com os canais que voce assinou.

Como usar

Copie sua URL do EPG no painel de gerenciamento
No seu player IPTV, va em configuracoes de EPG/Guide
Cole a URL no campo de EPG/XMLTV
Salve e atualize o guia

Formato

https://metadata.epgbr.com.br/epg/SEU_TOKEN.xml

O arquivo XMLTV e gerado automaticamente com os canais que voce assinou e atualizado periodicamente.

Esportes (ESF)

Eventos de F1, NBA e NFL. Cada esporte tem plano e cobranca independentes. Imagens via CDN proprio (sem expor fornecedor).

GET /api/v1/esf/f1/seasons R$ 0,005/chamada

Lista temporadas F1 disponiveis (2012-2026).

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/f1/seasons?token=SEU_TOKEN"

GET /api/v1/esf/f1/races R$ 0,01/chamada

Corridas e sessoes (FP1, FP2, FP3, Sprint, Qualy, Race).

Parametros

Parametro	Tipo		Descricao
`token`	string	obrigatorio	Seu token de API
`season`	int	opcional	Ex: 2025
`type`	string	opcional	Race, Qualifying, Sprint
`next`	int	opcional	Proximas N corridas
`date`	string	opcional	YYYY-MM-DD

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/f1/races?token=SEU_TOKEN&season=2025&type=Race"

GET /api/v1/esf/f1/teams R$ 0,005/chamada

Escuderias com fundacao, base, campeonatos.

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/f1/teams?token=SEU_TOKEN&search=ferrari"

GET /api/v1/esf/f1/drivers R$ 0,005/chamada

Pilotos com foto, nacionalidade, numero.

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/f1/drivers?token=SEU_TOKEN&search=verstappen"

GET /api/v1/esf/f1/rankings/drivers R$ 0,02/chamada

Classificacao do campeonato de pilotos.

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/f1/rankings/drivers?token=SEU_TOKEN&season=2025"

GET /api/v1/esf/f1/rankings/races R$ 0,05/chamada

Resultado da corrida (top 20, voltas, abandonos).

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/f1/rankings/races?token=SEU_TOKEN&race=1861"

GET /api/v1/esf/f1/rankings/pitstops R$ 0,03/chamada

Pit stops por piloto: volta, duracao, tempo total.

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/f1/rankings/pitstops?token=SEU_TOKEN&race=1861"

F1 oferece tambem: competitions, circuits, rankings/teams, rankings/startinggrid, rankings/fastestlaps, status, timezone. Total: 14 endpoints.

GET /api/v1/esf/nba/leagues R$ 0,005/chamada

Lista as ligas NBA (standard, sacramento summer league, etc.).

Parametros

token string obrigatorio Seu token

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nba/leagues?token=SEU_TOKEN"

GET /api/v1/esf/nba/seasons R$ 0,005/chamada

Temporadas disponiveis (2015-2025).

Parametros

token string obrigatorio Seu token

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nba/seasons?token=SEU_TOKEN"

GET /api/v1/esf/nba/teams R$ 0,01/chamada

30 times NBA com cidade, logo, conferencia, divisao.

Parametros

`token`	string	obrigatorio	Seu token
`id`	int	opcional	ID do time
`name`	string	opcional	Nome exato
`code`	string	opcional	Ex: BOS, LAL
`conference`	string	opcional	East ou West
`division`	string	opcional	Atlantic, Central...
`search`	string	opcional	Busca parcial

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nba/teams?token=SEU_TOKEN&search=lakers"

GET /api/v1/esf/nba/teams/statistics R$ 0,03/chamada

Estatisticas agregadas por time na temporada.

Parametros

`token`	string	obrigatorio	Seu token
`id`	int	obrigatorio	ID do time
`season`	int	opcional	Ex: 2025

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nba/teams/statistics?token=SEU_TOKEN&id=1&season=2025"

GET /api/v1/esf/nba/games R$ 0,02/chamada

Jogos NBA por data, temporada ou time.

Parametros

`token`	string	obrigatorio	Seu token
`id`	int	opcional	ID do jogo
`date`	string	opcional	YYYY-MM-DD
`live`	string	opcional	all (ao vivo)
`season`	int	opcional	Ex: 2025
`team`	int	opcional	ID do time
`h2h`	string	opcional	ID1-ID2

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nba/games?token=SEU_TOKEN&date=2025-12-25"

GET /api/v1/esf/nba/games/statistics R$ 0,03/chamada

Estatisticas detalhadas do jogo (FG%, rebotes, etc.).

Parametros

`token`	string	obrigatorio	Seu token
`id`	int	obrigatorio	ID do jogo

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nba/games/statistics?token=SEU_TOKEN&id=10403"

GET /api/v1/esf/nba/standings R$ 0,02/chamada

Tabela com 30 times — vitorias, derrotas, conferencias.

Parametros

`token`	string	obrigatorio	Seu token
`league`	string	obrigatorio	standard
`season`	int	obrigatorio	Ex: 2025
`team`	int	opcional	ID do time
`conference`	string	opcional	East ou West
`division`	string	opcional	Atlantic, Central...

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nba/standings?token=SEU_TOKEN&league=standard&season=2025"

GET /api/v1/esf/nba/players R$ 0,01/chamada

Roster por time x temporada ou busca por nome.

Parametros

`token`	string	obrigatorio	Seu token
`id`	int	opcional	ID do jogador
`team`	int	opcional	ID do time
`season`	int	opcional	Ex: 2025
`country`	string	opcional	Ex: USA
`search`	string	opcional	Busca (min. 4 chars)

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nba/players?token=SEU_TOKEN&team=1&season=2025"

GET /api/v1/esf/nba/players/statistics R$ 0,05/chamada

Estatisticas por jogador (pontos, assist, reb).

Parametros

`token`	string	obrigatorio	Seu token
`id`	int	opcional	ID do jogador
`game`	int	opcional	ID do jogo
`team`	int	opcional	ID do time
`season`	int	opcional	Ex: 2025

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nba/players/statistics?token=SEU_TOKEN&id=265&season=2025"

GET /api/v1/esf/nba/status R$ 0,00/chamada

Auxiliar — info do plano API-Sports atual.

Parametros

token string obrigatorio Seu token

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nba/status?token=SEU_TOKEN"

GET /api/v1/esf/nfl/leagues R$ 0,005/chamada

NFL (id=1) e NCAA (id=2).

Parametros

token string obrigatorio Seu token

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nfl/leagues?token=SEU_TOKEN"

GET /api/v1/esf/nfl/seasons R$ 0,005/chamada

Temporadas disponiveis.

Parametros

token string obrigatorio Seu token

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nfl/seasons?token=SEU_TOKEN"

GET /api/v1/esf/nfl/teams R$ 0,01/chamada

32 franquias NFL com cidade, estadio, cores.

Parametros

`token`	string	obrigatorio	Seu token
`id`	int	opcional	ID do time
`search`	string	opcional	Busca por nome
`league`	int	opcional	1 (NFL) ou 2 (NCAA)
`season`	int	opcional	Ex: 2025

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nfl/teams?token=SEU_TOKEN&season=2025&search=patriots"

GET /api/v1/esf/nfl/games R$ 0,02/chamada

Jogos com placar, semana e fase (regular/playoffs).

Parametros

`token`	string	obrigatorio	Seu token
`season`	int	opcional	Ex: 2025
`team`	int	opcional	ID do time
`date`	string	opcional	YYYY-MM-DD
`week`	int	opcional	Numero da semana
`h2h`	string	opcional	ID1-ID2

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nfl/games?token=SEU_TOKEN&season=2025"

GET /api/v1/esf/nfl/games/events R$ 0,03/chamada

Eventos do jogo: touchdowns, FGs, INTs, sacks por play.

Parametros

`token`	string	obrigatorio	Seu token
`id`	int	obrigatorio	ID do jogo

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nfl/games/events?token=SEU_TOKEN&id=12340"

GET /api/v1/esf/nfl/games/statistics/teams R$ 0,03/chamada

Stats por time no jogo: total yards, 1st downs, turnovers.

Parametros

`token`	string	obrigatorio	Seu token
`id`	int	obrigatorio	ID do jogo

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nfl/games/statistics/teams?token=SEU_TOKEN&id=12340"

GET /api/v1/esf/nfl/games/statistics/players R$ 0,05/chamada

Stats dos jogadores no jogo: passing, rushing, receiving, defesa.

Parametros

`token`	string	obrigatorio	Seu token
`id`	int	obrigatorio	ID do jogo
`group`	string	opcional	passing, rushing, receiving, defensive...

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nfl/games/statistics/players?token=SEU_TOKEN&id=12340"

GET /api/v1/esf/nfl/standings R$ 0,02/chamada

Tabela com 32 times — vitorias, derrotas, percentual.

Parametros

`token`	string	obrigatorio	Seu token
`league`	int	opcional	1 (NFL)
`season`	int	opcional	Ex: 2025
`conference`	string	opcional	AFC ou NFC
`division`	string	opcional	East, West, North, South

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nfl/standings?token=SEU_TOKEN&season=2025"

GET /api/v1/esf/nfl/standings/conferences R$ 0,01/chamada

Lista AFC e NFC.

Parametros

`token`	string	obrigatorio	Seu token
`league`	int	opcional	1
`season`	int	opcional	Ex: 2025

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nfl/standings/conferences?token=SEU_TOKEN&season=2025"

GET /api/v1/esf/nfl/standings/divisions R$ 0,01/chamada

8 divisoes (AFC E/W/N/S + NFC E/W/N/S).

Parametros

`token`	string	obrigatorio	Seu token
`league`	int	opcional	1
`season`	int	opcional	Ex: 2025

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nfl/standings/divisions?token=SEU_TOKEN&season=2025"

GET /api/v1/esf/nfl/players R$ 0,01/chamada

Roster por time x temporada.

Parametros

`token`	string	obrigatorio	Seu token
`team`	int	opcional	ID do time
`season`	int	opcional	Ex: 2025
`search`	string	opcional	Busca por nome
`id`	int	opcional	ID do jogador

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nfl/players?token=SEU_TOKEN&team=1&season=2025"

GET /api/v1/esf/nfl/players/statistics R$ 0,05/chamada

Estatisticas acumuladas do ano (passing, rushing, etc.).

Parametros

`token`	string	obrigatorio	Seu token
`id`	int	obrigatorio	ID do jogador
`season`	int	opcional	Ex: 2025
`team`	int	opcional	ID do time

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nfl/players/statistics?token=SEU_TOKEN&id=1&season=2025"

GET /api/v1/esf/nfl/injuries R$ 0,02/chamada

Lista de jogadores lesionados (status: Out, Questionable, IR).

Parametros

`token`	string	obrigatorio	Seu token
`team`	int	opcional	ID do time
`player`	int	opcional	ID do jogador

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nfl/injuries?token=SEU_TOKEN&team=1"

GET /api/v1/esf/nfl/odds R$ 0,03/chamada

Cotacoes pre-jogo de varias casas de apostas.

Parametros

`token`	string	obrigatorio	Seu token
`game`	int	opcional	ID do jogo
`league`	int	opcional	1
`season`	int	opcional	Ex: 2025
`bookmaker`	int	opcional	ID da casa
`bet`	int	opcional	Tipo de aposta

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nfl/odds?token=SEU_TOKEN&game=12340"

GET /api/v1/esf/nfl/odds/bets R$ 0,005/chamada

Lista dos 361 tipos de aposta suportados.

Parametros

`token`	string	obrigatorio	Seu token
`id`	int	opcional	ID do tipo
`search`	string	opcional	Busca por nome

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nfl/odds/bets?token=SEU_TOKEN"

GET /api/v1/esf/nfl/odds/bookmakers R$ 0,005/chamada

Lista das 24 casas suportadas (Bet365, BetMGM, FanDuel etc.).

Parametros

`token`	string	obrigatorio	Seu token
`id`	int	opcional	ID
`search`	string	opcional	Busca por nome

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nfl/odds/bookmakers?token=SEU_TOKEN"

GET /api/v1/esf/nfl/status R$ 0,00/chamada

Auxiliar — info do plano API-Sports atual.

Parametros

token string obrigatorio Seu token

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nfl/status?token=SEU_TOKEN"

GET /api/v1/esf/nfl/timezone R$ 0,00/chamada

Lista timezones suportados.

Parametros

token string obrigatorio Seu token

Exemplo

curl "https://metadata.epgbr.com.br/api/v1/esf/nfl/timezone?token=SEU_TOKEN"

Imagens proxy: logos e fotos retornados nas respostas apontam para https://metadata.epgbr.com.br/img/sp/{sport}/... (CDN proprio com cache local).

API de Metadados

Autenticacao

Token de Teste

Testar agora

Formato de Resposta

Custos por Consulta

Exemplo de Resposta

Exemplo de Resposta

Endpoints

Parametros

Exemplo de requisicao

Exemplo de resposta

Parametros

Exemplo de requisicao

Exemplo de resposta

Parametros

Exemplos de requisicao

Exemplo de resposta

Parametros

Exemplo de requisicao

Exemplo de resposta (serie com episodio identificado)

Campos da resposta

Parametros

Exemplo de requisicao

Exemplo de resposta

Parametros

Exemplo

Resposta

API de Futebol

Parametros

IDs de ligas uteis

Exemplo de requisicao

Exemplo de resposta

Parametros

Exemplo de requisicao

Exemplo de resposta

Parametros

Exemplo de requisicao

Exemplo de resposta

Parametros

Exemplo de requisicao

Exemplo de resposta

Parâmetros

Exemplo — modo lista

Exemplo — modo consolidado de um jogo

Resposta — modo consolidado

Parametros

Exemplo de requisicao

Exemplo de resposta

Parametros

Exemplo de requisicao

Exemplo de resposta

Parametros

Exemplo de requisicao

Exemplo de resposta

Parametros

Exemplo de requisicao

Exemplo de resposta

Parametros

Exemplo de requisicao

Exemplo de resposta

Parametros

Exemplo de requisicao

Exemplo de resposta

Parâmetros

Exemplo de requisição

Exemplo de resposta

Parâmetros

Exemplo de requisição

Exemplo de resposta

Parâmetros

Exemplo de requisição

Exemplo de resposta

Parâmetros

Exemplo de requisição

Exemplo de resposta

Parâmetros

Exemplo de requisição

Exemplo de resposta

Parâmetros