search_properties

Find verified residential listings in Coimbatore by locality, price band, BHK, or transaction type.

Endpoint POST https://api.avnester.com/public/v1/search_properties

Parameters

The most-used parameters. Full schema in the OpenAPI document.

Name	Type	Required	Description
city	string	required	City name — Coimbatore is the launch market.
localityName	string	optional	Locality / neighborhood within the city.
propertyType	string	optional	apartment · villa · plot · independent_house.
bhk	number	optional	Bedrooms (1, 2, 3, 4, 5+).
transactionType	string	optional	sale · rent. Defaults to sale.
minPrice	number	optional	Lower bound in INR (paise not needed; integer rupees).
maxPrice	number	optional	Upper bound in INR.
limit	number	optional	Page size, max 20.

Worked example

# search 2BHK apartments in Saravanampatti, Coimbatore

curl -X POST https://api.avnester.com/public/v1/search_properties \
  -H 'Content-Type: application/json' \
  -d '{
       "city": "Coimbatore",
       "localityName": "Saravanampatti",
       "propertyType": "apartment",
       "bhk": 2,
       "limit": 5
     }'

Response

{
  "supported": true,
  "total": 12,
  "listings": [
    {
      "listingId": "lst_abc123",
      "title": "2 BHK apartment in Saravanampatti",
      "price": 6500000,
      "areaSqft": 1180,
      "bhk": 2,
      "handoffUrl": "https://avnester.com/p/lst_abc123",
      "reraId": "TN/02/Building/0123/2024"
    }
  ],
  "attribution": "AVnester"
}

Rate limits

Anonymous

30/min

OAuth (Team)

300/min

Per-IP aggregate cap (across all tools): 60/min. OAuth registration lifts both the per-tool budget (10×) and removes the IP cap.

Common errors

400Invalid request body
Check required parameters and types. The error.message field will name the offending parameter.
200supported: false in body
Out-of-coverage queries are not HTTP errors — surface the scopeMessage from the response body to the user.
429Rate limit exceeded
Back off until the time in the Retry-After header; or authenticate with OAuth for the 10× tier.

Next steps

→ Try search_properties in the playground (no signup, anon tier)
→ Register an OAuth client (10× rate budget)
→ Browse the other 6 tools
→ Full schema in the OpenAPI spec