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",
  "reference_job": {
    "query": "AI company acquisitions",
    "context": "Focus on deal size and acquiring company details"
  },
  "status": "Done",
  "cron_expression": "0 12 * * *",
  "timezone": "UTC",
  "run_info": {
    "first_run": "2025-10-23T12:00:00Z",
    "last_run": "2025-11-07T12:00:00Z"
  },
  "records": 487,
  "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": [
        {
          "id": "8760624448e9815f9fb4abd114c75e76",
          "title": "Oracle Reports Strong Q1 2026 Results",
          "link": "https://example.com/article",
          "published_date": "2025-09-26T08:54:20Z",
          "job_id": "6269aa54-c332-4fff-8a65-0d4e82a365e8",
          "added_on": "2025-11-14T21:00:00Z"
        }
      ],
      "added_on": "2025-11-14T21:00:00Z",
      "updated_on": "2025-11-14T21:00:00Z"
    }
  ]
}

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
​
status
string
required

Current monitor status or error message if monitor creation failed.

Example:

"Done"

​
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"

​
run_info
object

Execution time range for this monitor.

​
records
integer
default:0

Total number of records collected across all monitor jobs.

Example:

487

​
all_records
object[]

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