APIs / Real estate / Goplaceit

1 credit per call7 endpoints15 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.

Goplaceit
GET/v1/goplaceit/search?country=cl&mode=rent&property_type=apartment&region=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 OKJSONX-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.

#idintegerentity_typestringtitlestringpriceintegercurrencyobjectmodestringtypestringtype_labelstringcountrystringcommuneobjectbedroomsintegerbathroomsintegerarea_m2integerimageurlurlurl
15890685propertyDepartamento en Arriendo en MIRADOR SANTA ANITA - 5 baños - 410 m212000{5 fields}rentapartmentDepartamentocl{2 fields}45410https://goplaceit.s3.amazonaws.com/propiedades/chile/goldenpropiedades/2006a-220x220.jpghttps://www.goplaceit.com/cl/propiedad/arriendo/departamento/lo-barnechea/5890685-departamento-en-arriendo-en-mirador-santa-anita-5-banos-410-m2
26989588propertyDepartamento en Arriendo en VICUÑA CIFUENTES - 2 baños - 140 m237{5 fields}rentapartmentDepartamentocl{2 fields}32140—https://www.goplaceit.com/cl/propiedad/arriendo/departamento/providencia/6989588-departamento-en-arriendo-en-vicuna-cifuentes-2-banos-140-m2
37071669propertyArriendo Depto. 3D/2B + Est y Bod - San Miguel500000{5 fields}rentapartmentDepartamentocl{2 fields}3263https://gpi-resized-img.s3.amazonaws.com/1/42192/7071669/220x220_uX7GqW-WhatsApp2BImage2B2023-07-162Bat2B7.49.342BPM2B252822529-desktop.jpghttps://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 itemGET /v1/goplaceit/search?country=cl&mode=rent&property_type=apartment&region=13&bedrooms_min=3&per_page=20

15 datapoints

Identity

  • idinteger
  • entity_typestring
  • titlestring
  • typestring
  • type_labelstring

Contact

  • urlurl

Location

  • countrystring
  • area_m2integer

Reputation

  • imageurl

Price

  • priceinteger
  • currencyobject

Other

  • modestring
  • communeobject
  • bedroomsinteger
  • bathroomsinteger

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/goplaceit/search?country=cl&mode=rent&property_type=apartment&region=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.

EndpointRequired parametersCost
GET/v1/goplaceit/agency
id
1 credit
GET/v1/goplaceit/agency-listings
id+2 optional
1 credit
GET/v1/goplaceit/currencies
none
1 credit
GET/v1/goplaceit/listing
id+1 optional
1 credit
GET/v1/goplaceit/location-autocomplete
qcountry+2 optional
1 credit
GET/v1/goplaceit/locations
none+5 optional
1 credit
GET/v1/goplaceit/search
countrymode+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&region=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 estateJSONRESTMCP

More real estate APIs

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.