← App
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.

Loading the price list…

Posted letters

Letters are the one thing that costs real money to send, so they are priced separately from tokens and bought in packs. A credit is one A4 letter — printed, folded, enveloped and posted second class by our print partner, usually in the post within one working day. Credits do not expire.

Loading letter prices…

Nothing is ever posted automatically. Every letter takes an explicit press, one at a time, with the recipient shown before it goes — and if a letter fails to post, the credit goes straight back. There is a daily posting cap on every account as a safety net against a runaway campaign.

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.