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": "AI company acquisitions in fintech last week"
}
'
{
  "validators": [
    {
      "name": "is_acquisition_event",
      "description": "true if article describes a merger or acquisition event",
      "type": "boolean"
    },
    {
      "name": "involves_fintech",
      "description": "true if the companies involved are in the fintech sector",
      "type": "boolean"
    }
  ],
  "enrichments": [
    {
      "name": "acquiring_company",
      "description": "Extract the acquiring company name",
      "type": "company"
    },
    {
      "name": "acquired_company",
      "description": "Extract the acquired company name",
      "type": "text"
    },
    {
      "name": "deal_value",
      "description": "Extract the deal value if mentioned",
      "type": "number"
    },
    {
      "name": "announcement_date",
      "description": "Extract the announcement date",
      "type": "date"
    }
  ],
  "start_date": "2026-01-29T00:00:00Z",
  "end_date": "2026-02-05T00:00:00Z",
  "date_modification_message": []
}

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

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"

​
context
string

Additional context to focus on specific aspects of your query.

Example:

"Focus on deal size and acquiring company details"

Response

Suggestions retrieved successfully

Suggestions for validators, enrichments, and date ranges based on query analysis.

Date ranges are validated against plan limits and adjusted if necessary.

​
validators
object[]
required

Suggested validators for filtering relevant articles.

​
enrichments
object[]
required

Suggested enrichment fields for data extraction.

​
start_date
string<date-time>
required

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>
required

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"

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