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.

EndpointsPermalink for this section

AutenticaciónPermalink for this section

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

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

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

Ejemplos de SolicitudesPermalink 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")

RespuestaPermalink for this section

Éxito (200)Permalink for this section

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

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

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

Parámetros de ConsultaPermalink for this section

EjemploPermalink 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>

RespuestaPermalink for this section

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

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

Respuestas de ErrorPermalink for this section

404 No encontrado

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

Esquema de Deep LinkPermalink for this section

Respuesta por LotesPermalink for this section

Casas de Apuestas CompatiblesPermalink for this section

El soporte de deep links depende de cada casa de apuestas, y la especificidad del enlace también. Que un enlace abra la página del evento o abra el boleto con tu selección ya cargada lo decide el sitio de esa casa de apuestas — no el tipo de ID que enviaste. La cabecera X-Deep-Link-Type de la redirección te dice cuál obtuviste, enlace por enlace.

Medido contra producción el 2026-08-25, sobre todas las casas de apuestas que la API servía en ese momento — 26 de 35 resuelven un deep link, y 12 de ellas preseleccionan la apuesta:

† Rebet resuelve a un enlace de app móvil (com.rebet.app://…). En escritorio el endpoint de redirección usa tu URL de fallback y reporta X-Deep-Link-Type: homepage.

‡ SBOBET y SX Bet resuelven a una página de deporte o de liga en lugar del evento individual.

Los IDs de una casa de apuestas del grupo No devuelven null en la respuesta por lotes, y el endpoint de redirección devuelve 404 salvo que envíes fallback. Incluso en una casa compatible un ID concreto puede devolver null — no todos los mercados tienen página. Una casa de apuestas que no publicaba cuotas al momento de la medición no aparece listada.

Endpoints RelacionadosPermalink for this section

• 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