Common questions about Buy Box: how to get access, how it is billed, and how it behaves.
How do I get access to Buy Box, and what does it cost?
Buy Box is available pay-as-you-go and as part of BatchData subscription plans. Because rates depend on your expected volume, our sales team works with you to recommend the right plan and quote pricing for your usage. Contact sales to get set up.
How does billing work?
You are billed per matched investor profile returned, deduped within a request. A request that returns 10 investors is billed for 10 matches. The endpoint requires take to be greater than zero, so there is no free count-only path: every successful request that returns investors incurs a per-match charge. You pay only for the investors that come back, so a tightly filtered search costs less than a broad one.
On a subscription, matches draw down your plan's monthly allotment.
Is the endpoint synchronous?
Yes. Buy Box is a single synchronous POST to /api/v2/investor/buybox. You send a subject property and get the ranked investors back in the same response. There is no job to create, no status to poll, and no callback.
What if I include an unsupported investor classification?
If you pass TRADITIONAL HOMEOWNER in the classification filter, the server removes it and returns a note in the response warnings array explaining that it was ignored. The rest of your filter still applies, so the request succeeds and returns investors that match your remaining classifications.
Why did I get fewer investors than I expected?
Buy Box only returns active investors. An owner must have at least three across current holdings, acquisitions, or dispositions to be eligible, and the default classification filter is limited to Flippers and Landlords. Widening the classification list or enlarging the search radius (distanceMiles) can surface more investors.