---
title: "Goplaceit API: Search | Perceptlayer"
description: "Search from Goplaceit as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/goplaceit/search
---

[APIs](https://perceptlayer.com/apis) / [Goplaceit](https://perceptlayer.com/apis/goplaceit) / Search

# Goplaceit: Search

Search from Goplaceit as JSON. 1 credit per successful call.

GET `/v1/goplaceit/search`

## Parameters

Send parameters in the query string.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `country` | string | Required | cl, mx, co |
| `mode` | string | Required | buy, rent |
| `property_type` | string | Optional | house, apartment, office, land, parking, storage |
| `entity_type` | string | Optional | property, project |
| `region` | integer | Optional | Any |
| `commune` | integer | Optional | Any |
| `neighborhood` | integer | Optional | Any |
| `bedrooms_min` | integer | Optional | Any |
| `bedrooms_max` | integer | Optional | Any |
| `bathrooms_min` | integer | Optional | Any |
| `bathrooms_max` | integer | Optional | Any |
| `area_min` | number | Optional | Any |
| `area_max` | number | Optional | Any |
| `price_min` | number | Optional | Any |
| `price_max` | number | Optional | Any |
| `currency` | string | Optional | CLP, UF, MXN, USD, COP |
| `sort` | string | Optional | featured, newest, oldest, price\_asc, price\_max |
| `page` | integer | Optional | Any |
| `per_page` | integer | Optional | Any |

## Example request

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 OK JSON X-Credits-Used: 1

Recorded from our API and shortened.

[Run this endpoint in the playground](https://perceptlayer.com/apis/goplaceit?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.