ratethelandlord.org APIratethelandlord.org ↗
Access 10,000+ landlord reviews, aggregate ratings, category breakdowns, and tenant resources from RateTheLandlord.org via a structured REST API.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/a88c3afd-3473-48bc-8aaf-7967741edea2/get_reviews' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetches the 25 most recent landlord reviews from the database. Returns reviews sorted by newest first with review text, ratings, and location information.
No input parameters required.
{
"type": "object",
"fields": {
"total": "string representing total number of reviews in database",
"reviews": "array of review objects with id, landlord, city, state, zip, country_code, review text, rating categories (repair, health, stability, privacy, respect), date_added, and rent"
},
"sample": {
"data": {
"total": "14949",
"reviews": [
{
"id": 17548,
"zip": "N2C2H3",
"city": "KITCHENER",
"rent": null,
"state": "ONTARIO",
"health": "1",
"repair": "1",
"review": "Ignores maintenance issues for years...",
"privacy": "1",
"respect": "1",
"landlord": "GREENWIN",
"stability": "1",
"date_added": "2026-05-14T17:28:41.665Z",
"admin_edited": false,
"country_code": "CA",
"has_user_code": true
}
]
},
"status": "success"
}
}About the ratethelandlord.org API
This API exposes 5 endpoints covering landlord reviews, aggregate ratings, and tenant resources from RateTheLandlord.org. The get_landlord endpoint returns per-landlord category averages across five dimensions — repair, health, stability, respect, and privacy — plus every individual review for that landlord. The get_landlords endpoint lists 10,000+ tracked landlord names, which you can use to look up exact names before querying.
Endpoints and Data Coverage
The API provides five endpoints. get_reviews returns the 25 most recent reviews across all landlords, each with a full rating breakdown, review text, location fields (city, state, ZIP, country code), and a unique ID. get_landlords returns a flat array of all landlord name strings in uppercase — useful for discovering exact names before calling get_landlord. get_filter_options returns available filter values: city objects, ZIP objects (each with an id, name, and value), and a country code array covering regions like CA, US, and AU.
Per-Landlord Aggregates
get_landlord accepts a single required name parameter matching a landlord string from get_landlords (case-insensitive). It returns total reviews, an overall average rating on a 1–5 scale, the full reviews array, and a catAverages object with five category scores: avg_repair, avg_health, avg_stability, avg_respect, and avg_privacy. This makes it straightforward to compare how a specific landlord ranks on individual dimensions rather than just an overall score.
Tenant Resources
get_tenant_resources returns a list of tenant advocacy organizations with fields including name, description, address, phone_number, href (website URL), and geographic scope via city, state, and country_code. The response also includes summary arrays of all cities, states, and countries where resources are available, so you can scope results without iterating the full resources array.
- Build a landlord lookup tool that pulls per-landlord category averages from
get_landlordto surface repair and health scores side by side. - Display the 25 most recent tenant reviews on a housing platform using
get_reviewssorted by newest first. - Populate a city or ZIP filter dropdown in a rental app using the
citiesandzipsarrays fromget_filter_options. - Assemble a directory of tenant advocacy organizations by country or city using
get_tenant_resourceswith itshrefandphone_numberfields. - Autocomplete landlord name search in a form by matching user input against the 10,000+ name strings returned by
get_landlords. - Track a landlord's reputation over time by periodically fetching their
averageandcatAveragesviaget_landlord. - Identify cities with the most active review coverage by aggregating city fields across the
get_filter_optionsresponse.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does RateTheLandlord.org have an official developer API?+
What does `get_landlord` return, and how specific is the rating breakdown?+
get_landlord returns the full set of reviews for a single landlord along with five category averages in the catAverages object: avg_repair, avg_health, avg_stability, avg_respect, and avg_privacy. Each individual review in the reviews array also contains its own per-category scores, so you can compute custom aggregates or filter by date using the date_added field.Can I filter reviews by city, ZIP, or country before fetching them?+
get_reviews returns the 25 most recent reviews without filter parameters — it does not accept city, ZIP, or country inputs. get_filter_options exposes the available cities, ZIPs, and country codes in the database, but filtered review queries are not a current endpoint. You can fork this API on Parse and revise it to add a filtered review endpoint using those values.Does the API support pagination beyond the 25 most recent reviews?+
get_reviews returns only the 25 most recent entries and has no page or offset parameter. To retrieve all reviews for a specific landlord, get_landlord returns the complete review set for that landlord with no pagination limit. Paginated browsing across all landlords is not currently covered. You can fork this API on Parse and revise it to add a paginated all-reviews endpoint.Are landlord responses or dispute resolutions included in the review data?+
date_added. Landlord-side reply data is not currently exposed. You can fork this API on Parse and revise it to add that field if the source makes it available.