events

Natural-language event search

Map a natural-language query to the same filters GET /v1/events accepts, then run that exact list query — results are identical to, and as fresh as, calling /v1/events directly. This is a small rule-based mapper, not an LLM call — see the module-level _parse_nl_query docstring for exactly what it recognizes.

Body: {"query": "live nfl games today", "limit": 25} An explicit top-level "limit" overrides one parsed from the text. Costs 1 credit, same as GET /v1/events — interpreting the query text is free.

post/v1/query

Request

  • Base URL: https://lumify.ai
  • URL: https://lumify.ai/v1/query
  • Auth: HTTP bearer

Request body

querystring required

Free text, e.g. 'live nfl games today' or 'college basketball this week'.

limitinteger nullable

Overrides any limit parsed from the query text. Max 100.

Response

Events matching the parsed query, the interpreted filters, and their REST equivalent

querystring required

The original natural-language query text.

unrecognized_termsstring[]

Query words that didn't map to a known filter.

equivalent_requeststring required

The literal GET /v1/events request this query was translated to.

totalinteger
next_after_idinteger nullable

Changes

No recorded changes to this operation across all 1 revision of this API.