THthesportsdb
V1 API Search

Search Events

Search for any sports event by it's title with extra filters for season, date or filename.

get/searchevents.php

Request

Query parameters

estring required

Event's title.

sstring

Season of the event.

dstring date

Date of the event.

fstring

Filename of the event.

Response

Successful Response

Example response

{
  "events": [
    {
      "idEvent": "679698",
      "idAPIfootball": "1035454",
      "strEvent": "Arsenal vs Chelsea",
      "strEventAlternate": "Chelsea @ Arsenal",
      "strFilename": "FA Cup 2017-05-27 Arsenal vs Chelsea",
      "strSport": "Soccer",
      "idLeague": "4482",
      "strLeague": "FA Cup",
      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/vk7isd1598802862.png",
      "strSeason": "2016-2017",
      "strDescriptionEN": "",
      "strHomeTeam": "Arsenal",
      "strAwayTeam": "Chelsea",
      "intHomeScore": "2",
      "intRound": "200",
      "intAwayScore": "1",
      "intSpectators": "89472",
      "strOfficial": "",
      "strTimestamp": "2024-04-23T19:00:00",
      "dateEvent": "2017-05-27",
      "dateEventLocal": "2017-05-27",
      "strTime": "17:30:00",
      "strTimeLocal": "",
      "strGroup": "",
      "idHomeTeam": "133604",
      "strHomeTeamBadge": null,
      "idAwayTeam": "133610",
      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/yvwvtu1448813215.png",
      "intScore": null,
      "intScoreVotes": null,
      "strResult": "",
      "idVenue": null,
      "strVenue": null,
      "strCountry": null,
      "strCity": null,
      "strPoster": null,
      "strSquare": null,
      "strFanart": null,
      "strThumb": null,
      "strBanner": null,
      "strMap": null,
      "strTweet1": "",
      "strTweet2": "",
      "strTweet3": "",
      "strVideo": "https://www.youtube.com/watch?v=OOkzIJ2Ge2M",
      "strStatus": null,
      "strPostponed": "no",
      "strLocked": "unlocked"
    }
  ]
}

Changes

No recorded changes to this operation across all 2 revisions of this API.