Skip to main content
POST
/
catchAll
/
initialize
Initialize job
curl --request POST \
  --url https://catchall.newscatcherapi.com/catchAll/initialize \
  --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"
}
'
{
  "query": "Series B funding rounds for SaaS startups",
  "context": "Focus on funding amount and company name",
  "validators": [
    {
      "name": "is_series_b_funding",
      "description": "true if the web page describes a Series B funding round",
      "type": "boolean"
    },
    {
      "name": "is_saas_startup",
      "description": "true if the company receiving funding is a SaaS startup",
      "type": "boolean"
    }
  ],
  "enrichments": [
    {
      "name": "funding_amount",
      "description": "Extract the amount of funding received in the Series B round",
      "type": "number"
    },
    {
      "name": "investee_company",
      "description": "Extract the name of the SaaS startup receiving the funding",
      "type": "company"
    },
    {
      "name": "investor_company",
      "description": "Extract the name of the lead investor",
      "type": "company"
    },
    {
      "name": "funding_date",
      "description": "Extract the date when the funding round was announced",
      "type": "date"
    }
  ],
  "start_date": "2026-02-19T00:00:00Z",
  "end_date": "2026-02-24T00:00:00Z",
  "date_modification_message": [
    "No dates were provided; using a default window of 5 days."
  ]
}

Authorizations

x-api-key
string
header
required

API key for authentication.

Body

application/json

Request to get validator, enrichment, and date range suggestions for a query.

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"

connected_dataset_ids
string<uuid>[]

Optional list of watchlist dataset IDs connected to this job.

fetch_all_watchlist_news
boolean
default:false

When true, returns generic news validators and enrichments suitable for watchlist-based article collection instead of query-specific fields.

Response

Suggestions retrieved successfully

query
string
required

Echo of the query from the request.

Example:

"Series B funding rounds for SaaS startups"

validators
object[]
required

Suggested validators for filtering relevant web pages. When the job is submitted, the system may inject additional validators during the analyzing stage — check the returned validators[] in the job status to see the complete applied set.

enrichments
object[]
required

Suggested enrichment fields for data extraction.

context
string | null

Echo of the context from the request. Null if not provided.

Example:

"Focus on funding amount and company name"

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"

date_modification_message
string[]

Messages explaining date adjustments due to plan limits.

Empty array if no modifications were needed. Contains human-readable messages when requested dates exceed plan's allowed lookback period.

Example:
[
"start_date must be >= 2025-01-23, your plan limited to lookback 365 days; we modified start_date to 2025-01-23."
]