Discover/Pulppo API
live

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.

This API takes change requests — .
Endpoint health
monitored
get_property
search_properties
Checks pendingself-healing
Endpoints
2
Updated
3h ago
This call costs1 credit / call— charged only on success
Try it
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).
Number of results per page (max 20).
Offset for pagination. Use with limit to page through results.
Currency for price display and filtering (e.g. 'MXN', 'USD').
State/location slug to filter by (e.g. 'ciudad-de-mexico', 'estado-de-mexico', 'yucatan-mexico', 'jalisco', 'queretaro-mexico'). Omitting returns all locations.
Type of listing operation.
Maximum price filter.
Minimum price filter.
Minimum number of bedrooms filter.
Property type filter (e.g. 'Departamento', 'Casa', 'Terreno residencial', 'Oficina'). Omitting returns all types.
api.parse.bot/scraper/2560bad1-d8be-4617-bb55-7584671a1f65/<endpoint>
Ready to send
Fill in the parameters and hit sign in to send to see live response data here.
Call it over HTTPgrab a free API key at signup
curl -X GET 'https://api.parse.bot/scraper/2560bad1-d8be-4617-bb55-7584671a1f65/search_properties?limit=2&offset=0&currency=MXN&operation=sale' \
  -H 'X-API-Key: $PARSE_API_KEY'
All endpoints · 2 totalmissing one? ·

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.

Input
ParamTypeDescription
sortstringSort 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).
limitintegerNumber of results per page (max 20).
offsetintegerOffset for pagination. Use with limit to page through results.
currencystringCurrency for price display and filtering (e.g. 'MXN', 'USD').
locationstringState/location slug to filter by (e.g. 'ciudad-de-mexico', 'estado-de-mexico', 'yucatan-mexico', 'jalisco', 'queretaro-mexico'). Omitting returns all locations.
operationstringType of listing operation.
price_maxstringMaximum price filter.
price_minstringMinimum price filter.
bedrooms_minstringMinimum number of bedrooms filter.
property_typestringProperty type filter (e.g. 'Departamento', 'Casa', 'Terreno residencial', 'Oficina'). Omitting returns all types.
Response
{
  "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.