query_events
Query sports events with natural language phrases such as 'live nfl games today' or 'college basketball this week'. No need for structured filters; the tool recognizes sport, status, and date mentions.
Instructions
Search events with a natural-language query instead of structured filters — e.g. 'live nfl games today' or 'college basketball this week'. Rule-based (not an LLM): recognizes sport (nfl/nba/mlb/nhl/tennis/soccer/ncaaf/ncaab + aliases like hockey, american football, college basketball), status (live/final/upcoming/…), dates (today/tomorrow, this week, next N days, YYYY-MM-DD ranges). Bare 'football' is ambiguous and left unrecognized. Response includes interpreted filters, equivalent REST call, and unrecognized_terms. Prefer list_events when you already know the structured filters you want.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Overrides any limit parsed from the query text. Max 100. | |
| query | Yes | Free text, e.g. 'live nfl games today'. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | The original natural-language query text. | |
| total | No | ||
| events | No | ||
| interpreted | No | The list_events-equivalent filters parsed from the query text (sport, status, date, from, to, limit). | |
| next_after_id | No | ||
| equivalent_request | No | The literal GET /v1/events request this query was translated to. | |
| unrecognized_terms | No | Query words that didn't map to a known filter. |