Deep Links

Genera deep links de casas de apuestas a partir de IDs de cuotas o IDs hash de oportunidades. Los deep links llevan a los usuarios directamente a la página del evento correspondiente en el sitio web de una casa de apuestas, permitiendo la colocación de apuestas con un solo clic desde tu aplicación.

Endpoints

Autenticación

Requiere API key para POST /deeplinks/batch. Disponible para el plan Hobby y superiores.

El endpoint de redirección (GET /deeplink/{id}) es público y no requiere autenticación — el ID opaco impide la enumeración.

Deep Links por Lotes

POST /api/v1/deeplinks/batch

Devuelve rutas de redirección de deep links para múltiples IDs en una única solicitud. Acepta tanto IDs de cuotas como IDs hash de oportunidades. Cada ID de la solicitud aparece en la respuesta — los IDs resueltos devuelven una ruta de redirección, los IDs no resolubles devuelven null.

Cuerpo de la Solicitud

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

Ejemplos de Solicitudes

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

Respuesta

Éxito (200)

El endpoint por lotes devuelve rutas de redirección, no URLs directas a casas de apuestas. Antepón tu URL base o utiliza la ruta con el endpoint de redirección para llegar a la casa de apuestas.

{
  "data": {
    "17336125542407": "/api/v1/deeplink/17336125542407",
    "77b0749a1faae425": "/api/v1/deeplink/77b0749a1faae425",
    "abc1234567890def": null
  },
  "updated_at": "2026-02-11T12:00:15.000Z"
}

Respuestas de Error

400 IDs faltantes

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

400 Tamaño de lote excedido

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

Redirección de Deep Link

GET /api/v1/deeplink/{id}

Redirige al usuario directamente a la página de la casa de apuestas correspondiente a un ID de cuotas o ID hash de oportunidad determinado. Este es un endpoint público — no se requiere API key.

Parámetros de Ruta

Parámetros de Consulta

Ejemplo

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

Respuesta

Éxito (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

El encabezado X-Deep-Link-Type indica la especificidad del enlace:

Respuestas de Error

404 No encontrado

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

Esquema de Deep Link

Respuesta por Lotes

Casas de Apuestas Compatibles

Los deep links están disponibles para 21 de las 28 casas de apuestas. Los libros específicos por estado utilizan el parámetro state para generar la URL regional correcta.

Las siguientes casas de apuestas no son compatibles actualmente con deep links. Los IDs de estos libros devolverán null en la respuesta por lotes:

Bet105, Bookmaker, Fliff, Rebet, SABA

Endpoints Relacionados

• Oportunidades +EV - Origen de los valores de hash_id para apuestas +EV
• Arbitraje - Origen de los valores de hash_id para oportunidades de arbitraje
• Middles - Origen de los valores de hash_id para oportunidades de middle
• Low Hold - Origen de los valores de hash_id para oportunidades de low-hold