Monitors

Just want working code?

Stop reading. Skip to the Monitors coding agent reference and copy paste to your agent.

What Are Monitors?

Monitors run Exa searches on a cron schedule and deliver results to a webhook endpoint. Each run finds and synthesizes results, with automatic deduplication so you only see new content across runs. Use them to track competitor announcements, new funding rounds, regulatory changes, research publications, or any topic you want to follow over time.

Key Capabilities

Feature	What It Does
Scheduled search	Runs your query on a cron schedule using Exa search
Automatic deduplication	Date filtering and semantic dedup ensure each run surfaces only new content
Structured output	Use `outputSchema` to get results as plain text summaries or structured JSON objects
Contents options	Request text, highlights, or summaries alongside search results
Webhook delivery	Get notified in real time when runs complete
Manual trigger	Run on demand without waiting for the next scheduled time

Common Use Cases

Track funding announcements

Get notified when new companies raise funding in a specific sector.

Python
JavaScript

monitor = exa.monitors.create(params={
    "name": "Series A Tracker",
    "search": {
        "query": "AI startups that raised Series A funding",
        "numResults": 10
    },
    "trigger": {
        "type": "cron",
        "expression": "0 9 * * 1",
        "timezone": "America/New_York"
    },
    "webhook": {
        "url": "https://example.com/webhook"
    }
})

const monitor = await exa.monitors.create({
  name: "Series A Tracker",
  search: {
    query: "AI startups that raised Series A funding",
    numResults: 10
  },
  trigger: {
    type: "cron",
    expression: "0 9 * * 1",
    timezone: "America/New_York"
  },
  webhook: {
    url: "https://example.com/webhook"
  }
});

Monitor competitor news with structured output

Extract structured data from competitor coverage using an output schema.

Python
JavaScript

monitor = exa.monitors.create(params={
    "name": "Competitor News",
    "search": {
        "query": "Acme Corp product launches and partnerships",
        "numResults": 5
    },
    "outputSchema": {
        "type": "object",
        "properties": {
            "headline": {"type": "string"},
            "category": {
                "type": "string",
                "enum": ["product_launch", "partnership", "hiring", "other"]
            },
            "summary": {"type": "string"}
        },
        "required": ["headline", "category", "summary"]
    },
    "trigger": {
        "type": "cron",
        "expression": "0 8 * * *",
        "timezone": "Etc/UTC"
    },
    "webhook": {
        "url": "https://example.com/webhook"
    }
})

const monitor = await exa.monitors.create({
  name: "Competitor News",
  search: {
    query: "Acme Corp product launches and partnerships",
    numResults: 5
  },
  outputSchema: {
    type: "object",
    properties: {
      headline: { type: "string" },
      category: {
        type: "string",
        enum: ["product_launch", "partnership", "hiring", "other"]
      },
      summary: { type: "string" }
    },
    required: ["headline", "category", "summary"]
  },
  trigger: {
    type: "cron",
    expression: "0 8 * * *",
    timezone: "Etc/UTC"
  },
  webhook: {
    url: "https://example.com/webhook"
  }
});

Track research papers with highlights

Follow new publications in a field, with token-efficient highlights included.

Python
JavaScript

monitor = exa.monitors.create(params={
    "name": "LLM Research Tracker",
    "search": {
        "query": "new large language model training techniques and architectures",
        "numResults": 10,
        "contents": {
            "highlights": {
                "maxCharacters": 4000
            }
        }
    },
    "trigger": {
        "type": "cron",
        "expression": "0 12 * * 1,4",
        "timezone": "Etc/UTC"
    },
    "webhook": {
        "url": "https://example.com/webhook"
    }
})

const monitor = await exa.monitors.create({
  name: "LLM Research Tracker",
  search: {
    query: "new large language model training techniques and architectures",
    numResults: 10,
    contents: {
      highlights: {
        maxCharacters: 4000
      }
    }
  },
  trigger: {
    type: "cron",
    expression: "0 12 * * 1,4",
    timezone: "Etc/UTC"
  },
  webhook: {
    url: "https://example.com/webhook"
  }
});

