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": "Tech company earnings this quarter",
  "context": "Focus on revenue and profit margins",
  "summary_template": "Company [NAME] earned [REVENUE] in [QUARTER]"
}'
{
  "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 that describes what you want to find. You can ask about any topic: company earnings, policy changes, product launches, M&A activity, and more.

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

Example:

"Tech company earnings this quarter"

​
context
string

Additional context to focus the search and extraction. Use this to narrow results to specific aspects of your query.

The context influences which articles are retrieved and which fields are extracted.

Example:

"Focus on revenue and profit margins"

​
summary_template
string

Template string to guide record summary formatting. Use placeholder syntax like [NAME], [VALUE], [DATE] to indicate desired fields.

When provided, the API adds a template_based_summary field to each record's enrichment object following your template format. This does not guarantee specific field names in the enrichment object.

Example:

"Company [NAME] earned [REVENUE] in [QUARTER]"

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"