Retrieve random US property records from RentCast via pay-per-call MPP endpoint.
What it does
The RentCast Random Properties endpoint returns a random sample of US property records from the RentCast database. It is one of ten RentCast endpoints exposed through the Locus MPP (Micropayment Protocol) gateway, which settles payments via the Tempo L2 network using pathUSD.
This specific endpoint accepts a single optional parameter — `limit` (1–500, default 5) — and returns a set of randomly selected property records. It is useful for testing, sampling, or populating demo interfaces with real property data without needing to specify a location or filter criteria. Each call costs 33,000 base units of pathUSD (a 6-decimal stablecoin), which equals $0.033 per request.
The broader RentCast service available through this same MPP gateway includes property record search, property lookup by ID, AVM value estimates, rent estimates, sale and rental listing search, listing lookup by ID, and market statistics by zip code. All sibling endpoints share the same $0.033 per-call price. The endpoint uses POST method and accepts JSON request bodies. The probe returned 404 on HEAD/GET, which is expected since the OpenAPI spec defines only POST for this path.
Capabilities
Use cases
- —Sampling random US property records for testing or demo purposes
- —Populating prototype real estate applications with real data
- —Generating random property datasets for analysis or training
- —Quick smoke-testing of RentCast data availability before running targeted queries
Fit
Best for
- —Agents or apps that need random US property data without specifying location filters
- —Developers testing integrations with RentCast property data
- —Populating demo UIs with realistic property records
Not for
- —Targeted property searches by address, city, or coordinates (use the /rentcast/properties endpoint instead)
- —Property valuation or rent estimation (use the value-estimate or rent-estimate endpoints)
- —Non-US real estate data
Quick start
curl -X POST https://rentcast.mpp.paywithlocus.com/rentcast/random-properties \
-H "Content-Type: application/json" \
-d '{"limit": 5}'Example
Request
{
"limit": 5
}Endpoint
Quality
The OpenAPI spec is well-defined with clear request schema and payment info, but the probe did not capture a 402 challenge on the specific endpoint (only HEAD/GET were tried; POST is the defined method). No response schema is documented, and no example response data is available. Crawled pages all returned generic 404 JSON, providing no additional documentation.
Warnings
- —Probe returned 404 because only HEAD and GET were attempted; the OpenAPI spec defines POST as the method — endpoint is likely live but unconfirmed via probe.
- —No response schema is documented in the OpenAPI spec; the structure of returned property records is unknown.
- —Currency address 0x20c000000000000000000000b9537d11c60e8b50 is assumed to be pathUSD with 6 decimals based on the Tempo settlement method; if decimals differ, the $0.033 price would be incorrect.
- —No crawled documentation was retrievable from the gateway host; external docs at https://developers.rentcast.io/reference/introduction and https://beta.paywithlocus.com/mpp/rentcast.md were not crawled.
Citations
- —The endpoint is defined as POST with an optional 'limit' parameter (1-500, default 5) and costs 33000 base units via Tempo settlement.https://rentcast.mpp.paywithlocus.com
- —RentCast provides US real estate intelligence including property records, AVM valuations, rent estimates, sale/rental listings, and market statistics.https://rentcast.mpp.paywithlocus.com
- —API reference documentation is available at developers.rentcast.io.https://developers.rentcast.io/reference/introduction
- —LLM-oriented docs are referenced at beta.paywithlocus.com/mpp/rentcast.md.https://beta.paywithlocus.com/mpp/rentcast.md