fincaraiz.com.co APIfincaraiz.com.co ↗
Access Colombian real estate listings, agency data, property details, and news from Fincaraiz via a structured REST API with 6 endpoints.
curl -X GET 'https://api.parse.bot/scraper/579881f5-2b1d-44d1-b93b-70924076950c/search_listings?page=1&location=bogota-dc&operation=venta&property_type=apartamentos' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for property listings with various filters. Returns a paginated list of listings from fincaraiz.com.co. Supports filtering by location, operation type, property type, price range, area range, and estrato.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| estrato | integer | Estrato level (1-6). |
| location | string | Location slug (e.g., 'bogota-dc', 'medellin', 'colombia'). |
| max_area | integer | Maximum area in m². |
| min_area | integer | Minimum area in m². |
| max_price | integer | Maximum price in COP. |
| min_price | integer | Minimum price in COP. |
| operation | string | Operation type: 'venta' or 'arriendo'. |
| 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 matching listings",
"params": "object containing parsed search parameters",
"listings": "array of property listing objects"
},
"sample": {
"data": {
"page": 1,
"total": 15000,
"params": {},
"listings": [
{
"id": 7926873,
"m2": 40.59,
"code": "7926873",
"price": {
"amount": 230607000,
"currency": {
"id": 4,
"name": "$"
}
},
"title": "SCALENO 17, Apartamento en Venta en Paloquemao, Bogotá",
"address": "Calle 16 No 21-68"
}
]
},
"status": "success"
}
}About the fincaraiz.com.co API
The Fincaraiz API provides access to Colombian real estate data across 6 endpoints, covering property search, full listing details, agency directories, and blog content. The search_listings endpoint accepts filters for location, operation type (sale or rental), price range, area, and estrato level, returning paginated results with total counts. Developers can retrieve individual listing details including technical sheets, images, and owner information via get_listing_detail.
Property Search and Filtering
The search_listings endpoint supports filtering by location (using slugs such as bogota-dc or medellin), operation (venta or arriendo), min_price/max_price in COP, min_area/max_area in m², and estrato level (1–6). Responses include a total count of matching listings and a listings array, plus a params object that reflects the parsed search parameters actually applied. Pagination is controlled via the page parameter.
Listing Detail and Code Lookup
get_listing_detail requires both a slug_or_url and a property_id (available from search_listings results) to return the full property record. The property object includes title, address, price, owner information, location data, facilities, and an image array. A technicalSheet array provides structured specification items, each with field, value, and text keys — useful for surface area, number of rooms, parking, and similar attributes. For direct lookup by listing code or internal ID, search_by_code accepts values like FRD90636 or 7926873 and returns the first matching listing with price (amount and currency), title, and address.
Agencies and Reference Data
list_inmobiliarias returns featured real estate agencies with their id, name, logo URL, and type. list_property_types provides a static reference list of property categories — each with an id, Spanish name, and slug — used to filter search_listings. Both endpoints take no parameters.
News and Blog Content
get_news_articles retrieves paginated WordPress blog posts from the Fincaraiz editorial feed. Each article includes an id, link, a title object with a rendered key, and a content object with the full HTML in its rendered key. Pagination uses the same page parameter pattern as listing search.
- Build a property search portal filtered by Colombian city slug, estrato, and price range in COP
- Aggregate full listing details including technical sheets and images for a real estate comparison tool
- Look up a specific Fincaraiz listing by its code to verify status and current price
- Populate a directory of Colombian real estate agencies using names, logos, and types from list_inmobiliarias
- Monitor Colombian real estate news and blog content for a market intelligence newsletter
- Generate filtered rental-only (arriendo) or sale-only (venta) property feeds by city
- Map property slugs to structured type filters using the list_property_types reference endpoint
| 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 | 250 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.