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.

EndpointsPermalink for this section

AutenticaçãoPermalink for this section

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.

Deep Links em LotePermalink for this section

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çãoPermalink for this section

{
  "ids": ["17336125542407", "77b0749a1faae425", "abc1234567890def"],
  "state": "nj"
}

Exemplos de RequisiçõesPermalink for this section

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"}'

const response = await fetch(
  'https://api.sharpapi.io/api/v1/deeplinks/batch',
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      ids: ['17336125542407', '77b0749a1faae425'],
      state: 'nj'
    })
  }
);
const { data } = await response.json();
 
for (const [id, link] of Object.entries(data)) {
  if (link) {
    console.log(`${id}: https://api.sharpapi.io${link}`);
  } else {
    console.log(`${id}: not available`);
  }
}

import requests
 
response = requests.post(
    'https://api.sharpapi.io/api/v1/deeplinks/batch',
    headers={
        'X-API-Key': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'ids': ['17336125542407', '77b0749a1faae425'],
        'state': 'nj'
    }
)
result = response.json()
 
for id, link in result['data'].items():
    if link:
        print(f"{id}: https://api.sharpapi.io{link}")
    else:
        print(f"{id}: not available")

RespostaPermalink for this section

Sucesso (200)Permalink for this section

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"
}

Respostas de ErroPermalink for this section

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 LinkPermalink for this section

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 — nenhuma API key é necessária.

Parâmetros de CaminhoPermalink for this section

Parâmetros de QueryPermalink for this section

ExemploPermalink for this section

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

RespostaPermalink for this section

Sucesso (302 Found)Permalink for this section

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:

Respostas de ErroPermalink for this section

404 Não encontrado

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

Schema de Deep LinkPermalink for this section

Resposta em LotePermalink for this section

Sportsbooks SuportadosPermalink for this section

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:

† Rebet resolve para um link de app móvel (com.rebet.app://…). No desktop o endpoint de redirecionamento usa sua URL de fallback 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 fallback. 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.

Endpoints RelacionadosPermalink for this section

• 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