Skip to Content

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.

EndpointsEnlace permanente a esta sección

MétodoRutaDescripción
POST/api/v1/deeplinks/batchObtener deep links para hasta 500 IDs
GET/api/v1/deeplink/{id}Redirigir a una casa de apuestas (público; sin API key tiene un límite de solicitudes)

AutenticaciónEnlace permanente a esta secció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. Una solicitud sin API key tiene un límite de solicitudes, así que un programa que abre muchos enlaces debe enviar su clave.

El parámetro id acepta tanto IDs de cuotas (de /odds, /odds/best) como IDs hash de oportunidades (de los endpoints +EV, Arbitraje, Middles y Low Hold). Ambos tipos de ID se resuelven al enlace más específico que admita esa casa de apuestas — la especificidad es una propiedad de la casa, no del tipo de ID. Lee X-Deep-Link-Type en la redirección para ver qué obtuviste, y consulta Casas de Apuestas Compatibles para saber cuáles preseleccionan la apuesta.


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 SolicitudEnlace permanente a esta sección

{ "ids": ["17336125542407", "77b0749a1faae425", "abc1234567890def"], "state": "nj" }
CampoTipoPor defectoDescripción
idsstring[]obligatorioArray de IDs de cuotas o IDs hash de oportunidades (1–500 elementos)
statestringpaCódigo de estado de EE. UU. solo para el destino del enlace; no filtra cuotas ni devuelve precios específicos por estado. Usa los 50 códigos de estados y dc; este endpoint por lotes usa pa si el valor se omite, está vacío o no se admite (incluido on). La redirección individual rechaza los códigos no vacíos no admitidos.

Ejemplos de SolicitudesEnlace permanente a esta sección

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

RespuestaEnlace permanente a esta sección

Éxito (200)Enlace permanente a esta sección

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" }
ValorSignificado
"/api/v1/deeplink/{id}"Deep link disponible — sigue la ruta de redirección para llegar a la casa de apuestas
nullNo hay deep link disponible para este ID (casa de apuestas no compatible, cuotas caducadas o ID no válido)

