Skip to Content

Deep Links

Gere deep links de sportsbooks a partir de IDs de odds ou hash IDs de oportunidades. Os deep links levam os usuários diretamente para a página do evento relevante no site de um sportsbook, permitindo a colocação de apostas com um clique a partir da sua aplicação.

EndpointsLink permanente para esta seção

MétodoCaminhoDescrição
POST/api/v1/deeplinks/batchObtém deep links para até 500 IDs
GET/api/v1/deeplink/{id}Redireciona para um sportsbook (público; sem API key há um limite de requisições)

AutenticaçãoLink permanente para esta seção

Requer API key para POST /deeplinks/batch. Disponível para o tier Hobby e superiores.

O endpoint de redirecionamento (GET /deeplink/{id}) é público e não requer autenticação — o ID opaco previne enumeração. Uma requisição sem API key tem um limite de requisições, então um programa que abre muitos links deve enviar sua chave.

O parâmetro id aceita tanto IDs de odds (de /odds, /odds/best) quanto hash IDs de oportunidades (dos endpoints +EV, Arbitragem, Middles e Low Hold). Os dois tipos de ID resolvem para o link mais específico que aquele sportsbook suporta — a especificidade é uma propriedade do sportsbook, não do tipo de ID. Leia X-Deep-Link-Type no redirecionamento para ver o que você recebeu, e consulte Sportsbooks Suportados para saber quais pré-selecionam a aposta.


POST /api/v1/deeplinks/batch

Retorna caminhos de redirecionamento de deep links para múltiplos IDs em uma única requisição. Aceita tanto IDs de odds quanto hash IDs de oportunidades. Cada ID na requisição aparece na resposta — IDs resolvidos retornam um caminho de redirecionamento, IDs irresolvíveis retornam null.

Corpo da RequisiçãoLink permanente para esta seção

{ "ids": ["17336125542407", "77b0749a1faae425", "abc1234567890def"], "state": "nj" }
CampoTipoPadrãoDescrição
idsstring[]obrigatórioArray de IDs de odds ou hash IDs de oportunidades (1–500 itens)
statestringpaCódigo de estado dos EUA apenas para o destino do deep link; não filtra odds nem retorna preços específicos por estado. Usa os 50 códigos de estados e dc; este endpoint em lote usa pa para valores omitidos, vazios ou não aceitos (incluindo on). O redirecionamento individual rejeita códigos não vazios não aceitos.

Exemplos de RequisiçõesLink permanente para esta seção

curl -X POST "https://api.sharpapi.io/api/v1/deeplinks/batch" \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"ids": ["17336125542407", "77b0749a1faae425"], "state": "nj"}'

RespostaLink permanente para esta seção

Sucesso (200)Link permanente para esta seção

O endpoint em lote retorna caminhos de redirecionamento, não URLs diretas de sportsbook. Anexe sua URL base ou use o caminho com o endpoint de redirecionamento para acessar o sportsbook.

{ "data": { "17336125542407": "/api/v1/deeplink/17336125542407", "77b0749a1faae425": "/api/v1/deeplink/77b0749a1faae425", "abc1234567890def": null }, "updated_at": "2026-02-11T12:00:15.000Z" }
ValorSignificado
"/api/v1/deeplink/{id}"Deeplink disponível — siga o caminho de redirecionamento para acessar o sportsbook
nullNenhum deeplink disponível para este ID (sportsbook não suportado, odds expirado ou ID inválido)

