Pulppo APIpulppo.com ↗
Search and filter real estate listings across Mexico by location, property type, price, bedrooms, and whether you're looking to buy or rent. Get detailed information about specific properties to compare options and find your ideal home on the Pulppo marketplace.
curl -X GET 'https://api.parse.bot/scraper/2560bad1-d8be-4617-bb55-7584671a1f65/search_properties?limit=2&offset=0¤cy=MXN&operation=sale' \ -H 'X-API-Key: $PARSE_API_KEY'
Search properties for sale or rent in Mexico with optional filters. Returns paginated results with property details including name, location, price, size, bedrooms, bathrooms, amenities, images, and description. Use offset and limit for pagination. Each result includes a property id that can be used with get_property for full details.
| Param | Type | Description |
|---|---|---|
| sort | string | Sort order. Format is 'field,direction' where direction is -1 (descending) or 1 (ascending). Examples: 'score,-1' (relevance), 'listing.price.price,1' (cheapest first), 'listing.price.price,-1' (most expensive first). |
| limit | integer | Number of results per page (max 20). |
| offset | integer | Offset for pagination. Use with limit to page through results. |
| currency | string | Currency for price display and filtering (e.g. 'MXN', 'USD'). |
| location | string | State/location slug to filter by (e.g. 'ciudad-de-mexico', 'estado-de-mexico', 'yucatan-mexico', 'jalisco', 'queretaro-mexico'). Omitting returns all locations. |
| operation | string | Type of listing operation. |
| price_max | string | Maximum price filter. |
| price_min | string | Minimum price filter. |
| bedrooms_min | string | Minimum number of bedrooms filter. |
| property_type | string | Property type filter (e.g. 'Departamento', 'Casa', 'Terreno residencial', 'Oficina'). Omitting returns all types. |
{
"type": "object",
"fields": {
"count": "integer number of results available",
"limit": "integer current page size",
"offset": "integer current offset",
"properties": "array of property objects with id, name, type, location, city, state, country, neighborhood, street, price, currency, size, units, bedrooms, bathrooms, parkings, operation, images, url, amenities, description, special_features",
"total_count": "integer total number of matching properties"
},
"sample": {
"data": {
"count": 6951,
"limit": 2,
"offset": 0,
"properties": [
{
"id": "655286e0cfa2fc3649feb122",
"url": "https://pulppo.com/propiedades/655286e0cfa2fc3649feb122",
"city": "Miguel Hidalgo",
"name": "Departamento en venta en Polanco V de 3 recamaras",
"size": 336,
"type": "Departamento",
"price": 25000000,
"state": "Ciudad de México",
"units": "m2",
"images": [
"https://images.pulppo.com/property/624b787eaacf7173868cead9/picture_1.jpeg"
],
"street": "Calle Arquímedes 0",
"country": "Mexico",
"bedrooms": 3,
"currency": "MXN",
"location": "Calle Arquímedes 0, Polanco",
"parkings": 3,
"amenities": [
"Juegos Infantiles",
"Alberca",
"Gimnasio"
],
"bathrooms": 3,
"operation": "sale",
"description": "Este departamento, ubicado a solo unos pasos del bosque de Chapultepec...",
"neighborhood": "Polanco",
"special_features": [
"Exclusivo Departamento en Chapultepec, CDMX",
"Virtual tour: https://my.matterport.com/show/?m=yGZXw52bA6z"
]
}
],
"total_count": 6951
},
"status": "success"
}
}About the Pulppo API
The Pulppo API on Parse exposes 2 endpoints for the publicly available data on pulppo.com. Calls return JSON over HTTPS and are billed per successful response.
Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.