Pulppo APIpulppo.com ↗
Search and retrieve property listings from Pulppo.com. Filter by location, price, type, and operation. Get detailed data on Mexican homes and apartments.
What is the Pulppo API?
The Pulppo API provides access to real estate listings from Pulppo.com, Mexico's property marketplace, through 2 endpoints. Use search_properties to query listings by location, operation type, price range, and property type, receiving paginated results with over a dozen fields per property including price, size, bedrooms, images, and neighborhood. Use get_property to retrieve full listing details by ID, including image galleries, amenities, and construction specifics.
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
Endpoints and Data Coverage
The search_properties endpoint accepts filters for operation (sale or rent), location (state slug such as ciudad-de-mexico or jalisco), price_min, price_max, and currency (MXN or USD). Results are paginated using offset and limit (max 20 per page), and can be sorted by fields like relevance score or price using the sort parameter in field,direction format. The response includes total_count for the full result set alongside a properties array containing each listing's id, name, type, price, size, units, city, state, neighborhood, and street.
Property Detail
The get_property endpoint takes a property_id obtained from search_properties results and returns the complete listing record. This includes all images as an array of URLs, the property type (e.g., Departamento, Casa), full price, size in m2, and the listing url pointing directly to the Pulppo.com page. Additional fields cover amenities, description, special features, virtual tour links, videos, construction details, and condition — data not available in search results.
Pagination and Sorting
Pagination is offset-based: set offset to a multiple of limit to walk through pages. The count field in the search response reflects results on the current page, while total_count gives the full match count. Sorting uses a compound format — for example, price,-1 for descending price — which lets you surface the newest, cheapest, or highest-scored listings depending on your use case.
The Pulppo API is a managed, monitored endpoint for pulppo.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when pulppo.com 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 pulppo.com 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 cross-border property search tool filtering Mexican listings by state, price range, and currency in USD or MXN
- Aggregate apartment and house listings in Ciudad de México or Jalisco for a relocation comparison app
- Track price changes on individual properties over time using repeated
get_propertycalls with stored IDs - Populate a real estate portal with paginated, sorted listings by relevance or price from Pulppo's inventory
- Extract neighborhood and street-level location data to map property density across Mexican states
- Enrich a CRM or lead-generation tool with full listing details including images and amenity data from
get_property - Filter rental vs. sale listings separately using the
operationparameter to serve distinct buyer and renter audiences
| 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 Pulppo have an official developer API?+
What does `search_properties` return and how granular is the location filtering?+
properties array with fields including id, name, type, price, currency, size, units, city, state, country, neighborhood, and street, plus total_count for the full result set. Location filtering uses state-level slugs such as ciudad-de-mexico, yucatan-mexico, or estado-de-mexico. There is no sub-state or polygon-based filter parameter currently exposed.Does `get_property` return price history or only the current price?+
price field. The search endpoint returns only the current listed price. If the granularity of the history data matters for your use case, retrieve a specific property via get_property using its id from search results.Is there a way to filter by number of bedrooms or bathrooms through the search endpoint?+
search_properties, but they are not currently exposed as filter parameters in the search inputs. The available filters are operation, location, price_min, price_max, currency, sort, limit, and offset. You can fork this API on Parse and revise it to add bedroom or bathroom filter parameters.Does the API cover commercial properties or only residential listings?+
type values like Departamento and Casa visible in responses. Coverage of commercial property types depends on what Pulppo publishes. There is no dedicated commercial-only filter parameter currently in the endpoint inputs. You can fork this API on Parse and revise it to add a property-type filter parameter targeting commercial categories.