Search Events

Searches all upcoming events using a text query. Returns up to 10 results.

GET /events/search

Search Events

cURL

curl --request GET \
  --url https://api.odds-api.io/v3/events/search

200

[
  {
    "away": "<string>",
    "awayId": 123,
    "bookmakerCount": 123,
    "date": "<string>",
    "home": "<string>",
    "homeId": 123,
    "id": 123,
    "league": {
      "name": "<string>",
      "slug": "<string>"
    },
    "scores": {
      "away": 123,
      "home": 123,
      "periods": {}
    },
    "sport": {
      "name": "<string>",
      "slug": "<string>"
    },
    "status": "<string>",
    "clock": {
      "minute": 67,
      "playedSeconds": 4023,
      "period": 2,
      "running": true,
      "statusDetail": "2nd half",
      "injuryTime": 4
    }
  }
]

Query Parameters

apiKey · string · required

API key for authentication

query · string · required

Search term (min 3 characters)

Response

200

application/json

OK

away · string

awayId · integer

bookmakerCount · integer

date · string

home · string

homeId · integer

id · integer

league · object

Show child attributes

scores · object

Show child attributes

sport · object

Show child attributes

status · string

clock · object

Live match clock (live events only; absent when no clock data is available)

Show child attributes