List Monitors

Lists all monitors for the authenticated team. Supports filtering by status and cursor-based pagination.

GET /monitors

List Monitors

cURL

curl --request GET \
  --url https://api.exa.ai/monitors \
  --header 'x-api-key: <api-key>'

200

{
  "data": [
    {
      "id": "<string>",
      "name": "<string>",
      "search": {
        "query": "Latest developments in LLM capabilities",
        "numResults": 10,
        "contents": {
          "text": false,
          "highlights": false,
          "summary": true,
          "extras": {
            "links": 1,
            "imageLinks": 1,
            "richImageLinks": 0,
            "richLinks": 0,
            "codeBlocks": 0
          },
          "context": true,
          "livecrawlTimeout": 1000,
          "maxAgeHours": 24,
          "filterEmptyResults": true,
          "subpages": 1,
          "subpageTarget": "sources"
        }
      },
      "trigger": {
        "type": "interval",
        "period": "6h"
      },
      "outputSchema": {
        "type": "<string>",
        "description": "<string>"
      },
      "metadata": {
        "slack_channel_id": "C123ABC",
        "slack_thread_id": "1745444400.123456",
        "user_id": "U123ABC"
      },
      "webhook": {
        "url": "<string>",
        "events": []
      },
      "nextRunAt": "2023-11-07T05:31:56Z",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>"
}

Authorizations

apiKeybearer

x-api-key · string · header · required

Pass your Exa API key in the x-api-key header. You can also authenticate with Authorization: Bearer .

Query Parameters

status · enum<string>

Filter monitors by status

Available options: active, paused, disabled

cursor · string

Pagination cursor from a previous response

limit · integer · default: 50

Number of results per page

Required range: 1 <= x <= 100

name · string

Filter monitors by name (case-insensitive substring match)

Maximum string length: 250

metadata · object

Filter monitors by metadata key-value pairs (exact match, AND semantics). Use bracket notation: metadata[key]=value.

Show child attributes

Response

200 - application/json

A paginated list of monitors

data · object[] · required

The list of monitors

Show child attributes

hasMore · boolean · required

Whether there are more results

nextCursor · string | null

Cursor for the next page