Human Quickstart

Get your API key from the Exa Dashboard.

Python
JavaScript
cURL

pip install exa-py

from exa_py import Exa
import os

exa = Exa(os.getenv("EXA_API_KEY"))

# Create a monitor
monitor = exa.monitors.create(params={
    "name": "AI Funding Tracker",
    "search": {
        "query": "AI startups that raised Series A funding",
        "numResults": 10
    },
    "webhook": {
        "url": "https://example.com/webhook"
    }
})

print(f"Monitor ID: {monitor.id}")

# Store the webhook secret securely — only returned on creation
print(f"Webhook secret: {monitor.webhook_secret}")

# Trigger a run manually
exa.monitors.trigger(monitor.id)

# Poll for results
import time
while True:
    runs = exa.monitors.runs.list(monitor.id)
    latest = runs.data[0]
    if latest.status in ("completed", "failed"):
        break
    time.sleep(2)

# Print results
if latest.status == "completed" and latest.output:
    run = exa.monitors.runs.get(monitor.id, latest.id)
    for result in run.output.results:
        print(f"- {result['title']}: {result['url']}")

npm install exa-js

import Exa from "exa-js";

const exa = new Exa(process.env.EXA_API_KEY);

// Create a monitor
const monitor = await exa.monitors.create({
  name: "AI Funding Tracker",
  search: {
    query: "AI startups that raised Series A funding",
    numResults: 10
  },
  webhook: {
    url: "https://example.com/webhook"
  }
});

console.log(`Monitor ID: ${monitor.id}`);

// Store the webhook secret securely — only returned on creation
console.log(`Webhook secret: ${monitor.webhookSecret}`);

// Trigger a run manually
await exa.monitors.trigger(monitor.id);

// Poll for results
let latest;
while (true) {
  const runs = await exa.monitors.runs.list(monitor.id);
  latest = runs.data[0];
  if (latest.status === "completed" || latest.status === "failed") break;
  await new Promise(r => setTimeout(r, 2000));
}

// Print results
if (latest.status === "completed" && latest.output) {
  const run = await exa.monitors.runs.get(monitor.id, latest.id);
  for (const result of run.output.results) {
    console.log(`- ${result.title}: ${result.url}`);
  }
}

# Create a monitor
curl -X POST "https://api.exa.ai/monitors" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $EXA_API_KEY" \
  -d '{
    "name": "AI Funding Tracker",
    "search": {
      "query": "AI startups that raised Series A funding",
      "numResults": 10
    },
    "webhook": {
      "url": "https://example.com/webhook"
    }
  }'

# Trigger a run
curl -X POST "https://api.exa.ai/monitors/{MONITOR_ID}/trigger" \
  -H "x-api-key: $EXA_API_KEY"

# List runs
curl "https://api.exa.ai/monitors/{MONITOR_ID}/runs" \
  -H "x-api-key: $EXA_API_KEY"

# Get a specific run
curl "https://api.exa.ai/monitors/{MONITOR_ID}/runs/{RUN_ID}" \
  -H "x-api-key: $EXA_API_KEY"

Monitors coding agent reference — Full parameter reference for coding agents
Monitors API Reference — Interactive API reference with request/response schemas
Search API — Learn about Exa’s search capabilities
Search Best Practices — Tips for writing effective queries

API

MCP

SDKs

Integrations

Admin

Additional Resources

What Are Monitors?

Key Capabilities

Common Use Cases

Human Quickstart

Next

API

MCP

SDKs

Integrations

Admin

Additional Resources

​What Are Monitors?

​Key Capabilities

​Common Use Cases

​Human Quickstart

​Next

What Are Monitors?

Key Capabilities

Common Use Cases

Human Quickstart

Next