Com APIproperati.com.ar ↗
Search and retrieve Argentine real estate listings from Properati. Filter by location, property type, and operation. Get prices, features, and similar properties.
What is the Com API?
The Properati Argentina API exposes 5 endpoints for searching and retrieving real estate listings across Argentina. Use search_listings to query by location slug, operation type (venta, alquiler, alquiler-temporal), property type, and sort order, getting back paginated results with prices, images, and URLs. get_listing_detail returns the full description, seller information, and feature list for any individual property.
curl -X GET 'https://api.parse.bot/scraper/949f4593-9550-4b68-875b-f8c72a3e3e0a/search_listings?page=1&sort=precio-ascendente&location=capital-federal&operation=venta&property_type=departamento' \ -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 properati-com-ar-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.
"""Walkthrough: Properati Argentina SDK — search, detail, and similar listings."""
from parse_apis.properati_argentina_api import (
Properati, Sort, Operation, PropertyType, ListingNotFound
)
client = Properati()
# Search apartments for sale in Capital Federal, sorted by price ascending
for listing in client.listingsummaries.search(
location="capital-federal",
operation=Operation.VENTA,
property_type=PropertyType.DEPARTAMENTO,
sort=Sort.PRECIO_ASCENDENTE,
limit=5,
):
print(listing.price_display, listing.location_display)
# Drill into the first result for full details
summary = client.listingsummaries.search(
location="capital-federal",
operation=Operation.ALQUILER,
property_type=PropertyType.CASA,
limit=1,
).first()
if summary:
detail = summary.details()
print(detail.title, detail.price_display, detail.seller)
# Get similar listings for the detail
for similar in detail.similar(limit=3):
print(similar.title, similar.price, similar.number_of_bedrooms)
# Typed error handling: fetch a listing by ID
try:
listing = client.listings.get(id="14032-32-699-nonexistent")
print(listing.title, listing.price_display)
except ListingNotFound as exc:
print(f"Listing not found: {exc}")
print("exercised: listingsummaries.search / details / similar / listings.get")
Search for real estate listings in Argentina. Returns paginated results with listing summaries including price, location, and basic features. Pagination is page-based; each page returns up to 30 listings. Server-side sorting and filtering by location, property type, and operation type. The total_count may be approximate.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| sort | string | Sort order for results. |
| location | string | Location slug (e.g., 'capital-federal', 'bs-as-g-b-a-zona-norte'). |
| operation | string | Operation type for the listing. |
| property_type | string | Property type to filter by. |
{
"type": "object",
"fields": {
"listings": "array of listing summary objects with id, url, price_display, currency, price, location_display, and image_url",
"pagination": "object with current_page (integer) and has_next (boolean)",
"total_count": "integer total number of results"
},
"sample": {
"data": {
"listings": [
{
"id": "019c2d81-0679-72fb-8b3b-8e78b5aabf8a",
"url": "https://www.properati.com.ar/detalle/14032-32-699-8e78b5aabfaa-19c2da1-8b5b-731b",
"price": "65000",
"currency": "USD",
"image_url": "https://img.properati.com/example",
"price_display": "USD 65.000",
"location_display": "Centro / Microcentro, Capital Federal"
}
],
"pagination": {
"has_next": true,
"current_page": 1
},
"total_count": 1
},
"status": "success"
}
}About the Com API
Search and Filter Listings
The search_listings endpoint accepts filters for location (as slugs like capital-federal or bs-as-g-b-a-zona-norte), operation (buy, rent, or short-term rental), and property_type (departamento, casa, lote, ph, quinta, local, oficina, cochera, galpon). Results are paginated and each listing object in the response includes id, url, price_display, currency, price, location_display, and image_url. The pagination object exposes current_page and has_next, and total_count gives the full result count for a query.
Listing Detail and Similar Properties
get_listing_detail accepts either a full listing url from search results or an id path string. It returns structured fields including title, seller, features (an array of feature strings), description, and price_display. For discovery or recommendation use cases, get_similar_listings takes a listing UUID and returns up to 12 comparable properties, each with numberOfBedrooms, numberOfBathrooms, floor, propertyType, operationType, price, and location.
Reference Endpoints
get_property_types and get_operation_types return the current valid slug arrays that search_listings accepts as property_type and operation parameters. These are useful for validation or building dynamic filter UIs without hard-coding the allowed values.
The Com API is a managed, monitored endpoint for properati.com.ar — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when properati.com.ar 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 properati.com.ar 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 property search interface filtering Argentine listings by neighborhood, property type, and sale vs. rental
- Track asking price trends across
ventalistings in specific locations over time usingpricefields fromsearch_listings - Generate property detail pages using
title,description,features, andsellerfromget_listing_detail - Power a recommendation widget by fetching up to 12 similar properties via
get_similar_listingsfor any viewed listing - Aggregate bedroom and bathroom distributions across Buenos Aires apartment listings for market analysis
- Validate or sync a filter UI dynamically by calling
get_property_typesandget_operation_typesat runtime - Monitor new listings in a target area by polling
search_listingswithsort=recienteand comparing against known IDs
| 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 Properati Argentina have an official developer API?+
What does `get_listing_detail` return that `search_listings` does not?+
search_listings returns summary fields: id, url, price_display, currency, price, location_display, and image_url. get_listing_detail adds title, seller (agency or contact name), a features array, and the full description text. You need the detail endpoint to get seller information or the property narrative.How does pagination work in `search_listings`?+
pagination object with current_page (integer) and has_next (boolean), plus a total_count integer for the full result set. Pass the page integer parameter to step through pages. There is no cursor or offset parameter — only page-number-based pagination is supported.Does the API cover listings from other Latin American countries on the Properati network?+
Are map coordinates or geo data returned for listings?+
search_listings response includes location_display as a formatted string, and get_listing_detail does not expose latitude/longitude fields. You can fork this API on Parse and revise it to add coordinate extraction if that endpoint exposes geo data.