Ranking Prospects

Get ranked prospects

Pass a product_id to get prospects ranked by deal score. Results are sorted by deal score (descending), then buying signal score (descending).

curl "https://dealsurface.com/api/v1/prospects?product_id=12&limit=5" \
  -H "Authorization: Bearer $DEALSURFACE_API_KEY"

Filtering results

Narrow results to high-potential prospects using filters:

• min_deal_score=4 — only scores 4 and 5 (strong and very strong).
• min_buying_signal=0.7 — high buying signal confidence.

Deep-dive on a prospect

Use the ticker from the list to get a full analysis including findings, recommendations, and evidence excerpts:

curl "https://dealsurface.com/api/v1/prospects/TRV?product_id=12" \
  -H "Authorization: Bearer $DEALSURFACE_API_KEY"

The response includes:

• findings_summary — AI-generated summary of key findings.
• recommendation_summary — Why this is a good fit for your product.
• findings — Individual findings with evidence excerpt IDs.
• excerpts — The actual evidence from earnings calls, SEC filings, etc.

Pagination

Use limit and offset to paginate through large result sets. The total_count field tells you the total number of results available.

// Page through all prospects
let offset = 0;
const limit = 100;
const allProspects = [];

while (true) {
  const res = await fetch(
    `https://dealsurface.com/api/v1/prospects?product_id=12&limit=${limit}&offset=${offset}`,
    { headers: { Authorization: `Bearer ${apiKey}` } }
  );
  const { prospects, total_count } = await res.json();
  allProspects.push(...prospects);
  offset += limit;
  if (offset >= total_count) break;
}

Next steps

Once you've identified promising prospects, you can generate a buying committee DealMap to map the stakeholders at each company.