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étodo | Caminho | Descrição |
|---|---|---|
POST | /api/v1/deeplinks/batch | Obté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.
Deep Links em LoteLink permanente para esta seção
POST /api/v1/deeplinks/batchRetorna 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"
}| Campo | Tipo | Padrão | Descrição |
|---|---|---|---|
ids | string[] | obrigatório | Array de IDs de odds ou hash IDs de oportunidades (1–500 itens) |
state | string | pa | Có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
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"
}| Valor | Significado |
|---|---|
"/api/v1/deeplink/{id}" | Deeplink disponível — siga o caminho de redirecionamento para acessar o sportsbook |
null | Nenhum 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"
}
}Redirecionamento de Deep LinkLink permanente para esta seção
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âmetro | Tipo | Descrição |
|---|---|---|
id | string | Obrigató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âmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
state | string | pa | Có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. |
book | string | — | Filtro de sportsbook (para oportunidades multi-sportsbook como middles/arbitragem) |
fallback | string | — | 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: outcomeO cabeçalho X-Deep-Link-Type indica a especificidade do link:
| Valor | Descrição |
|---|---|
outcome | Link direto para uma seleção de aposta específica (com ID de seleção) |
event | Link para a página do evento (sem seleção específica) |
homepage | Fallback 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>comapi_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.
Schema de Deep LinkLink permanente para esta seção
Resposta em LoteLink permanente para esta seção
| Campo | Tipo | Descrição |
|---|---|---|
data | object | Mapa de ID para caminho de redirecionamento (string) ou null se indisponível |
updated_at | string | Timestamp 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:
| Sportsbook | Deep link | Pré-seleciona sua seleção | Específico por estado |
|---|---|---|---|
| BallyBet | Sim | Sim | Não |
| BetMGM | Sim | Sim | Sim |
| betPARX | Sim | Sim | Não |
| BetRivers | Sim | Sim | Sim |
| Betway | Sim | Sim | Não |
| Bovada | Sim | Sim | Não |
| bwin | Sim | Sim | Não |
| Caesars | Sim | Sim | Sim |
| DraftKings | Sim | Sim | Não |
| FanDuel | Sim | Sim | Não |
| Hard Rock | Sim | Sim | Não |
| Unibet | Sim | Sim | Não |
| 1xBet | Sim | Não | Não |
| Betano | Sim | Não | Não |
| BetOnline | Sim | Não | Não |
| Kalshi | Sim | Não | Não |
| Ladbrokes | Sim | Não | Não |
| Novig | Sim | Não | Não |
| Pinnacle | Sim | Não | Não |
| Polymarket | Sim | Não | Não |
| ProphetX | Sim | Não | Não |
| Sportzino | Sim | Não | Não |
| Stake | Sim | Não | Não |
| Rebet † | Link de app | Não | Não |
| SBOBET ‡ | Parcial | Não | Não |
| SX Bet ‡ | Parcial | Não | Não |
| Betfair Exchange | Não | — | — |
| Circa | Não | — | — |
| Fanatics | Não | — | — |
| Fliff | Não | — | — |
| Goldrush | Não | — | — |
| SABA | Não | — | — |
| SkyBet | Não | — | — |
| theScore Bet | Não | — | — |
| Underdog | Nã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_idpara apostas +EV - Arbitragem - Fonte de valores
hash_idpara oportunidades de arbitragem - Middles - Fonte de valores
hash_idpara oportunidades de middle - Low Hold - Fonte de valores
hash_idpara oportunidades de low-hold