Investors
Investor purchases near a place, the investors buying in a set of ZIP codes, the investors who buy homes like a given one, and an investor company found by name.
List investor purchases near a place
Cost: $0.50 per page · desks only
Returns the investor purchases in one place.
Where. Send exactly one place: a point (lat and lng) with a radius_miles, a box (bbox), or a list of ZIP codes (zip).
Filters. Besides the parameters below, the data service accepts its own filters on the purchase date, the price, the kind of purchase and its flags. A parameter or value it does not accept is rejected as 400 upstream-rejected-request, and the charge comes back.
This is a Metered Call: one page is one call, whatever the page holds. If the data service rejects the request, answers that what it names does not exist, fails or does not answer in time, the charge is returned to the Account as a Refund. An empty page for a place inside the data’s coverage is an answer, and it is charged.
Coverage. A place outside the data’s coverage is refused before anything is charged; the docs page states where the data covers. When the place a request names cannot be checked against the coverage and the answer is empty, the call answers 422 property-not-found and its charge is returned.
query Parameters
latLatitude of the point. Send with lng.
lngLongitude of the point. Send with lat.
radius_milesThe radius around the point, in miles.
bboxA box to search inside.
zipFive-digit ZIP codes, comma-separated or as repeated zip parameters.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Idempotency-KeyAn opaque string of your choosing that makes retrying this request safe. Optional — a request without one is never an error, and is charged per call. Reusing a key with the same request — the same path and the same query string — within 24 hours returns the stored result and is not charged again, but only when the earlier call succeeded and its response was stored. If the earlier call was refunded or ended without a stored response, the key is taken over: the new request runs and is charged. Otherwise reusing a key with a different request, or on another endpoint, is refused as a conflict, and nothing is charged for it. If an identical request carrying the same key is still in flight, this one waits briefly for that result; if it does not arrive, the response is 409 with a Retry-After header and nothing is consumed for it. Keys are scoped to your Account — one Account never replays another Account’s result.
X-Customer-Reference^[A-Za-z0-9._:-]{1,6…Optional. Your own ID for the customer this call is for — an ID, not a name or email. Shown back to you grouped by customer on the Usage page.
List investor purchases near a place › Responses
The data service’s answer: a JSON object carrying data and meta. A valid answer with nothing in it is still an answer, and it is charged.
Read one investor purchase
Cost: $0.10 per item · desks only
Returns one investor purchase: both sides of the deed, the property, the price, any resale, the chain of transfers around it and the loan that financed the purchase.
This is a Metered Call. If the data service rejects the request, finds no such purchase, fails or does not answer in time, the charge is returned to the Account as a Refund.
path Parameters
purchase_id^[0-9a-f]{32}$ · requiredThe data service’s own identifier for one investor purchase: 32 lowercase hexadecimal characters, with no prefix. An identifier in any other form is refused before anything is charged.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Idempotency-KeyAn opaque string of your choosing that makes retrying this request safe. Optional — a request without one is never an error, and is charged per call. Reusing a key with the same request — the same path and the same query string — within 24 hours returns the stored result and is not charged again, but only when the earlier call succeeded and its response was stored. If the earlier call was refunded or ended without a stored response, the key is taken over: the new request runs and is charged. Otherwise reusing a key with a different request, or on another endpoint, is refused as a conflict, and nothing is charged for it. If an identical request carrying the same key is still in flight, this one waits briefly for that result; if it does not arrive, the response is 409 with a Retry-After header and nothing is consumed for it. Keys are scoped to your Account — one Account never replays another Account’s result.
X-Customer-Reference^[A-Za-z0-9._:-]{1,6…Optional. Your own ID for the customer this call is for — an ID, not a name or email. Shown back to you grouped by customer on the Usage page.
Read one investor purchase › Responses
The data service’s answer: a JSON object carrying data and meta. A valid answer with nothing in it is still an answer, and it is charged.
List the investors buying in ZIP codes
Cost: $1.00 per list · desks only
Returns the companies buying in a list of ZIP codes, ranked. zip is required.
This is a Metered Call. If the data service rejects the request, fails or does not answer in time, the charge is returned to the Account as a Refund. An empty answer for a place inside the data’s coverage is an answer, and it is charged.
Coverage. A place outside the data’s coverage is refused before anything is charged; the docs page states where the data covers. When the place a request names cannot be checked against the coverage and the answer is empty, the call answers 422 property-not-found and its charge is returned.
query Parameters
zipOne or more five-digit ZIP codes, comma-separated or as repeated zip parameters. Required.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Idempotency-KeyAn opaque string of your choosing that makes retrying this request safe. Optional — a request without one is never an error, and is charged per call. Reusing a key with the same request — the same path and the same query string — within 24 hours returns the stored result and is not charged again, but only when the earlier call succeeded and its response was stored. If the earlier call was refunded or ended without a stored response, the key is taken over: the new request runs and is charged. Otherwise reusing a key with a different request, or on another endpoint, is refused as a conflict, and nothing is charged for it. If an identical request carrying the same key is still in flight, this one waits briefly for that result; if it does not arrive, the response is 409 with a Retry-After header and nothing is consumed for it. Keys are scoped to your Account — one Account never replays another Account’s result.
X-Customer-Reference^[A-Za-z0-9._:-]{1,6…Optional. Your own ID for the customer this call is for — an ID, not a name or email. Shown back to you grouped by customer on the Usage page.
List the investors buying in ZIP codes › Responses
The data service’s answer: a JSON object carrying data and meta. A valid answer with nothing in it is still an answer, and it is charged.
Rank the investors who buy homes like this one
Cost: $2.00 per call, up to 25 buyers · desks only
Ranks the companies whose recent purchases look like one property. Send the property as property_id; it is required.
The answer is a ranking of buyers. It is not a price, a value or an offer.
This is a Metered Call. If the data service rejects the request, finds no such property, fails or does not answer in time, the charge is returned to the Account as a Refund.
query Parameters
property_id^[0-9a-f]{32}$ · requiredThe data service’s own identifier for the property: 32 lowercase hexadecimal characters, with no prefix, as the address lookup returns it. Required. The data service checks this value: one it refuses is answered 400 upstream-rejected-request, and the charge comes back as a Refund.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Idempotency-KeyAn opaque string of your choosing that makes retrying this request safe. Optional — a request without one is never an error, and is charged per call. Reusing a key with the same request — the same path and the same query string — within 24 hours returns the stored result and is not charged again, but only when the earlier call succeeded and its response was stored. If the earlier call was refunded or ended without a stored response, the key is taken over: the new request runs and is charged. Otherwise reusing a key with a different request, or on another endpoint, is refused as a conflict, and nothing is charged for it. If an identical request carrying the same key is still in flight, this one waits briefly for that result; if it does not arrive, the response is 409 with a Retry-After header and nothing is consumed for it. Keys are scoped to your Account — one Account never replays another Account’s result.
X-Customer-Reference^[A-Za-z0-9._:-]{1,6…Optional. Your own ID for the customer this call is for — an ID, not a name or email. Shown back to you grouped by customer on the Usage page.
Rank the investors who buy homes like this one › Responses
The data service’s answer: a JSON object carrying data and meta. A valid answer with nothing in it is still an answer, and it is charged.
Find an investor company by name
Cost: Free · desks only
Returns the investor companies the data service holds whose names match the name you send as q, best first. q is required.
Free: nothing is charged. An Idempotency-Key is ignored here.
query Parameters
qThe name to look for. Required. The data service checks this value: one it refuses is answered 400 invalid-request, and nothing is charged.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Find an investor company by name › Responses
The data service’s answer: a JSON object carrying data and meta. A valid answer with nothing in it is still an answer; this call is free either way.
Summarize the investor purchases in a place
Cost: Free
Returns the headline numbers the data service holds for the investor purchases in one place.
Where. Send exactly one place: a point (lat and lng) with a radius_miles, a box (bbox), or a list of ZIP codes (zip).
Free: nothing is charged. An Idempotency-Key is ignored here.
Coverage. A place outside the data’s coverage is refused before anything is charged; the docs page states where the data covers.
query Parameters
latLatitude of the point. Send with lng.
lngLongitude of the point. Send with lat.
radius_milesThe radius around the point, in miles.
bboxA box to search inside.
zipFive-digit ZIP codes, comma-separated or as repeated zip parameters.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Summarize the investor purchases in a place › Responses
The data service’s answer: a JSON object carrying data and meta. A valid answer with nothing in it is still an answer; this call is free either way.