events

Search For Events

Search for events using the hybrid discovery agent (DB + Web). Returns a STREAM of NDJSON (Newline Delimited JSON) events.

Event Types:

  • {"type": "status", "msg": "...", "step": "..."}

  • {"type": "result", "data": [...events...]}

  • {"type": "error", "msg": "..."}

  • force_refresh: If True, bypasses local cache and triggers a fresh web scrape.

post/events/search

Request

  • Base URL
    https://api.imperfect.co (the document declares no server; this is the origin it was published from)
  • URL
    https://api.imperfect.co/events/search
  • Auth
    HTTP bearer

Query parameters

user_idstring nullable

Request body

querystring required
force_refreshboolean

Response

Successful Response

unknown required

Changes

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