How it works
CatchAll processes queries through a multi-stage pipeline:1
Analyze
Generates search queries, validators, and extractors from your input
2
Fetch
Retrieves relevant content from web sources
3
Cluster
Groups similar content into distinct events
4
Validate
Filters clusters based on relevance criteria
5
Extract
Pulls structured data from validated clusters
6
Return
Delivers records with source citations
Processing typically takes 10-15 minutes per job. Poll the status endpoint
every 30-60 seconds to track progress.
Key characteristics
Dynamic schemas
Dynamic schemas
Each job generates a unique response schema. Field names and structure in the
enrichment object vary between jobs—even with identical inputs.Guaranteed fields in every record:record_idrecord_titlecitationsarray
- All other fields in
enrichment(names, types, structure) - Number of records returned
- Specific content extracted
Non-deterministic processing
Non-deterministic processing
Identical queries can produce different results:
- LLMs may generate different keywords, validators, and extractors.
- Different content sources may be retrieved.
- Field names and structure vary between runs.
- Record counts differ.
Asynchronous operation
Asynchronous operation
Each query creates a job that processes asynchronously.
Use the returned
job_id to poll for status and retrieve results when the job completes.Endpoints
Base URL:https://catchall.newscatcherapi.com
- Jobs
- Monitors
- Meta
| Endpoint | Method | Description |
|---|---|---|
/catchAll/submit | POST | Create a new job |
/catchAll/jobs/user | GET | List all jobs for your API key |
/catchAll/status/{job_id} | GET | Check job processing status |
/catchAll/pull/{job_id} | GET | Retrieve job results |
Use cases
- Market intelligence: Company earnings, M&A activity, product launches
- Regulatory monitoring: Policy changes, government actions, compliance updates
- Business development: Partnerships, funding rounds, market entries
- Competitive analysis: Competitor activities and announcements
- Research automation: Structured data extraction for analysis
- News aggregation: Topic-specific news with structured output
What’s next
Quickstart
Make your first request and get results in minutes
Monitors
Automate recurring queries with scheduled execution
API Reference
Detailed endpoint documentation and parameters
Dynamic Schemas
Handle variable response structures in your integration
For technical support, contact us at support@newscatcherapi.com.

