curl --request GET \
--url https://catchall.newscatcherapi.com/catchAll/monitors/pull/{monitor_id} \
--header 'x-api-key: <api-key>'import requests
url = "https://catchall.newscatcherapi.com/catchAll/monitors/pull/{monitor_id}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://catchall.newscatcherapi.com/catchAll/monitors/pull/{monitor_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://catchall.newscatcherapi.com/catchAll/monitors/pull/{monitor_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://catchall.newscatcherapi.com/catchAll/monitors/pull/{monitor_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://catchall.newscatcherapi.com/catchAll/monitors/pull/{monitor_id}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://catchall.newscatcherapi.com/catchAll/monitors/pull/{monitor_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"monitor_id": "7f3a8b2c-1e4d-4a5b-9c8d-6e7f8a9b0c1d",
"reference_job": {
"query": "Series B funding rounds for SaaS startups",
"context": "Focus on funding amount and company name"
},
"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": "6983973854314692457",
"record_title": "VulnCheck Raises $25M Series B Funding",
"enrichment": {
"enrichment_confidence": "high",
"funding_amount": 25000000,
"funding_currency": "USD",
"funding_date": "2026-02-17",
"investee_company": {
"source_text": "VulnCheck",
"confidence": 0.99,
"metadata": {
"name": "VulnCheck",
"domain_url": "vulncheck.com",
"domain_url_confidence": "high"
}
},
"investor_company": {
"source_text": "Sorenson Capital",
"confidence": 0.99,
"metadata": {
"name": "Sorenson Capital",
"domain_url": null,
"domain_url_confidence": null
}
},
"valuation": 25000000,
"other_investors": "National Grid Partners, Ten Eleven Ventures, In-Q-Tel"
},
"citations": [
{
"title": "Exclusive: VulnCheck raises $25M funding to help companies patch software bugs",
"link": "https://www.msn.com/en-us/money/other/exclusive-vulncheck-raises-25m-funding-to-help-companies-patch-software-bugs/ar-AA1WwdjW",
"published_date": "2026-02-17T14:01:05Z",
"id": "8760624448e9815f9fb4abd114c75e76",
"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"
}
],
"limit": 100,
"connected_datasets": [
{
"id": "9f3a8b2c-1e4d-4a5b-9c8d-6e7f8a9b0c1d",
"name": "My Portfolio",
"is_deleted": false
}
],
"is_all_news_query": true
}{
"detail": "Invalid API key"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Get monitor results
Retrieve aggregated results from all jobs executed by a monitor.
curl --request GET \
--url https://catchall.newscatcherapi.com/catchAll/monitors/pull/{monitor_id} \
--header 'x-api-key: <api-key>'import requests
url = "https://catchall.newscatcherapi.com/catchAll/monitors/pull/{monitor_id}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://catchall.newscatcherapi.com/catchAll/monitors/pull/{monitor_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://catchall.newscatcherapi.com/catchAll/monitors/pull/{monitor_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://catchall.newscatcherapi.com/catchAll/monitors/pull/{monitor_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://catchall.newscatcherapi.com/catchAll/monitors/pull/{monitor_id}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://catchall.newscatcherapi.com/catchAll/monitors/pull/{monitor_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"monitor_id": "7f3a8b2c-1e4d-4a5b-9c8d-6e7f8a9b0c1d",
"reference_job": {
"query": "Series B funding rounds for SaaS startups",
"context": "Focus on funding amount and company name"
},
"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": "6983973854314692457",
"record_title": "VulnCheck Raises $25M Series B Funding",
"enrichment": {
"enrichment_confidence": "high",
"funding_amount": 25000000,
"funding_currency": "USD",
"funding_date": "2026-02-17",
"investee_company": {
"source_text": "VulnCheck",
"confidence": 0.99,
"metadata": {
"name": "VulnCheck",
"domain_url": "vulncheck.com",
"domain_url_confidence": "high"
}
},
"investor_company": {
"source_text": "Sorenson Capital",
"confidence": 0.99,
"metadata": {
"name": "Sorenson Capital",
"domain_url": null,
"domain_url_confidence": null
}
},
"valuation": 25000000,
"other_investors": "National Grid Partners, Ten Eleven Ventures, In-Q-Tel"
},
"citations": [
{
"title": "Exclusive: VulnCheck raises $25M funding to help companies patch software bugs",
"link": "https://www.msn.com/en-us/money/other/exclusive-vulncheck-raises-25m-funding-to-help-companies-patch-software-bugs/ar-AA1WwdjW",
"published_date": "2026-02-17T14:01:05Z",
"id": "8760624448e9815f9fb4abd114c75e76",
"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"
}
],
"limit": 100,
"connected_datasets": [
{
"id": "9f3a8b2c-1e4d-4a5b-9c8d-6e7f8a9b0c1d",
"name": "My Portfolio",
"is_deleted": false
}
],
"is_all_news_query": true
}{
"detail": "Invalid API key"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Authorizations
API key for authentication.
Path Parameters
Monitor identifier.
Response
Monitor results retrieved successfully
Unique identifier for the monitor.
"7f3a8b2c-1e4d-4a5b-9c8d-6e7f8a9b0c1d"
Show child attributes
Show child attributes
Current monitor status or error message if monitor creation failed.
"Done"
The cron expression for a monitor schedule parsed from the text schedule you provide.
Standard cron format (minute hour day month day-of-week).
"0 12 * * *"
Timezone used for schedule execution.
"UTC"
Execution time range for this monitor.
Show child attributes
Show child attributes
Total number of records collected across all monitor jobs.
487
Aggregated records from all jobs executed by this monitor. Each record includes structured data extracted from web sources with citations.
Show child attributes
Show child attributes
Record limit applied to this monitor's jobs.
100
Datasets used to narrow retrieval scope, each with id and name.
Show child attributes
Show child attributes
True when the reference job was submitted as an all-news (watchlist-generic) query.
Was this page helpful?

