GET /v1/scanner/prospects
Scope required:read Cost: 0
Query parameters:
| Param | Notes |
|---|---|
category | retail, saas, marketplace, … |
region | latam, north_america, … |
min_opportunity | Minimum opportunity_score (0–100) |
priority | critical, high, medium, low |
limit | Default 50, max 200 |
ProspectScore.
GET /v1/scanner/prospects/heat-map
Category × region matrix: aggregate readiness, demand, opportunity, and top priority per cell. Scope required:read Cost: 0
avg_opportunity.
GET /v1/scanner/prospects/export
CSV for CRM import. Same filters as/prospects.
Scope required: read Cost: 0
Priority thresholds
| Opportunity score | Priority |
|---|---|
| > 80 | critical |
| 61 – 80 | high |
| 41 – 60 | medium |
| ≤ 40 | low |
Demand score composition
- public_intelligence — matches against the demand_intelligence data points for the merchant’s category/region.
- synthetic_test — weighted on how often agents fail at the merchant’s checkout (more failures = more demand for an integration).
- observatory — AI search engine mentions (ChatGPT, Perplexity, Claude) and MCP-registry listings for the domain.
- telemetry — real agent checkout attempts observed in production traffic.
