¡Bienvenido a nuestro sistema de API! Siguiendo estos sencillos pasos, podrás comenzar rápidamente a trabajar con nuestra API e integrar datos deportivos en tu sistema.
Obtén la clave API para poder integrar los datos
Contacta al soporte técnico y se te proporcionará una clave API única y la dirección del dominio para realizar futuras consultas. Esta clave es necesaria para autenticar todas las solicitudes a nuestra API.
Consulta la documentación
Una vez que hayas recibido la clave, puedes acceder a la Documentación de la API y revisar los métodos disponibles, ejemplos de solicitudes y respuestas. Esto te ayudará a comprender cómo integrar los datos deportivos en tu sistema.
Haz la primera solicitud
Utilizando tu clave API, realiza la primera solicitud a la API. En la documentación encontrarás ejemplos de solicitudes y respuestas para diferentes tipos de datos deportivos.
Comienza la integración
Después de realizar con éxito la solicitud de prueba, puedes comenzar a integrar los datos en tu proyecto. Nuestra API proporciona herramientas flexibles para trabajar con diferentes tipos de deportes y eventos.
Obtén soporte
Si tienes alguna pregunta, siempre puedes contactar a nuestro equipo de soporte técnico o consultar la sección de preguntas frecuentes (FAQ) para resolver problemas comunes.
La API para la línea deportiva ofrece un conjunto limitado de métodos que permiten obtener diversos datos deportivos. A continuación se muestra una lista de todos los métodos disponibles, cada uno de los cuales devuelve un conjunto específico de información para realizar tareas determinadas. Puedes elegir el método adecuado según tus necesidades. Además, cada método puede utilizar parámetros que te ayudarán a filtrar y personalizar los datos recibidos. A continuación se presenta una descripción detallada de los parámetros.
menu El método devuelve la estructura del menú de eventos deportivos, incluidos deportes, países y campeonatos.events El método devuelve una lista de partidos con un conjunto breve de cuotas disponibles para apuestas.event El método devuelve información detallada sobre un evento deportivo específico por su ID, así como las apuestas completas, cuotas y resultados para ese partido.topmatches El método devuelve una lista de partidos destacados, que son los más populares entre los usuarios o tienen alta actividad de apuestas.search El método permite buscar eventos deportivos por palabras clave, como nombres de equipos.Para trabajar con nuestra API, puedes utilizar diferentes parámetros que te ayudarán a personalizar las solicitudes y obtener datos precisos que se ajusten a tus necesidades. Los parámetros permiten filtrar los datos por tipo de deporte, país, torneos, así como personalizar el formato de los eventos devueltos. A continuación, se muestra una lista de los parámetros disponibles y su descripción, que te ayudarán a gestionar de manera flexible las solicitudes a nuestra API.
API-URL-LINE La URL del host desde la que se solicitan los datos de la línea deportiva. Es decir, es la URL a la que enviarás solicitudes para obtener los datos deportivos.API-KEY Clave de acceso personal PersonalKey, que determina tu paquete de servicios. Esta clave se envía en los headers de cada solicitud.METHODS-API Nombres de los métodos para obtener los datos. Todos los métodos están descritos en el apartado anterior.TYPE Tipo de datos de la línea deportiva. Puede tener los valores live (para datos en tiempo real) o line (para la línea previa al partido).LANG Idioma en el que se proporcionarán los datos de la línea deportiva. Los idiomas disponibles dependen de tu paquete.SPORT-ID Identificador del deporte.COUNTRY-ID Identificador del país.CHAMPIONSHIP-ID Identificador del torneo.MATCH-ID Identificador del partido.KG Modo de visualización de eventos y cuotas. Están disponibles dos opciones: sub, los partidos se agrupan por campeonatos; list, los partidos se muestran en una lista sin agrupar.En un partido específico, la agrupación afecta no a los partidos, sino a los resultados y apuestas. De esta manera, obtienes una lista de cuotas que pueden mostrarse simplemente como una lista o agrupadas de manera lógica por tipos de resultados.
En esta sección se muestra un ejemplo de solicitud a nuestro API para obtener datos deportivos. El ejemplo demuestra cómo puedes usar uno de los métodos del API con tus parámetros únicos, como la clave de API. Esto te ayudará a comprender mejor cómo formar correctamente las solicitudes y obtener la información que necesitas.
Los datos en el ejemplo no son reales. Sustitúyelos con datos reales proporcionados por el soporte técnico.
GETEsquema : [API-URL-LINE] /v1/ [METHODS-API] / [TYPE] / [LANG]
Solicitud: HTTPS://example-domain-demo.com/v1/menu/live/en
Headers: 'Package': '0145-3455-1298-2978-1100'
import requests
url = "https://example-domain-demo.com/v1/menu/live/en"
payload = {}
headers = {
'Package': '0145-3455-1298-2978-1100'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://example-domain-demo.com/v1/menu/live/en',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_HTTPHEADER => array(
'Package: 0145-3455-1298-2978-1100'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
const myHeaders = new Headers();
myHeaders.append("Package", "0145-3455-1298-2978-1100");
const requestOptions = {
method: "GET",
headers: myHeaders,
redirect: "follow"
};
fetch("https://example-domain-demo.com/v1/menu/live/en", requestOptions)
.then((response) => response.text())
.then((result) => console.log(result))
.catch((error) => console.error(error));
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
.url("https://example-domain-demo.com/v1/menu/live/en")
.method("GET", body)
.addHeader("Package", "0145-3455-1298-2978-1100")
.build();
Response response = client.newCall(request).execute();
Para facilitar la integración de nuestra API, hemos preparado una colección de solicitudes para Postman. Puedes descargar el archivo, importarlo en Postman y comenzar a trabajar con nuestra API de inmediato, sin necesidad de configurar las solicitudes manualmente.
Pasos para comenzar en Postman:
Descarga la colección de Postman:
Descargar colección para Postman
Importa el archivo en Postman:
Configura las variables:
Después de importar la colección, deberás agregar tus claves API y otros parámetros. Esto se puede hacer en la sección Variables de la colección o agregarlas manualmente a cada solicitud.
Ejecuta las solicitudes:
Ahora puedes comenzar a enviar solicitudes y recibir datos de nuestra API de inmediato.
Envía esta solicitud para obtener el menú, que incluye todos los datos necesarios para luego obtener partidos y resultados:
Se recomienda enviar solicitudes para la línea cada 40 segundos como mínimo. Para partidos en vivo, el intervalo debe ser de al menos 20 segundos. Los datos no se actualizan con mucha frecuencia, por lo que este intervalo será suficiente para obtener información actualizada.
GETEsquema : [API-URL-LINE] /v1/ [METHODS-API] / [TYPE] / [LANG]
Solicitud: HTTPS://example-domain-demo.com/v1/menu/live/en
Headers: 'Package': '0145-3455-1298-2978-1100'
{
"status":1,
"body":[
{
"id":1,
"name":"Football",
"counter":126,
"sub":[
{
"id":12,
"name":"Europe",
"sport_id":1,
"counter":10,
"sub":[
{
"id":118587,
"name":"UEFA Champions League",
"sport_id":1,
"country_id":12,
"counter":3
},
{
"id":218103,
"name":"UEFA Champions League. Winner",
"sport_id":1,
"country_id":12,
"counter":1
},
{
"id":16,
"name":"Italy",
"sport_id":1,
"counter":1,
"sub":[
{
"id":6356,
"name":"Italy. Serie C. Group A",
"sport_id":1,
"country_id":16,
"counter":1
}
]
}
]
}
]
},
{
"id":2,
"name":"Tennis",
"counter":40,
"sub":[
{
"id":14,
"name":"Portugal",
"sport_id":2,
"counter":1,
"sub":[
{
"id":8031,
"name":"Challenger. Braga",
"sport_id":2,
"country_id":14,
"counter":1
}
]
}
]
}
]
}
id Identificador único del elemento (por ejemplo, deporte, país o campeonato).name Nombre del elemento (por ejemplo, Fútbol para deporte, Europa para país o UEFA Champions League para campeonato).counter Cantidad de eventos o partidos disponibles para este elemento.sub Matriz que contiene elementos anidados, como países o campeonatos para el deporte seleccionado. Esto permite obtener una jerarquía de datos, desde el deporte hasta torneos específicos.En este ejemplo:
Puedes obtener datos sobre la lista de partidos. Es importante tener en cuenta que es obligatorio especificar el ID del deporte; no es posible obtener todos los partidos de todos los deportes. También puedes elegir si necesitas partidos en vivo o eventos futuros, y especificar parámetros adicionales para filtrar los datos.
En la respuesta recibirás toda la información necesaria sobre los partidos del deporte que has especificado.
Todos los datos están agrupados en un objeto conveniente que se integra fácilmente en tu sistema y permite mostrar la información en cualquier formato.
Para obtener la lista de partidos, debes enviar una solicitud al método events y especificar los siguientes parámetros:
Estos parámetros son obligatorios para el envío. No olvides también pasar tu clave API en el encabezado de la solicitud (Headers).
Envía esta solicitud para obtener el menú, que incluye todos los datos necesarios para luego obtener partidos y resultados:
Se recomienda enviar solicitudes para la línea cada 20 segundos como mínimo. Para partidos en vivo, el intervalo debe ser de al menos 5 segundos. Este intervalo será suficiente para obtener información actualizada.
GETEsquema : [API-URL-LINE] /v1/ events / [SPORT-ID] / [CHAMPIONSHIP-ID] / [KG] / 50 / [TYPE] / [LANG]
Solicitud: HTTPS://example-domain-demo.com/v1/events/1/0/list/50/live/en
Headers: 'Package': '0145-3455-1298-2978-1100'
La respuesta contiene datos sobre los partidos, incluida la información sobre los equipos, torneos y cuotas. A continuación se describen los campos clave que se devuelven en el objeto de respuesta. Presta atención a la diferencia en los datos que se devuelven según el tipo [KG].
{
"status": 1,
"body": [
{
"sgame_id": "66f8a2d60d8c0bfbf1af3f93",
"stat_id": "66c914530d8c0bfbf15f5682",
"game_id": 562898620,
"game_mid": 562898620,
"game_dop_name": "Extra-Time",
"game_start": 1707807400,
"game_oc_counter": 38,
"country_id": 231,
"country_name": "England",
"tournament_id": 108319,
"tournament_name": "England. FA Cup",
"opp_1_name": "King's Lynn Town",
"opp_2_name": "Worksop Town",
"opp_1_id": 40547,
"opp_2_id": 40549,
"opp_1_icon": "400098.png",
"opp_2_icon": "1201c9f.png",
"sport_name": "Football",
"sport_id": 1,
"score_full": "0:0",
"score_extra": "0:0",
"score_period": "0:0",
"period_name": "3 Half",
"timer": 6511,
"finale": false,
"pitch": null,
"game_oc_list": [
{
"oc_group_name": "Double Chance",
"oc_name": "1X",
"oc_rate": 1.136,
"oc_pointer": "562898620|8|4|0",
"oc_block": false
}
]
}
]
}
{
"status": 1,
"body": [
{
"tournament_id": 8147,
"tournament_name": "Thailand. League Cup",
"events_list": [
{
"sgame_id": 66f8a2d60d8c0bfbf1af3f93,
"stat_id": 3788a2d60d8c0bfbf1af3f93,
"game_id": 562987092,
"game_mid": 562987092,
"game_dop_name": "",
"game_start": 1707856000,
"game_oc_counter": 183,
"country_id": 180,
"country_name": "Thailand",
"tournament_id": 8147,
"tournament_name": "Thailand. League Cup",
"opp_1_name": "ACDC",
"opp_2_name": "Pattaya United",
"opp_1_id": 505873,
"opp_2_id": 4978,
"opp_1_icon": "729aadb95ad1df.png",
"opp_2_icon": "4978.png",
"sport_name": "Football",
"sport_id": 1,
"score_full": "1:1",
"score_extra": "0:0",
"score_period": "1:1;0:0",
"period_name": "2 Half",
"timer": 4451,
"pitch": null,
"finale": false,
"game_oc_list": [
{
"oc_group_name": "1X2",
"oc_name": "W1",
"oc_rate": 8.19,
"oc_pointer": "562987092|1|1|0",
"oc_block": false
},
{
"oc_group_name": "1X2",
"oc_name": "X",
"oc_rate": 1.82,
"oc_pointer": "562987092|1|2|0",
"oc_block": false
}
]
}
]
}
]
}
status Estado de la solicitud. Si es 1, la solicitud se ha completado con éxito.sgame_id Identificador único del partido en el sistema.stat_id Identificador de las estadísticas del partido.game_id Identificador interno del partido.game_mid Identificador del subpartido.game_dop_name Información adicional sobre el partido (por ejemplo, "Tiempo extra").game_start Hora de inicio del partido en formato Unix Timestamp.game_oc_counter Número de mercados de apuestas disponibles para este partido.country_id Identificador del país donde se juega el partido.country_name Nombre del país.tournament_id Identificador del torneo.tournament_name Nombre del torneo.opp_1_name Nombre del primer equipo.opp_2_name Nombre del segundo equipo.opp_1_id Identificador del primer equipo.opp_2_id Identificador del segundo equipo.opp_1_icon Icono del primer equipo.opp_2_icon Icono del segundo equipo.sport_name Nombre del deporte (por ejemplo, "Fútbol").sport_id Identificador del deporte.score_full Resultado final del partido.score_extra Resultado de los sets en tenis.score_period Resultado por período específico.period_name Nombre del período del partido (por ejemplo, "Segunda mitad").timer Temporizador del tiempo actual del partido en segundos.pitch ID del jugador que hace el saque (para deportes donde hay saque).finale Valor lógico que indica si el partido ha finalizado.oc_group_name Nombre del grupo de mercados (por ejemplo, "Doble oportunidad").oc_name Nombre del resultado específico (por ejemplo, "1X").oc_rate Cuota para este resultado.oc_pointer Identificador único del resultado.oc_block Valor lógico que indica si el resultado está bloqueado (si es true, el resultado está bloqueado y no está disponible para apuestas).Método para obtener información detallada sobre un partido específico. Este método permite solicitar información sobre un partido concreto, incluidas las alineaciones de los equipos, los resultados, el estado actual del partido y las apuestas disponibles. Se utiliza para obtener datos actuales sobre un juego en particular.
Se recomienda enviar solicitudes para la línea cada 20 segundos como mínimo. Para partidos en vivo, el intervalo debe ser de al menos 5 segundos. Este intervalo será suficiente para obtener información actualizada.
GETEsquema : [API-URL-LINE] /v1/ event / [GAME-ID] / [KG] / [TYPE] / [LANG]
Solicitud: HTTPS://example-domain-demo.com/v1/event/45566556/sub/live/en
Headers: 'Package': '0145-3455-1298-2978-1100'
La respuesta contiene datos sobre un partido específico, incluida información sobre todas las cuotas y resultados para ese partido. En un partido específico, puedes obtener absolutamente todas las probabilidades y cuotas del partido. A continuación se describen los campos clave que se devuelven en el objeto de respuesta. Presta atención a las diferencias en los datos que se devuelven según el tipo [KG]. Ahora influyen en la agrupación de apuestas y probabilidades.
La respuesta incluye solo aquellos campos que difieren de la solicitud de la lista de partidos. Aquí tienes su descripción:
stat_list Matriz que contiene información de estadísticas en vivo, como córners, ataques, tarjetas, ataques peligrosos y otros indicadores.
sub_games Lista de identificadores con los que puedes obtener mercados de apuestas adicionales. Por ejemplo, puedes solicitar probabilidades y resultados de apuestas solo para la segunda mitad o para los tiros de esquina.
game_oc_list Esta lista puede contener todos los resultados y probabilidades en una sola matriz o estar agrupada por categorías para una integración más conveniente en tu sistema."
{
"status": 1,
"body": {
"game_oc_list": [
{
"group_id": 1,
"group_name": "1X2",
"columns": 3,
"oc_list": [
{
"oc_group_name": "1X2",
"oc_name": "W1",
"oc_rate": 1.245,
"oc_size": 0,
"oc_pointer": "563034215|1|1|0",
"oc_block": false
},
{
"oc_group_name": "1X2",
"oc_name": "X",
"oc_rate": 5.48,
"oc_size": 0,
"oc_pointer": "563034215|1|2|0",
"oc_block": false
},
{
"oc_group_name": "1X2",
"oc_name": "W2",
"oc_rate": 7.97,
"oc_size": 0,
"oc_pointer": "563034215|1|3|0",
"oc_block": false
}
]
},
{
"group_id": 2,
"group_name": "Handicap",
"columns": 2,
"oc_list": [
{
"oc_group_name": "Handicap",
"oc_name": "1 (-1.5)",
"oc_rate": 1.904,
"oc_size": -1.5,
"oc_pointer": "563034215|2|7|-1.5",
"oc_block": false
},
{
"oc_group_name": "Handicap",
"oc_name": "1 (0)",
"oc_rate": 1.06,
"oc_size": 0,
"oc_pointer": "563034215|2|7|0",
"oc_block": false
},
{
"oc_group_name": "Handicap",
"oc_name": "2 (0)",
"oc_rate": 6.02,
"oc_size": 0,
"oc_pointer": "563034215|2|8|0",
"oc_block": false
},
{
"oc_group_name": "Handicap",
"oc_name": "2 (+1.5)",
"oc_rate": 1.76,
"oc_size": 1.5,
"oc_pointer": "563034215|2|8|1.5",
"oc_block": false
}
]
}
],
"stat_list": [
{
"id": 45,
"name": "Attacks",
"opp1": "22",
"opp2": "28"
},
{
"id": 58,
"name": "Dangerous attacks",
"opp1": "13",
"opp2": "25"
},
{
"id": 29,
"name": "Possession %",
"opp1": "45",
"opp2": "55"
},
{
"id": 59,
"name": "Shots on target",
"opp1": "3",
"opp2": "2"
},
{
"id": 60,
"name": "Shots off target",
"opp1": "2",
"opp2": "2"
},
{
"id": 26,
"name": "Yellow cards",
"opp1": "0",
"opp2": "0"
},
{
"id": 70,
"name": "Corner",
"opp1": "0",
"opp2": "3"
},
{
"id": 71,
"name": "Red card",
"opp1": "0",
"opp2": "0"
},
{
"id": 72,
"name": "Penalty",
"opp1": "0",
"opp2": "0"
}
],
"sub_games": [
{
"game_id": 563034216,
"game_num": 48560,
"game_name": "1st half"
},
{
"game_id": 563034217,
"game_num": 48561,
"game_name": "2nd half"
},
{
"game_id": 563034286,
"game_num": 42676,
"game_name": "Result + Total"
}
]
}
}
Envía esta solicitud para obtener los partidos principales. La solicitud devuelve una lista de todos los partidos principales para todos los deportes.
Se recomienda enviar solicitudes para la línea cada 20 segundos como mínimo. Para partidos en vivo, el intervalo debe ser de al menos 5 segundos. Este intervalo será suficiente para obtener información actualizada.
GETEsquema : [API-URL-LINE] /v1/ topmatches / [TYPE] / [LANG]
Solicitud: HTTPS://example-domain-demo.com/v1/topmatches/live/en
Headers: 'Package': '0145-3455-1298-2978-1100'
Si necesitas realizar una búsqueda en el sitio por equipos, puedes usar la solicitud de búsqueda.
Esquema : [API-URL-LINE] /v1/ search / [TYPE] / [LANG] / [COMAND-NAME]
Solicitud: HTTPS://example-domain-demo.com/v1/search/live/en/realmadrid
Headers: 'Package': '0145-3455-1298-2978-1100'
{
"status": 1,
"page": "/v1/events",
"body": [
{
"game_id": 563038643,
"dtype": "live",
"opp1": "Real Madrid (Kimmich_8143)",
"opp2": "Bayern Munich (Mata_8254)",
"champname": "FIFA 24. Cyber League",
"sportname": "Football",
"gamestart": 1707871900
},
{
"game_id": 563043348,
"dtype": "live",
"opp1": "Lille OSC U19",
"opp2": "Real Madrid U19",
"champname": "UEFA Youth League",
"sportname": "Football",
"gamestart": 1707874000
},
{
"game_id": 563046811,
"dtype": "live",
"opp1": "Real Madrid (Mevis)",
"opp2": "Chelsea (Mick)",
"champname": "FIFA 23. Volta daily league",
"sportname": "Football",
"gamestart": 1707874485
},
{
"game_id": 563043227,
"dtype": "live",
"opp1": "Real Madrid",
"opp2": "Bayern",
"champname": "FIFA18. Penalty",
"sportname": "FIFA",
"gamestart": 1707874900
}
]
}
La integración con nuestro API de línea deportiva proporciona acceso a información actual sobre deportes, partidos, torneos y probabilidades. Nos esforzamos por hacer que el proceso de integración sea lo más simple y conveniente posible, proporcionando documentación detallada y ejemplos de solicitudes. Si tienes preguntas o necesitas ayuda, nuestro equipo de soporte técnico siempre estará listo para ayudarte. Aprovecha las posibilidades del API para crear soluciones eficientes para tu negocio.
Ofrecemos otras secciones de documentación para la integración de soluciones deportivas. Consulta la lista de soluciones que puedes conectar a tu sistema ahora mismo:
Consulta los precios de los servicios de línea deportiva para obtener datos a través del API sobre todos los partidos y probabilidades
¿Necesitas resultados de partidos? Haz clic en el título para ir a la sección correspondiente.
Ofrecemos una solución lista que proporciona estados de apuestas calculadas en eventos deportivos.
