search_properties

Find residential listings anywhere in Tamil Nadu by city, locality, price band, BHK, or transaction type — each result says what AVnester reviewed and its caveats.

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

Parameters

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

citystringoptional: City or town in Tamil Nadu. Omit to search every Tamil Nadu city; a place outside Tamil Nadu returns supported=false with a scopeMessage.
localitystringoptional: Locality / neighborhood within the city.
propertyTypestringoptional: apartment · villa · plot · independent_house.
bedroomsnumberoptional: Number of bedrooms (BHK), 1–10.
transactionTypestringoptional: sale · rent. Omit to include both.
rentalStructurestringoptional: monthly · lease (rent queries only).
furnishingstringoptional: furnished · semi-furnished · unfurnished (rent queries).
minPricenumberoptional: Lower bound in INR (paise not needed; integer rupees).
maxPricenumberoptional: Upper bound in INR.
limitnumberoptional: Page size, max 20 (default 10).

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",
       "locality": "Saravanampatti",
       "propertyType": "apartment",
       "bedrooms": 2,
       "limit": 5
     }'

Response

{
  "supported": true,
  "total": 12,
  "listings": [
    {
      "listingId": "lst_abc123",
      "title": "2 BHK apartment in Saravanampatti",
      "price": 6500000,
      "priceUnit": "INR",
      "listingType": "sale",
      "carpetAreaSqft": 1180,
      "pricePerSqft": 5508,
      "bhk": 2,
      "rank": 1,
      "sourceUrl": "https://avnester.com/listings/lst_abc123",
      "reraId": "TN/02/Building/0123/2024"
    }
  ],
  "sortBy": "featured_then_recent",
  "handoffUrl": "https://avnester.com/listings?city=Coimbatore",
  "attribution": "AVnester"
}

Run this example in the playground

Rate limits

OAuth (Developer)

30 / min

The same ceiling applies to every tool on a given plan, on both the MCP and REST transports; every plan’s is on Pricing. OAuth registration is free and self-serve. Calls made without signing in have their own per-IP limits — see the quickstart.

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. Signed in with OAuth, the per-tool limit is counted per user instead of per address; a paid plan raises it.
429Daily call limit reached (calls without signing in)
Retry-After counts to 00:00 UTC, and only calls that returned an answer count. Signed in, calls count against your plan instead of your IP address.
429Daily new-locality limit reached
Localities you have already queried today still work; Retry-After counts to 00:00 UTC. Signing in on the free plan does not lift this limit — a commercial licence does.

Next steps

→ Try search_properties in the playground (no signup)
→ Register an OAuth client (free on the Developer plan)
→ Browse the other 10 tools
→ Full schema in the OpenAPI spec