CatchAll Create Job — submit a job without polling

CatchAll Create Job submits a search query to the CatchAll API and returns a job_id immediately. Unlike the main CatchAll Actor, it does not wait for the job to complete or fetch results. This gives you full control over the job lifecycle in custom workflows.

This Actor maps to the POST /catchAll/submit endpoint.

When to use this Actor

• Build custom pipelines. Submit a job, then chain CatchAll Get Job Status and CatchAll Pull Results using Apify integrations.
• Submit multiple jobs in parallel. Start several jobs at once and poll their statuses independently.
• Add logic between steps. Insert custom processing, notifications, or conditional checks between job submission and result retrieval.

Input

Field	Type	Required	Description
apiKey	String	Yes	Your CatchAll API key
query	String	Yes	Plain-text question describing what to find
context	String	No	Extra instructions for extraction
limit	Integer	No	Maximum records to process
start_date	String	No	Start date/time for the search window (ISO 8601 format)
end_date	String	No	End date/time for the search window (ISO 8601 format)
validators	String	No	JSON array of validator objects (paste as text)
enrichments	String	No	JSON array of enrichment objects (paste as text)

Input example

{
  "apiKey": "YOUR_CATCHALL_API_KEY",
  "query": "Series B funding rounds for SaaS startups",
  "context": "Focus on funding amount and company name",
  "limit": 10
}

Input example with date range and custom enrichments

{
  "apiKey": "YOUR_CATCHALL_API_KEY",
  "query": "Series B funding rounds for SaaS startups",
  "context": "Focus on funding amount and company name",
  "limit": 10,
  "start_date": "2026-01-01T00:00:00Z",
  "end_date": "2026-01-31T00:00:00Z",
  "enrichments": "[{\"name\":\"investee_company\",\"description\":\"Name of the funded startup\",\"type\":\"company\"},{\"name\":\"funding_amount\",\"description\":\"Amount raised in USD\",\"type\":\"number\"}]"
}

Output

The Actor returns the job_id in the default Dataset. Use this ID with other CatchAll utility Actors to track progress and retrieve results.

Output example

{
  "job_id": "5f0c9087-85cb-4917-b3c7-e5a5eff73a0c"
}

Typical workflow

1. Submit — Run CatchAll Create Job to get a job_id.
2. Poll — Use CatchAll Get Job Status to check progress (poll every 30–60 seconds; jobs typically take 10–15 minutes).
3. Retrieve — When the status is completed, run CatchAll Pull Results to get all records.
4. Expand (optional) — Use CatchAll Continue to process more records from the same job.

Use Apify's Actor integrations to chain these steps automatically.

Other CatchAll Actors

Actor	Description
CatchAll	End-to-end job: submit, poll, and retrieve results
CatchAll Initialize	Preview suggested validators and enrichments
CatchAll Get Job Status	Check job progress
CatchAll Pull Results	Retrieve records from a completed job

For the full list, visit the Newscatcher organization page.

Resources

• CatchAll documentation
• Jobs guide
• Write effective queries