Skip to main content
POST
/
api
/
magicbricks
/
properties
/
search
/magicbricks/properties/search
curl --request POST \
  --url https://api.anysite.io/api/magicbricks/properties/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "city": "<string>",
  "count": 2,
  "timeout": 300,
  "listing_type": "buy",
  "proptype": [],
  "bedrooms": [
    123
  ],
  "budget_min": 1,
  "budget_max": 1,
  "area_min": 1,
  "area_max": 1,
  "area_unit": "Sq-ft",
  "posted_since": 2,
  "gated_community": true,
  "corner_property": true,
  "sort": "Relevance"
}
'
[
  {
    "id": "<string>",
    "url": "<string>",
    "@type": "@magicbricks_search_property",
    "title": "<string>",
    "name": "<string>",
    "description": "<string>",
    "property_type": "<string>",
    "transaction_type": "<string>",
    "listing_for": "<string>",
    "possession_status": "<string>",
    "posted_at": "<string>",
    "price": 123,
    "price_text": "<string>",
    "price_per_sqft": 123,
    "currency": "<string>",
    "area_sqft": 123,
    "area_unit": "<string>",
    "bedroom_count": 123,
    "bathroom_count": 123,
    "balcony_count": 123,
    "furnishing": "<string>",
    "city": "<string>",
    "locality": "<string>",
    "latitude": 123,
    "longitude": 123,
    "rera_id": "<string>",
    "is_verified": true,
    "posted_by": "<string>",
    "builder_name": "<string>",
    "project_name": "<string>",
    "project_url": "<string>",
    "amenities": [],
    "landmarks": [],
    "image": "<string>",
    "image_count": 123,
    "dealer_name": "<string>",
    "dealer_company": "<string>"
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
city
string
required

City to search in, e.g. 'Bangalore', 'Mumbai', 'Pune'

Minimum string length: 1
count
integer
required

Max number of results to return

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
listing_type
enum<string>
default:buy

Whether to search properties for sale or rent

Available options:
buy,
rent
proptype
enum<string>[] | null

Filter by property type(s)

Available options:
Apartment,
Independent-House,
Villa,
Plot,
Farm-House,
Agricultural-Land
bedrooms
integer[] | null

Filter by number of bedrooms (BHK), 1-6

budget_min
integer | null

Minimum price in INR

Required range: x >= 0
budget_max
integer | null

Maximum price in INR

Required range: x >= 0
area_min
integer | null

Minimum covered area

Required range: x >= 0
area_max
integer | null

Maximum covered area

Required range: x >= 0
area_unit
enum<string>
default:Sq-ft

Unit for area_min/area_max

Available options:
Sq-ft,
Sq-m,
Sq-yrd
posted_since
integer | null

Only listings posted within this many days (e.g. 1, 7, 15, 30)

Required range: x >= 1
gated_community
boolean | null

Only properties in a gated community

corner_property
boolean | null

Only corner properties

sort
enum<string>
default:Relevance

Result ordering

Available options:
Relevance,
Price-Low-to-High,
Price-High-to-Low,
Most-Recent,
Rate-per-sqft-Low-to-High,
Rate-per-sqft-High-to-Low

Response

Successful Response

id
string
required
url
string
required
@type
string
default:@magicbricks_search_property
title
string | null
name
string | null
description
string | null
property_type
string | null
transaction_type
string | null
listing_for
string | null
possession_status
string | null
posted_at
string | null
price
number | null
price_text
string | null
price_per_sqft
number | null
currency
string | null
area_sqft
number | null
area_unit
string | null
bedroom_count
integer | null
bathroom_count
integer | null
balcony_count
integer | null
furnishing
string | null
city
string | null
locality
string | null
latitude
number | null
longitude
number | null
rera_id
string | null
is_verified
boolean | null
posted_by
string | null
builder_name
string | null
project_name
string | null
project_url
string | null
amenities
string[]
landmarks
string[]
image
string | null
image_count
integer | null
dealer_name
string | null
dealer_company
string | null