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

[APIs](https://perceptlayer.com/apis) / [Square Yards](https://perceptlayer.com/apis/square-yards) / Search

# Square Yards: Search

Search from Square Yards as JSON. 1 credit per successful call.

GET `/v1/square-yards/search`

## Parameters

Send parameters in the query string.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `city` | string | Required | Up to 60 characters |
| `category` | string | Optional | buy, rent |
| `bedrooms` | string | Optional | Up to 12 characters |
| `property_type` | string | Optional | Up to 40 characters |
| `locality` | integer | Optional | Any |
| `min_price` | integer | Optional | Any |
| `max_price` | integer | Optional | Any |
| `min_area` | integer | Optional | Any |
| `max_area` | integer | Optional | Any |
| `sort` | string | Optional | price\_asc, price\_desc |
| `page` | integer | Optional | Any |

## Example request

Square Yards

GET /v1/square-yards/search?city=Mumbai&category=buy&bedrooms=2&min\_price=10000000&max\_price=20000000&sort=price\_asc 

```
{
  "success": true,
  "data": {
    "items": [
      {
        "id": 8992103,
        "url": "https://www.squareyards.com/resale-2-bhk-pooja-room-servant-room-study-room-750-sq-ft-apartment-in-maitri-chs/8992103",
        "title": "2 BHK + Pooja Room,Servant Room,Study Room Apartment For Sale in Maitri CHS",
        "listing_type": "sale",
        "project_name": "Maitri CHS",
        "price": 10000000,
        "price_display": "₹ 1 Cr",
        "currency": "INR",
        "unit_type": "2 BHK",
        "bedrooms": 2,
        "bathrooms": 2,
        "area": 750,
        "area_unit": "sqft",
        "property_type": "Apartment",
        "facing": "East",
        "floor": "101th of 13 Floors",
        "parking": "1 Open Parking",
        "city": "Mumbai",
        "locality": "Ghatkopar West",
        "locality_id": 65227,
        "latitude": 19.096718,
        "longitude": 72.913845,
        "image": "https://img.squareyards.com/secondaryPortal/IN_638890390774772441-2507251117571757.jpg",
        "images": [
          "https://img.squareyards.com/secondaryPortal/IN_638890390774772441-2507251117571757.jpg",
          "https://img.squareyards.com/secondaryPortal/IN_638890390783570583-2507251117581758.jpg",
          "https://img.squareyards.com/secondaryPortal/IN_638890390776689121-2507251117571757.jpg"
        ],
        "highlights": [
          "Breakthrough Price",
          "Reputed Builder",
          "Gated Society"
        ],
        "agent": {
          "id": 561806,
          "name": "UMESH G BHAT",
          "type": "CP",
          "experience_years": 5,
          "premium": false,
          "location": "Thane",
          "slug": "umesh-bhat"
        }
      },
      {
        "id": 9133513,
        "url": "https://www.squareyards.com/resale-2-bhk-490-sq-ft-apartment-in-dgs-sheetal-sahyog/9133513",
        "title": "2 BHK Apartment For Sale in DGS Sheetal Sahyog",
        "listing_type": "sale",
        "project_name": "DGS Sheetal Sahyog",
        "price": 10000000,
        "price_display": "₹ 1 Cr",
        "currency": "INR",
        "unit_type": "2 BHK",
        "bedrooms": 2,
        "bathrooms": 2,
        "area": 490,
        "area_unit": "sqft",
        "property_type": "Apartment",
        "status": "Under Construction",
        "possession_status": "Under Construction",
        "furnishing": "Unfurnished",
        "facing": "East",
        "floor": "20th of 40 Floors",
        "city": "Mumbai",
        "locality": "Malad East",
        "locality_id": 65169,
        "latitude": 19.185951,
        "longitude": 72.8633,
        "image": "https://img.squareyards.com/secondaryPortal/IN_638924389002578735-0209250741404140.jpg",
        "images": [
          "https://img.squareyards.com/secondaryPortal/IN_638924389002578735-0209250741404140.jpg",
          "https://img.squareyards.com/secondaryPortal/IN_638924389006938044-0209250741404140.jpg",
          "https://img.squareyards.com/secondaryPortal/IN_638924388994610388-0209250741394139.jpg"
        ],
        "highlights": [
          "Vastu compliant",
          "Safe & Secure Locality",
          "Affordable"
        ],
        "agent": {
          "id": 477234,
          "name": "MANOJKUMAR JADHAV",
          "type": "CP",
          "rating": 5,
          "experience_years": 5,
          "premium": false,
          "location": "Mumbai",
          "image": "https://img.squareyards.com/connect/profilepic/919152735508638537264841442680.jpg",
          "slug": "manoj-jadhav"
        }
      },
      {
        "id": 9155465,
        "url": "https://www.squareyards.com/resale-2-bhk-635-sq-ft-apartment-in-jay-anand-chs/9155465",
        "title": "2 BHK Apartment For Sale in Jay Anand CHS",
        "listing_type": "sale",
        "project_name": "Jay Anand CHS",
        "price": 10000000,
        "price_display": "₹ 1 Cr",
        "currency": "INR",
        "unit_type": "2 BHK",
        "bedrooms": 2,
        "bathrooms": 2,
        "area": 635,
        "area_unit": "sqft",
        "property_type": "Apartment",
        "status": "Ready To Move",
        "possession_status": "Ready To Move",
        "furnishing": "Unfurnished",
        "parking": "1 Covered + 1 Open",
        "city": "Mumbai",
        "locality": "Chunabhatti",
        "locality_id": 863,
        "latitude": 19.051476,
        "longitude": 72.872055,
        "image": "https://img.squareyards.com/secondaryPortal/IN_638928931034156428-0809250151435143.jpg",
        "highlights": [
          "Near City Center",
          "Breakthrough Price",
          "Vastu compliant"
        ],
        "agent": {
          "id": 599783,
          "name": "kawleen singh",
          "type": "CP",
          "premium": false,
          "location": "Mumbai",
          "slug": "kawleen-singh"
        }
      }
    ],
    "page": 1,
    "per_page": 25,
    "total": 8056,
    "has_more": true
  },
  "meta": {
    "endpoint_family": "search",
    "request_id": "req_4b3daa27a9aa427f9b75923b99fd8237",
    "credits_charged": 1,
    "credits_remaining": 1809
  }
}
```

200 OK JSON X-Credits-Used: 1

Recorded from our API and shortened.

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