PriceDNA API

Three APIs, one key.

Property analysis, geocoding and rent, as JSON, from your own code.

Personalized real estate intelligence, as an API.

https://api.pricedna.co/v1

System status

The APIs

Each has its own reference. One key works for all three.

  • Property API

    Property report, as JSON: the price your goal can support, and every section behind it.

    • POST /v1/property
  • Geocoding API

    Addresses to points and points to the nearest address, with the census tract and flood risk when you ask.

    • POST /v1/geocode
    • POST /v1/reverse
  • Rent API

    Typical rent and its range by bedroom count, with yearly growth, for any US place.

    • POST /v1/rent

Need more than Pro?

Higher volume, custom data, or a custom integration. Tell us what we can help with.

Contact us

Get a key

Every account can make keys, on every plan.

Create a free account, then make a key in the API console.

Authentication

Send your key in the X-PriceDNA-API-Key header on every request.

X-PriceDNA-API-Key: $PRICEDNA_KEY
Content-Type: application/json

Keep your key server-side only. Requests and responses are JSON.

What’s included

Every plan includes all three APIs. Paid plans include more.

The Free plan
APIIncludedWhat counts
Property API 10 new properties a month A property counts once, the first time it’s analyzed. Reruns are free.
Geocoding API 2,500 points a day 1 point per lookup, plus 1 per enrichment (census, flood) on a row we place. A row we don’t place costs its 1 point. Rows we couldn’t finish aren’t charged. Resets at midnight Eastern time.
Rent API 100 rent checks a month 1 rent check per place you send, found or not. Places we couldn’t finish don’t count. Resets on the 1st.

The Geocoding and Rent APIs take up to 100 rows per request. See paid plans.

OpenAPI spec

All three APIs, in one OpenAPI 3.1 file.

Errors

Errors usually arrive as problem details (RFC 9457), sent as application/problem+json.

400 validation-error
Some fields are invalid. errors lists each one and what is wrong with it.
400 invalid-request
The request can’t be read, for example malformed JSON or an Idempotency-Key that isn’t 1 to 255 visible ASCII characters.
401 unauthorized
The API key is missing or not valid.
402 no-new-properties-left
Your plan has no new properties left this cycle. new_properties_left, new_properties_per_cycle and resets_at say what it includes and when it resets. Reruns of a property you have analyzed still work.
403 forbidden
This key can’t make this request.
404 not-found
The path doesn’t exist.
409 request-in-progress
A request with this Idempotency-Key is still running. Retry after the seconds in Retry-After.
422 idempotency-key-reused
This Idempotency-Key was already used with a different body. Send a new key.
429 rate-limited
Too many requests in a short time. Nothing is counted. Wait a moment and retry.
429 no-points-left-today
The request needs more points than you have left today. Nothing is charged. Send fewer rows or fewer enrichments, or wait until midnight Eastern time; points_left and points_needed say how many.
429 no-rent-checks-left
More places than you have rent checks left this month. Nothing is counted. Send fewer places, or wait until the 1st; rent_checks_left says how many are left.
503 service-unavailable
The service had a problem. Retry shortly.
5XX server-error
The service had a problem. Retry shortly.
HTTP/1.1 400 Bad Request
Content-Type: application/problem+json

{
  "type": "https://www.pricedna.co/api#error-validation-error",
  "title": "Your request has invalid fields",
  "status": 400,
  "detail": "Your request has invalid fields",
  "errors": [
    {
      "field": "number_of_units",
      "detail": "Must be between 1 and 500."
    }
  ]
}

Ready to start building?

Get your free API key