Telem API
Search the web, read pages, and watch a query for new results.
Base URLhttps://router.telem.ai
Search (POST /v1/search) sends one query, or a batch of them, to several providers at the same time. You get one result list per provider, in the same format for every provider.
Fetch (POST /v1/fetch) reads whole pages by URL, several per call.
Monitors (/v1/monitors) run one query on a schedule, with an agent that keeps what matches. See Monitors.
The monitor agent (/v1/monitors/{monitor_id}/agent) checks what a monitor finds against its query. Read what it found, follow its changes, and chat with it.
Every request needs an API key: see Authentication. Each request option and its limits are on Parameters & Configuration.
Search and fetch
- POSTSearch
/v1/searchSearch the web with one or more providers. - POSTFetch
/v1/fetchRead whole pages by URL.
Monitors
- POSTCreate a monitor
/v1/monitorsWatch the web for new results on a query. - GETList monitors
/v1/monitorsYour monitors, newest first. - GETGet a monitor
/v1/monitors/{monitor_id}One monitor, by its ID. - PATCHUpdate a monitor
/v1/monitors/{monitor_id}Pause, resume or change a monitor. - DELETEDelete a monitor
/v1/monitors/{monitor_id}End a monitor so that it stops running. - POSTPoll a monitor
/v1/monitors/{monitor_id}/pollThe results that are new since your last poll.
Monitor agent
- GETGet the agent
/v1/monitors/{monitor_id}/agentA monitor's agent: its status, plan, runs, spend and sources. - PATCHUpdate the agent
/v1/monitors/{monitor_id}/agentPause or resume the agent, or change its budget. - POSTRun the agent now
/v1/monitors/{monitor_id}/agent/ticksStart a tick now, outside the schedule. - GETList jobs
/v1/monitors/{monitor_id}/agent/jobsThe agent's jobs, newest first. - GETGet a job
/v1/monitors/{monitor_id}/agent/jobs/{job_id}One of the agent's jobs, with its steps and result.
Agent results
- GETList changes
/v1/monitors/{monitor_id}/agent/changesWhat changed, oldest first, from a cursor. Store the cursor to read on later. - GETList events
/v1/monitors/{monitor_id}/agent/eventsWhat changed, newest first. - GETList objects
/v1/monitors/{monitor_id}/agent/objectsWhat the agent found at its latest tick. - GETGet an object
/v1/monitors/{monitor_id}/agent/objects/{identity_key}One object, with its values, verdicts, history and pages.
Agent panels and chat
- GETList panels
/v1/monitors/{monitor_id}/agent/panelsThe monitor's panels, in order. - PATCHUpdate a panel
/v1/monitors/{monitor_id}/agent/panels/{panel_id}Rename a panel or move it. - DELETEDelete a panel
/v1/monitors/{monitor_id}/agent/panels/{panel_id}Delete one of the monitor's panels. - POSTSend a chat message
/v1/monitors/{monitor_id}/agent/chatAsk the agent a question, or ask it to change something. - GETList chat messages
/v1/monitors/{monitor_id}/agent/chatThe latest chat messages and the agent's answers. - DELETERemove a source a chat added
/v1/monitors/{monitor_id}/agent/steps/{name}Take out a source that a chat message added to the plan.
The Python SDK and the JavaScript SDK call the same API. What each error means: Errors.