Para obter a URL final do sportsbook, siga o redirecionamento (GET https://api.sharpapi.io/api/v1/deeplink/{id}) ou use o caminho diretamente em links <a href> — o navegador seguirá o redirecionamento 302 automaticamente. Um programa que segue muitos redirecionamentos sem API key tem um limite de requisições.

Respostas de ErroLink permanente para esta seção

400 IDs ausentes

{ "error": { "code": "validation_error", "message": "ids array required" } }

400 Tamanho do lote excedido

{ "error": { "code": "validation_error", "message": "Maximum 500 IDs per batch" } }

GET /api/v1/deeplink/{id}

Redireciona o usuário diretamente para a página do sportsbook para um determinado ID de odds ou hash ID de oportunidade. Este é um endpoint público — funciona sem API key, mas uma requisição sem ela tem um limite de requisições.

Use este endpoint em links <a href> para enviar os usuários diretamente para um sportsbook. A resposta é um redirecionamento 302 Found, não JSON.

Parâmetros de CaminhoLink permanente para esta seção

ParâmetroTipoDescrição
idstringObrigatório. Um ID numérico de odds (ex.: 135102220304350) ou um hash ID de oportunidade (hex de 16 caracteres, ex.: 77b0749a1faae425)

Parâmetros de QueryLink permanente para esta seção

ParâmetroTipoPadrãoDescrição
statestringpaCódigo de estado dos EUA apenas para o destino do deep link; não filtra odds nem retorna preços específicos por estado. Aceita os 50 códigos de estados dos EUA e dc. Códigos não vazios não aceitos (incluindo on) retornam 400 invalid_filter. Valores omitidos ou vazios usam pa.
bookstring—Filtro de sportsbook (para oportunidades multi-sportsbook como middles/arbitragem)
fallbackstring—URL para redirecionar caso o ID não seja encontrado. Só é respeitada uma URL absoluta http ou https, sem porta nem dados de usuário, em sharpapi.io, sharplines.io ou no site de um sportsbook que o endpoint reconhece (por exemplo https://sportsbook.draftkings.com/); subdomínios contam. Qualquer outro valor é ignorado: um ID encontrado redireciona normalmente e um ID não encontrado retorna 404 not_found.

ExemploLink permanente para esta seção

<!-- In your application HTML --> <a href="https://api.sharpapi.io/api/v1/deeplink/77b0749a1faae425?state=nj&book=draftkings"> Bet on DraftKings </a>

RespostaLink permanente para esta seção

Sucesso (302 Found)Link permanente para esta seção

HTTP/1.1 302 Found Location: https://sportsbook.draftkings.com/event/12345?outcomes=abc123 Cache-Control: private, max-age=60 X-Deep-Link-Type: outcome

O cabeçalho X-Deep-Link-Type indica a especificidade do link:

ValorDescrição
outcomeLink direto para uma seleção de aposta específica (com ID de seleção)
eventLink para a página do evento (sem seleção específica)
homepageFallback para a página inicial do sportsbook

Respostas de ErroLink permanente para esta seção

404 Não encontrado

{ "error": { "code": "not_found", "message": "Deep link ID not found" } }

Se o parâmetro de query fallback for uma URL aceita (veja a tabela de parâmetros acima) e o ID não for encontrado, o endpoint redireciona para essa URL em vez de retornar uma resposta JSON 404. Um fallback que o endpoint não aceita é ignorado, e o 404 acima é retornado.


Limite de requisições sem API keyLink permanente para esta seção

O redirecionamento continua público, mas toda requisição a api.sharpapi.io que não leve API key é limitada por endereço de cliente: 12 requisições por minuto, com uma rajada permitida de 5. Clientes IPv6 são contados por rede /64. O redirecionamento do link de aposta está sujeito a esse limite como qualquer outra requisição sem chave. Uma requisição que leva API key não está sujeita a esse limite para requisições sem chave.

Acima do limite, a resposta é 429 com o header Retry-After: 10 (segundos):

{ "error": { "code": "rate_limited", "message": "Too many unauthenticated requests. Get a free API key at sharpapi.io", "retryAfter": 10 } }

O que fazer:

  • Uma pessoa clicando em links no navegador fica bem abaixo do limite. Nada a fazer: mantenha os links da sua página web sem chave.
  • Um programa que segue redirecionamentos em massa (por exemplo, para resolver os endereços finais dos sportsbooks em um servidor) deve enviar sua API key, espaçar suas requisições e guardar em cache o que já resolveu. O endpoint em lote acima retorna caminhos de redirecionamento, não endereços finais de sportsbooks, então ele não elimina a etapa do redirecionamento.
  • Nunca coloque uma API key em um link mostrado aos seus próprios usuários. Um <a href> com api_key= entrega sua chave a cada visitante.

Envie a chave no header X-API-Key (recomendado), em um header Authorization: Bearer ou como parâmetro de query api_key. As três formas estão em Autenticação. Uma requisição feita no servidor que resolve um link:

curl -i -H "X-API-Key: YOUR_API_KEY" \ "https://api.sharpapi.io/api/v1/deeplink/77b0749a1faae425?state=nj"

Quando um ID responde 404 not_found, tentar o mesmo ID de novo não ajuda. Linhas novas trazem links novos.


Resposta em LoteLink permanente para esta seção

CampoTipoDescrição
dataobjectMapa de ID para caminho de redirecionamento (string) ou null se indisponível
updated_atstringTimestamp ISO 8601 dos dados de odds

Sportsbooks SuportadosLink permanente para esta seção

O suporte a deep links depende de cada sportsbook, e a especificidade do link também. Se um link abre a página do evento ou abre o bilhete com sua seleção já carregada é decidido pelo site daquele sportsbook — não pelo tipo de ID que você enviou. O header X-Deep-Link-Type do redirecionamento informa qual dos dois você recebeu, link a link.

Medido contra a produção em 2026-08-25, em todos os sportsbooks que a API estava servindo no momento — 26 de 35 resolvem um deep link, e 12 deles pré-selecionam a aposta:

SportsbookDeep linkPré-seleciona sua seleçãoEspecífico por estado
BallyBetSimSimNão
BetMGMSimSimSim
betPARXSimSimNão
BetRiversSimSimSim
BetwaySimSimNão
BovadaSimSimNão
bwinSimSimNão
CaesarsSimSimSim
DraftKingsSimSimNão
FanDuelSimSimNão
Hard RockSimSimNão
UnibetSimSimNão
1xBetSimNãoNão
BetanoSimNãoNão
BetOnlineSimNãoNão
KalshiSimNãoNão
LadbrokesSimNãoNão
NovigSimNãoNão
PinnacleSimNãoNão
PolymarketSimNãoNão
ProphetXSimNãoNão
SportzinoSimNãoNão
StakeSimNãoNão
Rebet †Link de appNãoNão
SBOBET ‡ParcialNãoNão
SX Bet ‡ParcialNãoNão
Betfair ExchangeNão——
CircaNão——
FanaticsNão——
FliffNão——
GoldrushNão——
SABANão——
SkyBetNão——
theScore BetNão——
UnderdogNão——

† Rebet resolve para um link de app móvel (com.rebet.app://…). No desktop o endpoint de redirecionamento usa sua URL de fallback, se a aceitar, e reporta X-Deep-Link-Type: homepage.

‡ SBOBET e SX Bet resolvem para uma página de esporte ou de liga em vez do evento individual.

IDs de um sportsbook do grupo Não retornam null na resposta em lote, e o endpoint de redirecionamento retorna 404 a menos que você passe um fallback aceito. Mesmo em um sportsbook suportado um ID específico pode retornar null — nem todo mercado tem página. Um sportsbook que não estava publicando odds no momento da medição não aparece na lista.

Deep links da Pinnacle não conseguem pré-selecionar uma aposta. O link da Pinnacle é uma página de confronto (https://www.pinnacle.com/en/all-sports/matchup/{id}) e não tem parâmetro de seleção para carregar seu resultado, então ele fica em nível de evento tanto se você enviar um ID numérico de odds quanto um hash ID de oportunidade. O apostador escolhe o resultado na página.

Endpoints RelacionadosLink permanente para esta seção

  • Oportunidades +EV - Fonte de valores hash_id para apostas +EV
  • Arbitragem - Fonte de valores hash_id para oportunidades de arbitragem
  • Middles - Fonte de valores hash_id para oportunidades de middle
  • Low Hold - Fonte de valores hash_id para oportunidades de low-hold
Last updated on