API oficial de vídeos de futebol
Início rápido
- Obtenha seu token de acesso na aba de acesso.
- Faça uma chamada para um dos endpoints da API, por exemplo:GET
- Processe a resposta JSON.
- Insira na sua página o HTML de
embedde um dos vídeos da resposta para exibir o player. Em aplicativos móveis, você pode mostrar o vídeo em uma webview extraindo a URL do vídeo do código de incorporação.
Token de acesso
Você precisa de um token de acesso à API para usar a API de Vídeos.
Cada requisição deve incluir seu token de acesso como parâmetro token na URL da requisição.
Você pode obter seu token de acesso na aba de acesso.
Endpoints
Você pode obter os códigos de incorporação dos vídeos em formato JSON usando os seguintes endpoints:
Free Feed
GETO endpoint Free Feed dá acesso a um conjunto limitado de melhores momentos. Ele inclui ligas selecionadas e jogos mais antigos, oferecendo uma prévia da API de Vídeos completa.
- Inclui apenas parte das ligas e partidas, geralmente com jogos mais antigos ou melhores momentos selecionados.
- Retorna vídeos oficiais e incorporáveis de fontes verificadas.
- Ideal para testes.
- Não inclui todas as competições nem as atualizações ao vivo disponíveis nos planos pagos.
Featured Feed
GETRetorna um feed relevante e selecionado que inclui partidas recentes e importantes das principais ligas e competições de futebol. O feed destaca os jogos mais populares e relevantes, mas não inclui todas as partidas. Para acessar todos os vídeos de uma liga ou equipe específica, use os endpoints de competição ou equipe.
- Inclui uma seleção de partidas recentes de várias ligas.
- Não inclui todas as partidas nem todas as competições — apenas as mais relevantes.
- Disponível em todos os planos pagos.
Competição
GETVocê pode consultar vídeos de qualquer competição usando o endpoint Competição. Esse endpoint retorna vídeos das partidas mais recentes da competição especificada.
Por exemplo, a URL abaixo retorna vídeos das partidas mais recentes da Premier League. A string england-premier-league é o identificador exclusivo (ID) da Premier League.
Veja os IDs de algumas das competições mais populares:
Você encontra a lista de IDs de todas as competições aqui.
Equipe
GETVocê pode consultar vídeos de qualquer equipe usando o endpoint Equipe. Esse endpoint retorna vídeos das partidas mais recentes da equipe especificada.
Por exemplo, a URL abaixo retorna vídeos das partidas mais recentes de Real Madrid. A string real-madrid é o identificador exclusivo (ID) de Real Madrid.
Veja os IDs de algumas das equipes mais populares:
Você encontra a lista de IDs de todas as equipes aqui.
Transmissões ao vivo
GETRetorna somente partidas com transmissões oficiais ao vivo disponíveis, incluindo jogos em andamento e já encerrados. Os itens aparecem cerca de 5 minutos antes do início da partida.
- Exibe somente partidas com transmissões oficiais que podem ser incorporadas.
- Inclui partidas ao vivo e encerradas recentemente, com replays da transmissão quando disponíveis.
- Os itens começam a aparecer cerca de 5 minutos antes do horário previsto para o início da partida.
Endpoints atualizados
GETEste endpoint permite identificar quais feeds de competições ou equipes foram atualizados recentemente, eliminando a necessidade de consultar cada endpoint individualmente.
Estrutura da resposta
A resposta é um objeto JSON que contém uma chave response com um array de objetos de partidas. Cada partida inclui informações básicas, dados da competição relacionada e uma lista de vídeos disponíveis.
JSON{"response": [{"title": "Chelsea - Manchester United","competition": "ENGLAND: Premier League","matchviewUrl": "...","competitionUrl": "...","thumbnail": "...","date": "2029-05-18T15:00:00+0000","homeTeam": {"name": "Chelsea","slug": "chelsea","id": 229},"awayTeam": {"name": "Manchester United","slug": "manchester-united","id": 243},"videos": [{"title": "Highlights","embed": "..."},{"title": "Extended Highlights","embed": "..."}]},...]}A chave response contém um array de objetos de partidas. Cada objeto representa uma partida de futebol e inclui os seguintes campos:
title– O nome da partida (por exemplo, Chelsea - Manchester United).competition– O nome da competição (por exemplo, England Premier League).date– A data e o horário de início da partida.thumbnail– A URL da imagem em miniatura da partida.videos– Um array com todos os vídeos disponíveis da partida. Cada objeto de vídeo inclui:title– O título do vídeo (por exemplo, Highlights ou Extended Highlights).embed– O código HTML de incorporação do vídeo.id– O identificador exclusivo do vídeo.
homeTeam/awayTeam– Objetos que representam as equipes participantes da partida, incluindo:name– O nome completo da equipe (por exemplo, Chelsea).slug– O slug da equipe usado nas URLs (por exemplo, chelsea).id– O identificador exclusivo da equipe.
matchviewUrl– A URL da página do widget da partida, com informações detalhadas como placares ao vivo, estatísticas e classificação.competitionUrl– A URL do widget da competição, que mostra classificação ao vivo, resultados e próximos jogos.
Reprodução automática
Você pode ativar a reprodução automática adicionando o parâmetro autoplay=1 à URL do vídeo.
Por exemplo:https://www.scorebat.com/embed/v/69a7723c34f88/?...&autoplay=1Se você estiver usando diretamente o HTML de embed, adicione &autoplay=1 à URL do vídeo no src do iframe.
Cota
Cada plano inclui um limite mensal de requisições.
- Cada visualização de vídeo ou exibição de widget conta como 1 requisição.
- Cada chamada à API de Vídeos conta como 5 requisições na sua franquia mensal.
Por exemplo:
- O plano Starter inclui 5.000 requisições por mês.
- O plano Standard inclui 20.000 requisições por mês.
- O plano Advanced inclui 100.000 requisições por mês.
- Se você precisar de um limite maior, fale conosco para conhecer nossos planos Enterprise.
Se você ultrapassar seu limite mensal de requisições, sua conta mudará automaticamente para o plano Gratuito até o próximo período de cobrança. Nesse intervalo, anúncios e logotipos da ScoreBat aparecerão nos widgets e vídeos, e somente o endpoint Free Feed continuará acessível.