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/v1

All 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

Next Steps

Odds API →

Real-time betting odds

Fixtures API →

Match schedules and results

Predictions API →

AI-powered predictions

Live Scores API →

Real-time match updates