Result quality

Decide which candidates to show

Fast and Pro always score candidates. The API returns candidates in relevance order. Preserve that order. The public score is a coarse grade from 1 to 4. Fast can return a page of candidates who all have grade 4 and still rank those candidates differently.

ScoreClassification
4Great candidate
3Good candidate
  • Default results. Leave fill_with_low_confidence_results set to false to keep low-confidence fallback disabled. Use the returned order when displaying matches.
  • Include lower-confidence results: Set fill_with_low_confidence_results to true to fill remaining slots after stronger candidates are exhausted. Keep them visibly distinct from Great and Good matches. Lower-confidence fallback results are free for search and scoring. Contact-reveal charges still apply when contact data is requested and found.

profile_scoring is accepted for compatibility. Omit it in new integrations.

Show why a match fits. Enable insights when your product needs explanations and quotes. If evidence is missing, let the user review the profile.

Read about scoring and result order.


Did this page help you?