REAL ESTATE · COLOMBIA
Fincaraiz Colombia Property
Property listings search across Fincaraiz, a leading Colombian real-estate portal.
About this data
Property listings search across Fincaraiz, a leading Colombian real-estate portal. Structured records: price, area, rooms, address, images and listing URLs. Part of a multi-country real-estate scraper fleet.
From the actor’s Apify Store listing. The per-call endpoint may return a bounded subset; its own description is below.
Buy per call over x402
One endpoint at api.ssh.autos. Each call is one JSON POST, paid in USDC with no account or API key, and answered in the same HTTP response.
POST /v1/co/fincaraiz/listings
Live Fincaraiz apartment or house listings for a Colombian location (Bogota by default): price and currency, area in m2, bedrooms, bathrooms, address, city, region, coordinates, publisher, images and listing URL.
First results page only, up to 20 listings; the proxy is included in the price.
Input
Send a JSON body to POST https://api.ssh.autos/v1/co/fincaraiz/listings.
| Field | Type | Required | Notes |
|---|---|---|---|
location | string | optional | 1–120 characters; default "bogota" |
operation | string | optional | one of venta, arriendo; default "venta" |
propertyType | string | optional | one of apartamento, casa; default "apartamento" |
maxResults | integer | optional | 1–20; default 10 |
Returned fields
The answer is JSON: records, a list of up to 20, and summary, the run status and counts. Each record has these 27 fields; a field the source does not publish comes back null.
27 fields per record
| Field | Type | Notes |
|---|---|---|
id | string | Fincaraiz numeric listing id; not guaranteed unique when datasets are merged, prefer listingKey. |
listingKey | string | Composite unique key: source:id (e.g. fincaraiz.com.co:6792017). |
url | string | Canonical listing URL (https://www.fincaraiz.com.co/{slug}/{numericId}). |
name | string | Listing title from the search payload. |
price | number | Advertised price amount as listed; null for hidden prices (hidePrice). |
currency | string | ISO currency of the advertised price: COP (price.currency id 4 or bare '$' on this site), USD ('U$S' marker). Null when the price is hidden. |
priceUsd | number | Site-computed USD equivalent (price_amount_usd) when present. |
propertyType | string | Property type as named by the site (Apartamento, Casa, ...). |
areaM2 | number | Area in m²: built surface (m2Built) first, then terrain (m2Terrain), then m2. |
rooms | integer | Effective rooms: bedrooms (the site's own rooms field is usually 0/unreliable). |
bedrooms | integer | Habitaciones; 0 is reported as null. |
bathrooms | integer | Baños from the listing payload. |
parkings | integer | Garage/parking spots (garage); null when the listing reports none. |
address | string | Street address when shown plus locality (Suba, Chapinero, ...) via location_main; the '[PLACEHOLDER]' literal and empty strings are null. |
location | string | Principal location name (locations.location_main.name). |
city | string | City from the locations nesting (locations.city[0].name), e.g. Bogotá. |
region | string | Region/department from the locations nesting (locations.state[0].name), e.g. Bogotá, d.c.. |
latitude | number | Listing latitude. |
longitude | number | Listing longitude. |
operation | string | Requested operation: 'venta' or 'arriendo'. |
publisher | string | Publisher (owner.name — inmobiliaria, desarrollador or particular). |
postedAt | string | Listing creation date as ISO YYYY-MM-DD from the payload's created_at. |
images | array of strings | Listing gallery image URLs from the search payload (fragments like '#HASTH' stripped). |
imageUrl | string | Primary listing image URL (the payload's img field, fragment stripped; falls back to the first gallery image). |
source | string | Source website hostname (fincaraiz.com.co). |
country | string | Site country: CO. |
scrapedAt | string | UTC ISO-8601 scrape timestamp. |
Example call
npx agentcash@latest fetch https://api.ssh.autos/v1/co/fincaraiz/listings -m POST -b '{"location": "bogota", "maxResults": 3}'The example values come from the API spec or the actor’s own sample input. Running it is a paid call.
What is and isn’t charged
You pay the call price for
- An answer, including a definitive “not found” or an empty result.
- Confirmed no matches returns records: [] (charged: it is an answer).
Free
- Invalid input (422), busy (503), source failure (502), timeout (504) and calls whose client hung up are never charged.
- Invalid input and source failures are not charged.
Prefer a subscription? Run it on Apify
This data source is a public actor on the Apify Store: Fincaraiz Colombia Property Scraper. Run it with your Apify account and plan for larger, scheduled or exported runs; it may offer more input options than the per-call endpoint.
How x402 payment works
- Your client sends the request. The API answers
402 Payment Requiredwith the price and where to pay. - The client pays from its own wallet: USDC on Base or Solana over x402, or over MPP on Tempo. No account, sign-up or API key.
- The client retries with the payment attached and gets the JSON answer in the same call. You are only charged for answers.
The AgentCash CLI in the example does all three steps for you and pays from your AgentCash wallet. Any x402 or MPP client works the same way.
Machine-readable: openapi.json · llms.txt