Skip to main content
FindAll offers different generators that determine the quality and thoroughness of FindAll run results. See Pricing for generator costs and all API rates.

Generators

GeneratorBest ForCandidate PoolExpected Match Rate
previewTesting queries before committing to a full run~10 candidates evaluatedVaries — use to validate schema
baseBroad, common queries where you expect many matchesModerate poolHigher (broad criteria match more candidates)
coreSpecific queries with moderate expected matchesLarge poolModerate (balanced breadth and depth)
proHighly specific queries with rare or hard-to-find matchesLargest poolLower per candidate (thorough search for rare matches)
Candidate pool size matters: Each generator evaluates a different number of candidates. preview evaluates ~10, while pro searches the most thoroughly. If you’re getting 0 matches, try upgrading to a stronger generator before modifying your query — the issue may be pool size, not query quality.

How to Choose

1. Start with Preview

Always test your query with preview 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: Choose base 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
Choose 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
Choose 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
Note: For match counts above 50, the per-match cost becomes more significant than the fixed cost in your total bill. When using enrichments, consider that enrichment costs also scale with the number of matches.

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.
Tip: If a run terminates early, consider using a more advanced generator (like pro instead of base) or refining your query criteria to be more achievable.
  • 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