Generators
| Generator | Best For |
|---|---|
preview | Testing queries (~10 candidates) |
base | Broad, common queries where you expect many matches |
core | Specific queries with moderate expected matches |
pro | Highly specific queries with rare or hard-to-find matches |
How to Choose
1. Start with Preview
Always test your query withpreview first to validate your approach and get a sense of how many matches to expect. See Preview.
2. Choosing the Right Generator
Based on your preview results and query characteristics: Choosebase when:
- You expect many matches (e.g., “companies in healthcare”)
- Your query has broad criteria that are common
- You’re searching for fewer than 20 matches where the low fixed cost matters most
core when:
- You expect a moderate number of matches (e.g., “healthcare companies using AI for diagnostics”)
- Your query is fairly specific but not extremely rare
- You need between 20-50 matches
pro when:
- You expect few matches or very specific criteria (e.g., “Series A healthcare AI companies with FDA-approved products”)
- Your query requires the most thorough and comprehensive search
- The higher per-match cost is acceptable for your use case
Enrichments
When adding enrichments to extract additional data from your matches, each enrichment adds its own per-match cost based on the Task API processor you choose. Since enrichments run on every match and you can add multiple enrichments, they can significantly impact your total costs for high-match queries. Choose enrichment processors based on the complexity of data extraction needed.Additional Notes
- Extend Runs: Fixed cost is not charged again, only per-match costs for new matches. If enrichments are present, they also run on new matches at the same enrichment processor cost.
- Enrichments: Enrichments are charged based on Task API processor pricing × number of matches. You can add multiple enrichments using different processors, and each enrichment’s cost is calculated separately.
- Run Lifecycle: You’re charged for work completed before cancellation, including any enrichments that finished.
pro instead of base) or refining your query criteria to be more achievable.
Related Topics
- Pricing: Consolidated pricing for all Parallel APIs
- Preview: Test queries with ~10 candidates before running full searches
- Enrichments: Extract additional structured data for matched candidates
- Task API Processors: Understand processor options for enrichments
- Extend Runs: Increase match limits without paying new fixed costs
- Streaming Events: Receive real-time updates via Server-Sent Events
- Webhooks: Configure HTTP callbacks for run completion and matches
- Run Lifecycle: Understand run statuses and how to cancel runs
- API Reference: Complete endpoint documentation