Costs & API
What everything costs. Before you click it.
One token is one metered action, and most of the platform is not metered at all. Nothing is charged unless it succeeds — a lookup that fails costs you nothing. This list is generated from the same settings the software bills with, so it cannot drift from what you are actually charged.
The API
Every weapon in the platform is an HTTP endpoint, and Predator Business accounts can call them directly — to feed a spreadsheet, a bot, or an AI agent that does your sourcing while you sleep.
Authentication
curl https://propertypredator.com/api/planning/intel?postcode=SA2+0UL \
-H "Authorization: Bearer <your access token>"
Tokens come from POST /api/auth/refresh with your refresh token. Metered endpoints draw on the same monthly allowance as the app — there is no separate API meter to be surprised by.
The endpoints worth building on
GET /api/planning/intel?postcode=&address=&radius_km=
Approval rates by scheme type, precedent, refusals, stale consents. Free.
GET /api/planning/stale?postcode=
Permissions granted long enough ago to have lapsed — an off-market lead list. Free.
POST /api/motivation/score
Score a vendor's motivation from evidence you hold. Free, and stateless.
GET /api/skiptrace?company_name=|company_number=|postcode=
Decision-maker, PSCs, charges and portfolio for a company-owned title. Free.
GET /api/buybox?location=&strategy=&motivated_only=
The ranked reverse search, with motivation scoring on every result.
POST /api/xray
The full read on one property. Metered — see the list above.
POST /api/pipeline/save
Push a deal into a pipeline from your own systems. Idempotent per property.
GET /api/presets
The 22 named plays and their parameters, so an agent can pick one. Free.
Rules
Rate limit: 120 requests a minute per account, and a metered call still counts against your monthly allowance.
Attribution: where a response carries an attribution field, it is a licence condition — pass it through to whatever you build.
Caching: please cache. Several sources underneath are free public services, and hammering them costs everybody the data.
What you may not do: resell raw responses as a competing data feed, or use them to rebuild our ownership dataset.
API access is included with Predator Business. If you are building something specific, say what it is and we will tell you honestly whether the API is the right way to do it.