RateTheLandlord APIratethelandlord.org ↗
Access 10,000+ landlord reviews, aggregate ratings, category breakdowns, and tenant resources from RateTheLandlord.org via a structured REST API.
What is the RateTheLandlord 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.
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'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace ratethelandlord-org-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.ratethelandlord_api import RateTheLandlord, Review, Landlord, Filter, Resource, LandlordNotFound
rtl = RateTheLandlord()
# Get recent reviews
for review in rtl.reviews.recent():
print(review.landlord, review.city, review.state, review.repair)
# Look up a specific landlord
landlord = rtl.landlords.get(name="GREENWIN")
print(landlord.name, landlord.average, landlord.total)
print(landlord.catAverages.avg_repair, landlord.catAverages.avg_health)
for rev in landlord.reviews:
print(rev.id, rev.city, rev.date_added, rev.review)
# List all landlord names in the database
for name in rtl.landlords.list_names():
print(name)
# Get filter options for geographic coverage
filters = rtl.filters.get()
print(filters.countries)
for city in filters.cities:
print(city.id, city.name, city.value)
# List tenant resources
for resource in rtl.resources.list():
print(resource.name, resource.country_code, resource.href, resource.description)
Fetches the 25 most recent landlord reviews from the database, sorted newest first. Each review includes the landlord name, location (city, state, zip, country), review text, five rating categories (repair, health, stability, privacy, respect) each scored 1-5, date added, and optional rent amount. No filtering or pagination — always returns the latest 25.
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, date_added, and rent"
},
"sample": {
"data": {
"total": "15143",
"reviews": [
{
"id": 17809,
"zip": "11206",
"city": "NEW YORK",
"rent": null,
"state": "NEW YORK",
"health": "4",
"repair": "4",
"review": "The process was professional...",
"privacy": "4",
"respect": "4",
"landlord": "JUNE HOMES",
"stability": "4",
"date_added": "2026-06-10T16:42:00.599Z",
"admin_edited": false,
"country_code": "US",
"has_user_code": true
}
]
},
"status": "success"
}
}About the RateTheLandlord API
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.
The RateTheLandlord API is a managed, monitored endpoint for ratethelandlord.org — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ratethelandlord.org changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official ratethelandlord.org API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.