Integra probabilidades de fútbol, mercados esenciales y datos prepartido estructurados con Developer gratis o Starter.
Vista previa de datos avanzados, con determinadas variables reservadas a Starter.
Core Analytics completos para integraciones que necesitan más competiciones, historial y volumen.
Compara Developer y Starter en la página de planes API y utiliza después la documentación técnica como referencia de integración.
Ambos planes utilizan estas rutas. Los derechos del contrato y el ámbito de competiciones seleccionado siguen siendo autoritativos en el servidor.
| Método | Ruta |
|---|---|
| GET | /v1/leagues |
| GET | /v1/leagues/{league_code}/matches |
| GET | /v1/matches/{match_id} |
| GET | /v1/matches/today |
| GET | /v1/picks/today |
| POST | /v1/matches/bulk |
GET /v1/health · GET /v1/me · GET /v1/me/usage
Las respuestas pueden incluir availability. Una entrada starter_required indica que una variable pertenece al contrato Starter y no se expone para Developer. Las listas siguen siendo compactas y no inventan campos que solo existen en el detalle analítico. elo_difference aparece únicamente en el payload de detalle correspondiente cuando está realmente disponible.
Developer ofrece 7 días de historial verificado y Starter hasta 90 días. Una petición cubre como máximo 31 días. history_available_from indica la profundidad realmente publicada. Utiliza include=past o include=all y sigue next_cursor sin cambiar los demás parámetros.
Envía la clave únicamente desde el servidor mediante X-API-Key. Developer acepta hasta 5 partidos por solicitud agrupada y Starter hasta 100. Al superar una cuota se devuelve 429 con los metadatos de límite disponibles. No incluyas una clave en JavaScript público.
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.foresportia.com/v1/leagues/FIN/matches?include=all&days=7"2/min · 30/h · 50/day · 5 partidos/solicitud agrupada · 100 rows/day
15/min · 500/h · 3000/day · 100 partidos/solicitud agrupada · 10000 rows/day
El paquete foresportia gestiona autenticación, respuestas tipadas, ETags, errores, paginación por cursor y availability. Las claves beta anteriores siguen siendo compatibles; el SDK nunca deduce el plan a partir del prefijo de la clave.
pip install foresportia400/422 para peticiones inválidas, 401 para una clave ausente o inválida, 403 para derechos o competiciones no disponibles, 404 para un recurso desconocido, 409 para un conflicto de negocio, 429 para cuotas y 5xx para una indisponibilidad temporal.
Para generar una integración, utiliza la documentación técnica y sus versiones de texto para LLM. Esta página es un resumen indexable; los esquemas detallados y ejemplos de payload siguen siendo canónicos en /api/docs/.
Sí. Developer es un plan gratuito activo que se provisiona explícitamente después de iniciar sesión en una Cuenta Foresportia.
No. Comparten rutas y autenticación; los derechos, límites y campos disponibles dependen del plan.
No en Developer ni Starter. Los planes estándar cubren datos prepartido y los resultados históricos verificados disponibles.
Mantén la clave en el servidor, en un backend, script, bot o variable de entorno privada.