Para obtener la URL final de la casa de apuestas, sigue la redirección (GET https://api.sharpapi.io/api/v1/deeplink/{id}) o utiliza la ruta directamente en enlaces <a href> — el navegador seguirá la redirección 302 automáticamente. Un programa que sigue muchas redirecciones sin API key tiene un límite de solicitudes.

Respuestas de ErrorEnlace permanente a esta sección

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

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 — funciona sin API key, pero una solicitud sin ella tiene un límite de solicitudes.

Utiliza este endpoint en enlaces <a href> para enviar a los usuarios directamente a una casa de apuestas. La respuesta es una redirección 302 Found, no JSON.

Parámetros de RutaEnlace permanente a esta sección

ParámetroTipoDescripción
idstringObligatorio. Ya sea un ID numérico de cuotas (p. ej., 135102220304350) o un ID hash de oportunidad (16 caracteres hex, p. ej., 77b0749a1faae425)

Parámetros de ConsultaEnlace permanente a esta sección

ParámetroTipoPor defectoDescripción
statestringpaCódigo de estado de EE. UU. solo para el destino del enlace; no filtra cuotas ni devuelve precios específicos por estado. Acepta los 50 códigos de estados de EE. UU. y dc. Los códigos no vacíos no admitidos (incluido on) devuelven 400 invalid_filter. Los valores omitidos o vacíos usan pa.
bookstring—Filtro de casa de apuestas (para oportunidades multi-libro como middles/arbitraje)
fallbackstring—URL a la que redirigir si el ID no se encuentra. Solo se respeta una URL absoluta http o https, sin puerto ni datos de usuario, en sharpapi.io, sharplines.io o el sitio web de una casa de apuestas que el endpoint reconoce (por ejemplo https://sportsbook.draftkings.com/); los subdominios cuentan. Cualquier otro valor se ignora: un ID encontrado redirige como siempre y un ID no encontrado devuelve 404 not_found.

EjemploEnlace permanente a esta sección

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

RespuestaEnlace permanente a esta sección

Éxito (302 Found)Enlace permanente a esta sección

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:

ValorDescripción
outcomeEnlace directo a una selección de apuesta específica (con ID de selección)
eventEnlace a la página del evento (sin selección específica)
homepageEnlace de respaldo a la página de inicio de la casa de apuestas

Respuestas de ErrorEnlace permanente a esta sección

404 No encontrado

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

Si el parámetro de consulta fallback es una URL aceptada (consulta la tabla de parámetros de arriba) y el ID no se encuentra, el endpoint redirige a esa URL en lugar de devolver una respuesta JSON 404. Un fallback que el endpoint no acepta se ignora, y se devuelve el 404 de arriba.


Límite de solicitudes sin API keyEnlace permanente a esta sección

La redirección sigue siendo pública, pero toda solicitud a api.sharpapi.io que no lleve API key está limitada por dirección de cliente: 12 solicitudes por minuto, con una ráfaga permitida de 5. Los clientes IPv6 se cuentan por red /64. La redirección del enlace de apuesta está sujeta a este límite como cualquier otra solicitud sin clave. Una solicitud que lleva API key no está sujeta a este límite para solicitudes sin clave.

Por encima del límite, la respuesta es 429 con el encabezado Retry-After: 10 (segundos):

{ "error": { "code": "rate_limited", "message": "Too many unauthenticated requests. Get a free API key at sharpapi.io", "retryAfter": 10 } }

Qué hacer:

  • Una persona que hace clic en enlaces en un navegador queda muy por debajo del límite. No hay nada que hacer: deja los enlaces de tu página web sin clave.
  • Un programa que sigue redirecciones en masa (por ejemplo, para resolver las direcciones finales de las casas de apuestas en un servidor) debe enviar su API key, espaciar sus solicitudes y guardar en caché lo que ya resolvió. El endpoint por lotes de arriba devuelve rutas de redirección, no direcciones finales de casas de apuestas, así que no elimina el paso de la redirección.
  • Nunca pongas una API key en un enlace que se muestra a tus propios usuarios. Un <a href> con api_key= entrega tu clave a cada visitante.

Envía la clave en el encabezado X-API-Key (recomendado), en un encabezado Authorization: Bearer o como parámetro de consulta api_key. Las tres formas están en Autenticación. Una solicitud desde el servidor que resuelve un enlace:

curl -i -H "X-API-Key: YOUR_API_KEY" \ "https://api.sharpapi.io/api/v1/deeplink/77b0749a1faae425?state=nj"

Cuando un ID responde 404 not_found, reintentar el mismo ID no ayuda. Las filas nuevas traen enlaces nuevos.


Respuesta por LotesEnlace permanente a esta sección

CampoTipoDescripción
dataobjectMapa de ID a ruta de redirección (string) o null si no está disponible
updated_atstringMarca de tiempo ISO 8601 de los datos de cuotas

Casas de Apuestas CompatiblesEnlace permanente a esta sección

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:

Casa de ApuestasDeep linkPreselecciona tu selecciónEspecífico por estado
BallyBetSíSíNo
BetMGMSíSíSí
betPARXSíSíNo
BetRiversSíSíSí
BetwaySíSíNo
BovadaSíSíNo
bwinSíSíNo
CaesarsSíSíSí
DraftKingsSíSíNo
FanDuelSíSíNo
Hard RockSíSíNo
UnibetSíSíNo
1xBetSíNoNo
BetanoSíNoNo
BetOnlineSíNoNo
KalshiSíNoNo
LadbrokesSíNoNo
NovigSíNoNo
PinnacleSíNoNo
PolymarketSíNoNo
ProphetXSíNoNo
SportzinoSíNoNo
StakeSíNoNo
Rebet †Enlace de appNoNo
SBOBET ‡ParcialNoNo
SX Bet ‡ParcialNoNo
Betfair ExchangeNo——
CircaNo——
FanaticsNo——
FliffNo——
GoldrushNo——
SABANo——
SkyBetNo——
theScore BetNo——
UnderdogNo——

† Rebet resuelve a un enlace de app móvil (com.rebet.app://…). En escritorio el endpoint de redirección usa tu URL de fallback, si la acepta, 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 un fallback que acepte. 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.

Los deep links de Pinnacle no pueden preseleccionar una apuesta. El enlace de Pinnacle es una página de enfrentamiento (https://www.pinnacle.com/en/all-sports/matchup/{id}) y no tiene parámetro de selección que transporte tu resultado, así que es de nivel de evento tanto si envías un ID numérico de cuota como un ID hash de oportunidad. El apostante elige el resultado en la página.

Endpoints RelacionadosEnlace permanente a esta sección

  • 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
Last updated on