--- title: "Goplaceit API: JSON data, 7 endpoints, 1 credit per call" description: "Goplaceit API for property search, listings, agencies, locations and currencies in Chile, Mexico and Colombia as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/goplaceit --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Goplaceit 1 credit per call 7 endpoints 15 datapoints # Goplaceit API Goplaceit API for property search, listings, agencies, locations and currencies in Chile, Mexico and Colombia as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below Goplaceit GET /v1/goplaceit/search?country=cl&mode=rent&property\_type=apartment®ion=13&bedrooms\_min=3&per\_page=20 ``` { "success": true, "total_results": 809, "returned": 20, "filtered_out_count": 0, "pagination": { "page": 1, "per_page": 20, "total_pages": 41, "has_next_page": true }, "applied_filters": { "country": "cl", "mode": "rent", "property_type": "apartment", "region": 13, "bedrooms_min": 3, "sort": "featured" }, "listings": [ { "id": 5890685, "entity_type": "property", "title": "Departamento en Arriendo en MIRADOR SANTA ANITA - 5 baños - 410 m2", "price": 12000, "currency": { "id": 7, "code": "USD", "symbol": "USD", "name": "Dolar Estadounidense", "iso_code": "USD" }, "mode": "rent", "type": "apartment", "type_label": "Departamento", "country": "cl", "commune": { "id": 289, "name": "Lo Barnechea" }, "bedrooms": 4, "bathrooms": 5, "area_m2": 410, "image": "https://goplaceit.s3.amazonaws.com/propiedades/chile/goldenpropiedades/2006a-220x220.jpg", "url": "https://www.goplaceit.com/cl/propiedad/arriendo/departamento/lo-barnechea/5890685-departamento-en-arriendo-en-mirador-santa-anita-5-banos-410-m2" }, { "id": 6989588, "entity_type": "property", "title": "Departamento en Arriendo en VICUÑA CIFUENTES - 2 baños - 140 m2", "price": 37, "currency": { "id": 2, "code": "UF", "symbol": "UF", "name": "Unidad de Fomento", "iso_code": "CLF" }, "mode": "rent", "type": "apartment", "type_label": "Departamento", "country": "cl", "commune": { "id": 297, "name": "Providencia" }, "bedrooms": 3, "bathrooms": 2, "area_m2": 140, "url": "https://www.goplaceit.com/cl/propiedad/arriendo/departamento/providencia/6989588-departamento-en-arriendo-en-vicuna-cifuentes-2-banos-140-m2" }, { "id": 7071669, "entity_type": "property", "title": "Arriendo Depto. 3D/2B + Est y Bod - San Miguel", "price": 500000, "currency": { "id": 1, "code": "CLP", "symbol": "$", "name": "Peso Chileno", "iso_code": "CLP" }, "mode": "rent", "type": "apartment", "type_label": "Departamento", "country": "cl", "commune": { "id": 304, "name": "San Miguel" }, "bedrooms": 3, "bathrooms": 2, "area_m2": 63, "image": "https://gpi-resized-img.s3.amazonaws.com/1/42192/7071669/220x220_uX7GqW-WhatsApp2BImage2B2023-07-162Bat2B7.49.342BPM2B252822529-desktop.jpg", "url": "https://www.goplaceit.com/cl/propiedad/arriendo/departamento/san-miguel/7071669-arriendo-depto-3d2b-est-y-bod-san-miguel" } ], "meta": { "endpoint_family": "search", "attempts": 1, "request_id": "req_76211e70cb81412fad130191a374e2f7", "credits_charged": 1, "credits_remaining": 1869 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | id integer | entity\_type string | title string | price integer | currency object | mode string | type string | type\_label string | country string | commune object | bedrooms integer | bathrooms integer | area\_m2 integer | image url | url url | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 5890685 | property | Departamento en Arriendo en MIRADOR SANTA ANITA - 5 baños - 410 m2 | 12000 | {5 fields} | rent | apartment | Departamento | cl | {2 fields} | 4 | 5 | 410 | https://goplaceit.s3.amazonaws.com/propiedades/chile/goldenpropiedades/2006a-220x220.jpg | https://www.goplaceit.com/cl/propiedad/arriendo/departamento/lo-barnechea/5890685-departamento-en-arriendo-en-mirador-santa-anita-5-banos-410-m2 | | 2 | 6989588 | property | Departamento en Arriendo en VICUÑA CIFUENTES - 2 baños - 140 m2 | 37 | {5 fields} | rent | apartment | Departamento | cl | {2 fields} | 3 | 2 | 140 | — | https://www.goplaceit.com/cl/propiedad/arriendo/departamento/providencia/6989588-departamento-en-arriendo-en-vicuna-cifuentes-2-banos-140-m2 | | 3 | 7071669 | property | Arriendo Depto. 3D/2B + Est y Bod - San Miguel | 500000 | {5 fields} | rent | apartment | Departamento | cl | {2 fields} | 3 | 2 | 63 | https://gpi-resized-img.s3.amazonaws.com/1/42192/7071669/220x220\_uX7GqW-WhatsApp2BImage2B2023-07-162Bat2B7.49.342BPM2B252822529-desktop.jpg | https://www.goplaceit.com/cl/propiedad/arriendo/departamento/san-miguel/7071669-arriendo-depto-3d2b-est-y-bod-san-miguel | Recorded from our API · 3 items shown · 15 datapoints per item GET /v1/goplaceit/search?country=cl&mode=rent&property\_type=apartment®ion=13&bedrooms\_min=3&per\_page=20 15 datapoints ### Identity - id integer - entity\_type string - title string - type string - type\_label string ### Contact - url url ### Location - country string - area\_m2 integer ### Reputation - image url ### Price - price integer - currency object ### Other - mode string - commune object - bedrooms integer - bathrooms integer Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/goplaceit/search?country=cl&mode=rent&property_type=apartment®ion=13&bedrooms_min=3&per_page=20" \ -H "X-API-Key: $API_KEY" ``` Goplaceit · 7 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/goplaceit/agency`](https://perceptlayer.com/apis/goplaceit/agency) | `id` | 1 credit | | [GET `/v1/goplaceit/agency-listings`](https://perceptlayer.com/apis/goplaceit/agency-listings) | `id` +2 optional | 1 credit | | [GET `/v1/goplaceit/currencies`](https://perceptlayer.com/apis/goplaceit/currencies) | none | 1 credit | | [GET `/v1/goplaceit/listing`](https://perceptlayer.com/apis/goplaceit/listing) | `id` +1 optional | 1 credit | | [GET `/v1/goplaceit/location-autocomplete`](https://perceptlayer.com/apis/goplaceit/location-autocomplete) | `q` `country` +2 optional | 1 credit | | [GET `/v1/goplaceit/locations`](https://perceptlayer.com/apis/goplaceit/locations) | none +5 optional | 1 credit | | [GET `/v1/goplaceit/search`](https://perceptlayer.com/apis/goplaceit/search) | `country` `mode` +17 optional | 1 credit | Overview ## About the Goplaceit API ## What you can get The Goplaceit API returns property data from Goplaceit for Chile, Mexico and Colombia as JSON through 7 endpoints. - **Search:** `search` takes a `country` (cl, mx or co) and a `mode` (buy or rent), with `property_type` (house, apartment, office, land, parking or storage), `entity_type` (property or project), `region`, `commune`, `neighborhood`, `bedrooms_min`, `bedrooms_max`, `bathrooms_min`, `bathrooms_max`, `area_min`, `area_max`, `price_min`, `price_max`, `currency` (CLP, UF, MXN, USD or COP), `sort` (featured, newest, oldest, price\_asc or price\_max), `page` and `per_page`. - **Listings:** `listing` takes an `id`, with `entity_type`. - **Agencies:** `agency` takes an `id`; `agency-listings` takes an `id`, with `page` and `per_page`. - **Locations:** `locations` takes a `country`, with `region`, `province`, `commune` and `children` (communes or provinces); `location-autocomplete` takes a `q` and a `country`, with `region` and `limit`. `currencies` takes no parameters. The recorded `search` for apartments to rent in region 13 of Chile with at least 3 bedrooms returns `listings`, each with `id`, `entity_type`, `title`, `price`, `currency`, `mode`, `type`, `country`, `commune`, `bedrooms`, `bathrooms`, `area_m2`, `image` and `url`. It also returns `total_results` (809), `returned`, `pagination` with `total_pages` and `has_next_page`, and `applied_filters`. ## How a call works Search a region: `GET /v1/goplaceit/search?country=cl&mode=rent&property_type=apartment®ion=13&bedrooms_min=3&per_page=20` with your key in the `X-API-Key` header. Each listing's `id` goes to `listing`. Page with `page` while `has_next_page` is true. Every successful call costs 1 credit; failed calls cost nothing. Real estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) Use cases ### Track rents and sale prices by commune in Chile `Use the Goplaceit API to track rents and sale prices by commune in Chile` ### Compare listings priced in CLP, UF and USD with \`currency\` `` Use the Goplaceit API to compare listings priced in CLP, UF and USD with `currency` `` ### Watch new-build projects with \`entity\_type=project\` `` Use the Goplaceit API to watch new-build projects with `entity_type=project` `` ### Pull an agency's full stock with \`agency-listings\` `` Use the Goplaceit API to pull an agency's full stock with `agency-listings` `` FAQ ## Questions **Do I need a Goplaceit account?** No. You call this Goplaceit API with your Perceptlayer key in the \`X-API-Key\` header, with no Goplaceit login. **How much does the Goplaceit API cost?** Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Which countries does it cover?** Set \`country\` to cl, mx or co for Chile, Mexico or Colombia. It's required on \`search\` and \`location-autocomplete\`. **Should I build a Goplaceit scraper instead?** You can, but a Goplaceit scraper is code you maintain: page changes break it, requests get blocked, and Goplaceit's terms govern how you collect data. The Goplaceit API gives you 7 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the Goplaceit API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)