Getting Started
Learn how to authenticate and make your first API request
Introduction
Over15AI provides a comprehensive REST API for football intelligence, delivering real-time betting odds, match predictions, live scores, fixtures, news, and statistics for 200+ leagues worldwide.
Base URL
https://api.over15ai.com/v1All API requests must be made over HTTPS. Requests made over plain HTTP will fail.
Authentication
All requests require an API key
curl https://api.over15ai.com/v1/odds/760486 \
-H "Authorization: Bearer YOUR_API_KEY"Getting Your API Key
- Visit /developers/api-keys
- Sign in with Google
- Generate your API key
- Copy and securely store your key
⚠️ Security Warning
Never share your API key publicly or commit it to version control.
API Key Tiers
Choose the plan that fits your needs
| Tier | Price | Requests | Rate Limit |
|---|---|---|---|
Free | $0 | 100/day | 10/min |
Starter | $19/mo | 10,000/mo | 100/min |
Pro | $39/mo | 100,000/mo | 1,000/min |
Business | $79/mo | 500,000/mo | 5,000/min |
Making Your First Request
Get match odds in seconds
Request
curl https://api.over15ai.com/v1/odds/760486 \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"data": {
"match": {
"id": "760486",
"homeTeam": "Netherlands",
"awayTeam": "Romania",
"league": "FIFA World Cup",
"startTime": "2026-07-02T19:00:00Z"
},
"markets": {
"matchResult": {
"home": { "odds": 1.50 },
"draw": { "odds": 4.20 },
"away": { "odds": 6.50 }
},
"overUnder": {
"over25": { "odds": 1.73 },
"under25": { "odds": 2.10 }
}
}
}
}HTTP Status Codes
| Code | Meaning | Description |
|---|---|---|
| 200 | OK | Request successful |
| 400 | Bad Request | Invalid parameters |
| 401 | Unauthorized | Invalid API key |
| 404 | Not Found | Resource not found |
| 429 | Too Many Requests | Rate limit exceeded |