kwmexico APIkwmexico.mx ↗
Search and retrieve KW Mexico real estate listings by state, city, and category. Get property details, pricing, photos, agent info, and coordinates.
What is the kwmexico API?
The kwmexico.mx API provides access to active Keller Williams Mexico property listings through 2 endpoints covering search and full listing detail. The search_listings endpoint returns paginated results filtered by Mexican state, municipality, and listing category (venta or renta), with each record including price, location, and a thumbnail. The get_listing endpoint exposes the complete record for a single property: all photo URLs, agent details, geographic coordinates, lot size, and currency.
curl -X GET 'https://api.parse.bot/scraper/ca95abbc-e85c-45bb-9dbd-80ef2308c2f9/search_listings?state=Ciudad+de+M%C3%A9xico&listing_category=venta' \ -H 'X-API-Key: $PARSE_API_KEY'
Search active real estate listings filtered by state, optional city (municipio/alcaldía), and listing category (venta or renta). Returns paginated results with 30 listings per page. Each result includes property details, location, pricing, and a single thumbnail image. Use get_listing with the returned listing_url for full photo galleries and agent details.
| Param | Type | Description |
|---|---|---|
| city | string | Municipality or alcaldía within the state (e.g. 'Coyoacán', 'Corregidora'). When omitted, returns listings from all cities in the state. |
| page | integer | Page number for pagination (30 results per page). |
| staterequired | string | Mexican state name (e.g. 'Ciudad de México', 'Querétaro', 'Guanajuato'). |
| listing_categoryrequired | string | Type of listing operation. |
{
"type": "object",
"fields": {
"page": "current page number",
"count": "number of listings returned on this page",
"listings": "array of listing objects with property details"
},
"sample": {
"data": {
"page": 1,
"count": 30,
"listings": [
{
"city": "Coyoacán",
"size": 380,
"price": 13500000,
"state": "Ciudad de México",
"title": "MAGNÍFICA CASA DE REVISTA VENTA a una cuadra de periférico",
"country": "Mexico",
"bedrooms": 3,
"currency": "MXN",
"latitude": 19.299102,
"lot_size": 305,
"bathrooms": "3.0",
"longitude": -99.153225,
"size_unit": "m2",
"image_urls": [
"https://repstaticneu.azureedge.net/images/2003/L/WM/Large/596c1630-85d3-4e7b-9307-8f14376a4737-b84fe7dc-016b-4de2-8ebb-acf1d98bd8e4.jpg"
],
"mls_number": "1027-11298",
"description": "Venta de estupenda casa estilo mexicano moderno...",
"listing_url": "https://www.kwmexico.mx/Sections/Propiedades/propiedad_detalles.html?Filtro_Propiedad=1313",
"property_id": 1313,
"neighborhood": "Bosques de Tetlameya",
"lot_size_unit": "m2",
"property_type": "Casa",
"agent_source_url": null,
"listing_category": "venta"
}
]
},
"status": "success"
}
}About the kwmexico API
Endpoints and What They Return
The search_listings endpoint accepts three parameters: state (required, e.g. 'Ciudad de México' or 'Querétaro'), listing_category (required: 'venta' or 'renta'), and optionally city to narrow results to a specific municipio or alcaldía. Pagination is controlled via page, with each page returning up to 30 listings. Each listing object in the response includes property details, location fields, a price value, and a single thumbnail image URL.
Full Listing Detail
Passing a full KW Mexico property URL or a numeric property ID to get_listing returns the complete record for that property. Response fields include title, price, currency (e.g. MXN or USD), bedrooms, size (construction area in m²), lot_size (land area in m²), latitude, longitude, city, state, country, agent details, and all available photo URLs. When a living area measurement is unavailable, size falls back to the lot_size value.
Coverage and Scope
Listings are drawn from Keller Williams Mexico's active inventory across Mexican states. The state parameter accepts full Spanish-language state names as used on the platform. Without a city filter, search_listings returns all active listings in the specified state for the chosen category, across all municipalities. The listing_url input to get_listing is flexible: it accepts either the full canonical URL or a bare numeric ID.
The kwmexico API is a managed, monitored endpoint for kwmexico.mx — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when kwmexico.mx 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 kwmexico.mx 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?+
- Aggregate for-sale property listings across multiple Mexican states using
search_listingswithlisting_category: 'venta' - Build a rental search interface filtered by alcaldía in Ciudad de México using the
cityparameter - Display full property detail pages including all photos and coordinates pulled from
get_listing - Compare asking prices (
priceandcurrency) across states to identify regional pricing trends - Map active listings using
latitudereturned byget_listingfor geo-spatial visualization - Sync agent contact information from listing detail records into a CRM or lead-routing system
- Monitor lot sizes and construction areas across listings using
lot_sizeandsizefields for land-use analysis
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Keller Williams Mexico have an official developer API?+
What does `search_listings` return compared to `get_listing`?+
search_listings returns up to 30 listing summaries per page, each with core property details, location, price, and one thumbnail image. get_listing returns the full record for a single property, adding all photo URLs, agent information, geographic coordinates (latitude), lot_size, construction size, and currency code.Does the API cover sold or off-market properties, or only active listings?+
search_listings filters to live inventory, and get_listing retrieves currently published property records. You can fork this API on Parse and revise it to add an endpoint targeting historical or recently sold listings if that data becomes accessible on the source.Can I filter `search_listings` by property type, price range, or number of bedrooms?+
search_listings endpoint filters by state, optional city, and listing_category (venta or renta). Filtering by price range, bedrooms, or property type is not supported at the search stage — those fields are available in the per-listing response from get_listing. You can fork this API on Parse and revise it to add those filter parameters.How does pagination work in `search_listings`?+
page field confirming the current page number and a count field for how many listings were returned on that page. Increment the page parameter to retrieve subsequent pages; when count is less than 30, you have reached the last page of results.