curl --request GET \
--url https://catchall.newscatcherapi.com/catchAll/pull/{job_id} \
--header 'x-api-key: <api-key>'import requests
url = "https://catchall.newscatcherapi.com/catchAll/pull/{job_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/pull/{job_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/pull/{job_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/pull/{job_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/pull/{job_id}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://catchall.newscatcherapi.com/catchAll/pull/{job_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{
"job_id": "5f0c9087-85cb-4917-b3c7-e5a5eff73a0c",
"query": "Series B funding rounds for SaaS startups",
"context": "Focus on funding amount and company name",
"validators": [],
"enrichments": [],
"status": "completed",
"error": null,
"duration": "1m",
"candidate_records": 4,
"valid_records": 3,
"progress_validated": 4,
"date_range": {
"start_date": "2026-02-18T00:00:00Z",
"end_date": "2026-02-23T00:00:00Z"
},
"page": 1,
"page_size": 2,
"total_pages": 2,
"limit": 10,
"mode": "base",
"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
}
}
},
"citations": [
{
"title": "VulnCheck raises $25M Series B",
"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"
}
]
}
]
}{
"detail": "X-API-Key header is required for this endpoint"
}{
"detail": "Invalid API key"
}{
"detail": "Invalid API key"
}Get job results
Retrieve the final results for a completed job.
curl --request GET \
--url https://catchall.newscatcherapi.com/catchAll/pull/{job_id} \
--header 'x-api-key: <api-key>'import requests
url = "https://catchall.newscatcherapi.com/catchAll/pull/{job_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/pull/{job_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/pull/{job_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/pull/{job_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/pull/{job_id}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://catchall.newscatcherapi.com/catchAll/pull/{job_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{
"job_id": "5f0c9087-85cb-4917-b3c7-e5a5eff73a0c",
"query": "Series B funding rounds for SaaS startups",
"context": "Focus on funding amount and company name",
"validators": [],
"enrichments": [],
"status": "completed",
"error": null,
"duration": "1m",
"candidate_records": 4,
"valid_records": 3,
"progress_validated": 4,
"date_range": {
"start_date": "2026-02-18T00:00:00Z",
"end_date": "2026-02-23T00:00:00Z"
},
"page": 1,
"page_size": 2,
"total_pages": 2,
"limit": 10,
"mode": "base",
"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
}
}
},
"citations": [
{
"title": "VulnCheck raises $25M Series B",
"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"
}
]
}
]
}{
"detail": "X-API-Key header is required for this endpoint"
}{
"detail": "Invalid API key"
}{
"detail": "Invalid API key"
}Authorizations
API key for authentication.
Path Parameters
Unique job identifier returned from POST /catchAll/submit.
Query Parameters
Page number to retrieve.
x >= 1Number of records per page.
1 <= x <= 1000Response
Results retrieved successfully
Job identifier.
Original plain text query.
"Series B funding rounds for SaaS startups"
Context provided with the query.
"Focus on funding amount and company name"
Validators applied to filter results.
[]
Enrichment fields used for data extraction.
[]
Job status.
"completed"
Error message if the job failed. Null for successful jobs.
Record limit for this job. Reflects the value specified at submit time, or the plan default if no limit was provided.
100
Total time taken to process the job.
"1m"
Total number of distinct event clusters identified. Compare with progress_validated to estimate how many candidates remain unprocessed for job continuation.
4
Number of validated records extracted.
3
Number of candidate clusters that have been validated during processing.
The system process data in batches. This field tracks how many candidate_records have been checked against validation criteria so far.
4
Show child attributes
Show child attributes
The current page number.
x >= 1The number of records per page.
x >= 1The total number of pages available.
x >= 0Processing mode used for this job.
lite, base "base"
Datasets used to narrow retrieval scope, each with id and name.
Show child attributes
Show child attributes
Source groups attached to this job, each with slug, name, and description.
null when the job was not scoped to any source group.
Show child attributes
Show child attributes
True when the query was submitted as an all-news (watchlist-generic) query.
Present when the job was shared with the authenticated user by another organization member. null when the user owns the job.
Show child attributes
Show child attributes
Array of extracted records with structured data and citations.
Show child attributes
Show child attributes
Was this page helpful?

