Skip to main content
POST
/
catchAll
/
submit
Create job
curl --request POST \
  --url https://catchall.newscatcherapi.com/catchAll/submit \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "query": "Series B funding rounds for SaaS startups",
  "context": "Focus on funding amount and company name",
  "start_date": "2026-02-18T00:00:00Z",
  "end_date": "2026-02-23T00:00:00Z",
  "limit": 10,
  "mode": "base"
}
'
{
  "job_id": "5f0c9087-85cb-4917-b3c7-e5a5eff73a0c"
}

Authorizations

​
x-api-key
string
header
required

API key for authentication.

Body

application/json
​
query
string
required

Plain text question describing what to find.

The system analyzes your input to generate search queries, validators, and extractors. More specific queries produce more focused results.

Example:

"Series B funding rounds for SaaS startups"

​
context
string

Additional context to focus on specific aspects of your query.

Example:

"Focus on funding amount and company name"

​
limit
integer

Maximum number of records to return. If not specified, defaults to your plan limit.

Use POST /catchAll/continue to extend the limit after job completion without reprocessing.

Required range: x >= 10
Example:

10

​
start_date
string<date-time>

Start date for web search (ISO 8601 format with UTC timezone).

Defines the start of the search window by web page discovery date, not event date. Web pages discovered within this range may describe events from any time period.

Must be within plan's allowed search depth. Default is 5 days before current date if not specified.

Example:

"2026-01-30T00:00:00Z"

​
end_date
string<date-time>

End date for web search (ISO 8601 format with UTC timezone).

Defines the end of the search window by web page discovery date, not event date. Web pages discovered within this range may describe events from any time period.

Must be within plan's allowed search depth and after start_date. Default is current date if not specified.

Example:

"2026-02-05T00:00:00Z"

​
validators
object[]

Custom validators for filtering web page clusters.

If not provided, validators are generated automatically based on the query. The system may also inject validators during the analyzing stage — for example, converting a relative time qualifier into an explicit event-date gate. The returned validators[] in the job status shows the complete applied set, including any system-added ones.

​
enrichments
object[]

Custom enrichment fields for data extraction.

If not provided, enrichments are generated automatically based on the query.

​
mode
enum<string>
default:base

Job processing mode.

  • base: Full pipeline with validation and enrichment.
  • lite: Lightweight extraction with faster processing. Returns titles and citations only.
Available options:
lite,
base
​
connected_dataset_ids
string<uuid>[]

Dataset IDs to connect to the job. When provided, this enables Company Watchlist mode — the job returns only events relevant to companies in the connected datasets. To set the minimum relevance threshold, use ed_score_min.

The dataset must have latest_status: ready before the job is submitted. Submitting with a non-existent or inaccessible dataset ID returns 400.

Example:
["ccabb755-afc2-4047-b84c-78d1f23d49b2"]
​
ed_score_min
integer
default:2

The minimum relevance score a connected entity must reach for its record to be included in results.

Only valid when connected_dataset_ids is set; otherwise ignored. Records where no connected entity meets the threshold are excluded entirely.

Required range: 1 <= x <= 10
Example:

3

​
project_id
string<uuid>

Project to assign this job to. The job appears in the project's resource list immediately after submission.

Example:

"60a85db4-78ec-4b78-876a-bc7d9cdadd04"

​
webhook_ids
string<uuid>[]

IDs of webhooks to notify when the job completes. Maximum 5 per job.

Example:
["a1b2c3d4-e5f6-7890-abcd-ef1234567890"]
​
fetch_all_watchlist_news
boolean
default:false

When true, retrieves all news for connected Company Watchlist entities without topic filtering. Requires connected_dataset_ids to be set.

​
ed_association_type
enum<string>

Filter events by entity association type. event_associated keeps only events where the entity is a direct actor. mention keeps only events where the entity is merely referenced. Only relevant when connected_dataset_ids is set.

Available options:
mention,
event_associated

Response

Job created successfully

​
job_id
string<uuid>
required

Unique identifier for the created job. Use this to check status and retrieve results.

Example:

"5f0c9087-85cb-4917-b3c7-e5a5eff73a0c"