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": "AI company acquisitions",
  "context": "Focus on deal size and acquiring company details",
  "start_date": "2026-01-30T00:00:00Z",
  "end_date": "2026-02-05T00:00:00Z",
  "limit": 10
}
'
{
  "job_id": "af7a26d6-cf0b-458c-a6ed-4b6318c74da3"
}

Authorizations

​
x-api-key
string
header
required

API key for authentication.

Body

application/json
​
query
string
required

Natural language 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:

"AI company acquisitions"

​
schema
string

Template string to guide record summary formatting. Use placeholder syntax with brackets to indicate desired fields: [COMPANY], [REVENUE], [TARGET], [AMOUNT], etc.

When provided, the system generates a schema_based_summary field for each record following this template.

Example:

"[ACQUIRER] acquired [TARGET] for [AMOUNT]"

​
context
string

Additional context to focus on specific aspects of your query.

Example:

"Focus on deal size and acquiring company details"

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

Example:

10

​
start_date
string<date-time>

Start of date range for article search (ISO 8601 format with UTC timezone).

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

Example:

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

​
end_date
string<date-time>

End of date range for article search (ISO 8601 format with UTC timezone).

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

Example:

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

​
validators
object[]

Custom validators for filtering article clusters.

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

​
enrichments
object[]

Custom enrichment fields for data extraction.

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

Response

Job created successfully

​
job_id
string<uuid>
required

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

Example:

"af7a26d6-cf0b-458c-a6ed-4b6318c74da3"