Skip to main content
GET
/
catchAll
/
monitors
/
pull
/
{monitor_id}
Get monitor results
curl --request GET \
  --url https://catchall.newscatcherapi.com/catchAll/monitors/pull/{monitor_id} \
  --header 'x-api-key: <api-key>'
{
  "monitor_id": "7f3a8b2c-1e4d-4a5b-9c8d-6e7f8a9b0c1d",
  "cron_expression": "0 12 * * *",
  "timezone": "UTC",
  "reference_job": {
    "query": "Tech company earnings this quarter",
    "context": "Focus on revenue and profit margins"
  },
  "date_range": {
    "start_date": "2025-10-23T00:00:00Z",
    "end_date": "2025-11-07T23:59:59Z"
  },
  "records": 487,
  "status": "active",
  "last_run_date": "2025-11-07T12:00:00Z",
  "all_records": [
    {
      "record_id": "5262823697790152939",
      "record_title": "Oracle Q1 2026 Earnings Exceed Expectations",
      "enrichment": {
        "record_title": "Oracle Q1 2026 Earnings Exceed Expectations",
        "company_name": "Oracle",
        "quarter_identifier": "Q1 2026",
        "revenue": "$14.9 billion",
        "revenue_change": "up 12%",
        "profit_margin": "42% non-GAAP operating margin"
      },
      "citations": [
        {
          "title": "Oracle Reports Strong Q1 2026 Results",
          "link": "https://example.com/article",
          "published_date": "2025-09-26 08:54:20"
        }
      ]
    }
  ]
}

Authorizations

​
x-api-key
string
header
required

API key for authentication.

Path Parameters

​
monitor_id
string<uuid>
required

Monitor identifier.

Response

Monitor results retrieved successfully.

​
monitor_id
string<uuid>
required

Unique identifier for the monitor.

Example:

"7f3a8b2c-1e4d-4a5b-9c8d-6e7f8a9b0c1d"

​
reference_job
object
required

Configuration from the job used as template for this monitor.

​
status
string
required

Current monitor status or error message if monitor creation failed.

Example:

"active"

​
cron_expression
string

Parsed cron expression from the natural language schedule. Standard cron format (minute hour day month day-of-week).

Example:

"0 12 * * *"

​
timezone
string

Timezone used for schedule execution.

Example:

"UTC"

​
date_range
object

Time range covered by all monitor job results.

​
records
integer
default:0

Total number of records collected across all monitor jobs.

Example:

487

​
last_run_date
string<date-time>

Timestamp of the most recent scheduled job execution. Null if no jobs have been executed yet.

Example:

"2025-11-07T12:00:00Z"

​
all_records
object[]

Aggregated records from all jobs executed by this monitor. Each record includes structured data extracted from web sources with citations.