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.

Endpoints

Autenticaçã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.

Deep Links em Lote

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ção

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

Exemplos de Requisições

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

Resposta

Sucesso (200)

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 Erro

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 Link

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 Caminho

Parâmetros de Query

Exemplo

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

Resposta

Sucesso (302 Found)

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 Erro

404 Não encontrado

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

Schema de Deep Link

Resposta em Lote

Sportsbooks Suportados

Deep links estão disponíveis para 21 dos 28 sportsbooks. Sportsbooks específicos por estado usam o parâmetro state para gerar a URL regional correta.

Os seguintes sportsbooks não suportam deep links atualmente. IDs para esses sportsbooks retornarão null na resposta em lote:

Bet105, Bookmaker, Fliff, Rebet, SABA

Endpoints Relacionados

• 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