Com APIfincaraiz.com.co ↗
Access Colombia's largest property portal via API. Search listings, retrieve agency profiles, and fetch real estate news from fincaraiz.com.co.
What is the Com API?
The Fincaraiz API exposes 6 endpoints covering property listings, agency directories, and real estate news from Colombia's largest property portal. The search_listings endpoint accepts filters for location, operation type, estrato level, price range, and area in m², returning paginated results with full listing details including price in COP, owner info, images, and technical specifications. A dedicated get_listing_detail endpoint retrieves the complete data for a single property by slug and ID.
curl -X GET 'https://api.parse.bot/scraper/579881f5-2b1d-44d1-b93b-70924076950c/search_listings?page=1&estrato=1&bedrooms=3&location=colombia&operation=venta&property_type=finca-raiz' \ -H 'X-API-Key: $PARSE_API_KEY'
Search property listings on fincaraiz.com.co. One page request per call, 21 listings per page ordered by the site's relevance ('Popularidad'); use page to continue while has_more is true. Location can be narrowed three ways that combine freely: the location city/region slug, an optional neighborhood (barrio) inside that location, and an optional free-text search_text that the site matches against listing text such as street addresses, sector names or project names (e.g. 'calle 100' is one shape). An unknown neighborhood is rejected with stale_input (input_not_found) rather than silently returning the unfiltered city results. Filters for operation, property type, price range (COP), built area (m²), estrato and exact bedroom count are applied by the site; params echoes the filters the site resolved, so callers can confirm what was applied. Each listing carries the full site record: id, code, title, address, price (with currency), owner, locations, images, facilities, m2, bedrooms, bathrooms, stratum and technicalSheet. total is the site's count of all matching listings, not the page size.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-based); 21 listings per page. |
| estrato | integer | Socio-economic estrato level (1-6). |
| bedrooms | integer | Exact number of bedrooms (1, 2, 3, 4 ...). Values of 5 or more are grouped by the site as '5 or more'. |
| location | string | Location slug (e.g., 'bogota-dc', 'medellin', 'colombia'). A neighborhood, if given, is resolved inside this location. |
| max_area | integer | Maximum built area in m². |
| min_area | integer | Minimum built area in m². |
| max_price | integer | Maximum price in COP. |
| min_price | integer | Minimum price in COP. |
| operation | string | Operation type. |
| search_text | string | Free-text keyword filter matched by the site against listing text (street address such as 'carrera 43', sector, project or building name). Combines with location and neighborhood. Whitespace-only values are ignored. |
| neighborhood | string | Neighborhood (barrio) name or slug inside the chosen location, e.g. 'Chapinero' or 'El Poblado'. Accents, case and spaces are normalized ('El Poblado' and 'el-poblado' are equivalent). When the site does not recognize the barrio for that location the call returns stale_input (input_not_found) instead of the unfiltered results. |
| property_type | string | Property type slug (e.g., 'apartamentos', 'casas', 'finca-raiz'). Use list_property_types endpoint to get available slugs. |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"total": "integer, total number of listings matching the filters across all pages (from the site's paginator)",
"params": "object with the filters the site resolved for this request (filters.locations.value includes the resolved NEIGHBOURHOOD entry when neighborhood was given; filters.searchstring echoes search_text)",
"has_more": "boolean, true when a later page exists",
"listings": "array of property listing objects with full details (id, code, title, address, price, owner, locations, images, facilities, m2, bedrooms, bathrooms, stratum, technicalSheet, link)"
},
"sample": {
"data": {
"page": 1,
"total": 1868,
"params": {
"filters": {
"order": {
"text": "Popularidad",
"value": 2
},
"locations": {
"text": "",
"value": [
{
"id": "8b5e0d3c-fafa-457d-aba7-2a4f210ebb57",
"city": [
{
"id": "65d441f3-a239-4111-bc5b-01c5a268869f",
"name": "Bogotá",
"slug": "city-colombia-11-001"
}
],
"name": "Chapinero",
"slug": [
"neighbourhood-bogota-11-chapinero"
],
"type": "NEIGHBOURHOOD",
"estate": {
"id": "2d9f0ad9-8b72-4364-a7dc-e161d7dddb4d",
"name": "Bogotá, d.c.",
"slug": "state-colombia-11-bogota-dc"
}
}
]
},
"country_id": 3,
"property_type_id": [
{
"text": "Apartamentos",
"value": 2
}
],
"operation_type_id": {
"text": "Venta",
"value": 1
}
}
},
"has_more": true,
"listings": [
{
"id": 192779328,
"m2": 96,
"img": "https://cdn2.infocasas.com.uy/repo/img/68a7a9d4cc52e_infocdn__ixqsmpbysrwyvk88j6us3bzsna9tdhoj9jucmeqijpg.jpg",
"code": "FRPV60687",
"link": "/apartamento-en-venta-en-chapinero-bogota/192779328",
"floor": 5,
"owner": {
"id": 174636746,
"name": "CMG SERVICIOS INMOBILIARIOS E.U.",
"type": "inmobiliaria",
"has_whatsapp": true,
"inmoPropsLink": "/inmobiliarias/174636746-cmg servicios inmobiliarios e.u./propiedades"
},
"price": {
"amount": 630000000,
"currency": {
"id": 4,
"name": "$",
"rate": 3106.44
},
"hidePrice": false,
"admin_included": 630998000
},
"title": "Apartamento en Venta en Chapinero, Bogotá",
"garage": 1,
"images": [
{
"id": 241550490,
"tag": null,
"image": "https://cdn2.infocasas.com.uy/repo/img/68a7a9d4cc52e_infocdn__ixqsmpbysrwyvk88j6us3bzsna9tdhoj9jucmeqijpg.jpg"
}
],
"typeID": 2,
"address": "Calle 64 #4-74, Bogotá, Colombia",
"m2Built": null,
"stratum": 4,
"bedrooms": 2,
"latitude": 4.6478612,
"bathrooms": 3,
"isProject": false,
"locations": {
"city": [
{
"id": "65d441f3-a239-4111-bc5b-01c5a268869f",
"name": "Bogotá"
}
],
"location_main": {
"id": "8b5e0d3c-fafa-457d-aba7-2a4f210ebb57",
"name": "Chapinero",
"location_type": "neighbourhood"
},
"neighbourhood": [
{
"id": "8b5e0d3c-fafa-457d-aba7-2a4f210ebb57",
"name": "Chapinero"
}
],
"location_point": "POINT (-74.0582022 4.6478612)"
},
"longitude": -74.0582022,
"country_id": 3,
"created_at": "2025-08-21",
"facilities": [
{
"id": 243,
"name": "Ascensor",
"group": "Exterior"
}
],
"updated_at": "2026-08-04",
"description": "Descubra este excepcional apartamento dúplex...",
"image_count": 21,
"showAddress": true,
"idFincaLegacy": null,
"property_type": {
"id": 2,
"name": "Apartamento"
},
"operation_type": {
"id": 1,
"name": "Venta"
},
"technicalSheet": [
{
"text": "Tipo de Inmueble",
"field": "property_type_name",
"value": "Apartamento"
}
],
"price_amount_usd": 202804
}
]
},
"status": "success"
}
}About the Com API
Search and Filter Listings
The search_listings endpoint is the primary entry point for querying the Fincaraiz catalog. Key parameters include location (a slug such as bogota-dc or medellin), operation (e.g., sale or rent), estrato (1–6, reflecting Colombia's socioeconomic zoning system), and price bounds via min_price / max_price in COP. Area filtering uses min_area and max_area in m². Responses include a total count of matching listings alongside a paginated listings array, where each object carries price, address, owner details, image URLs, and facility data.
Individual Listing Details
Call get_listing_detail with both a slug_or_url and a property_id — both values are available from search_listings results — to retrieve the full property record. The response surfaces a property object (title, address, price, owner, locations, images, facilities) and a technicalSheet array of key-value pairs covering specifications like built area, number of rooms, parking, and property age. The search_by_code endpoint provides an alternative lookup path using a listing's numeric code, returning core fields including price, title, and address.
Reference and Supporting Endpoints
list_property_types returns the full set of type slugs and display names used in search_listings filters — useful for building a dynamic filter UI without hardcoding values. list_inmobiliarias returns featured agency profiles including name, type, logo, and description, which can populate an agency directory or support lead-routing workflows. get_news_articles pulls from the Fincaraiz WordPress blog, delivering paginated posts (10 per page) with full HTML content, date, author, and category data.
The Com API is a managed, monitored endpoint for fincaraiz.com.co — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when fincaraiz.com.co 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 fincaraiz.com.co 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-city rental comparison tool filtering by estrato, price range, and area across Bogotá, Medellín, and Cali.
- Aggregate property listings for a Colombia-focused real estate CRM, syncing owner contact info and images via
get_listing_detail. - Display a live agency directory by consuming
list_inmobiliariasto surface agency logos, descriptions, and contact details. - Implement a listing lookup widget using
search_by_codeso users can paste a Fincaraiz code and immediately see price and address. - Monitor new listings in a specific neighborhood by polling
search_listingswith a fixedlocationslug and tracking changes intotal. - Power a real estate content feed by paginating
get_news_articlesand republishing blog posts with author and category metadata. - Populate a property search filter menu dynamically using
list_property_typesto keep type slugs in sync with the source catalog.
| 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 Fincaraiz have an official public developer API?+
What does the `technicalSheet` field in `get_listing_detail` contain?+
field, value, and text keys. These represent structured property specifications such as built area, number of rooms, bathrooms, parking spaces, and property age — the same data shown in the listing's technical breakdown on the site.Does `search_listings` support filtering by property type (apartment, house, office, etc.)?+
search_listings inputs do not include a property_type parameter in the current spec, though list_property_types returns the available type slugs. You can fork this API on Parse and revise it to wire the property_type filter into search_listings.Does the API cover new construction projects (proyectos nuevos) or only existing listings?+
Is there a limit to how many listings `search_listings` returns per page, and can I retrieve a specific page?+
page parameter controls which page is returned. The total field in the response gives the overall match count so you can calculate how many pages exist. The number of listings per page is determined by the source and is not a configurable parameter in the current endpoint.