compare_localities

Compare 2–3 localities in one covered city on objective metrics — price, growth, livability, investment grade.

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

Parameters

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

citystringrequired: Indian city covering all compared localities.
localitiesstring[]required: 2–3 localities to compare (array, not comma-separated string).
propertyTypestringoptional: apartment · villa · plot · independent_house.

Worked example

# compare three Coimbatore localities

curl -X POST https://api.avnester.com/public/v1/compare_localities \
  -H 'Content-Type: application/json' \
  -d '{
       "city": "Coimbatore",
       "localities": ["Saravanampatti", "Ganapathy", "Singanallur"]
     }'

Response

{
  "supported": true,
  "comparison": {
    "Saravanampatti": {
      "pricePerSqftInr": 5400,
      "rent2bhkInr": 18500,
      "rentalYieldPct": 4.1,
      "priceGrowth1YPct": 12,
      "asOfMonth": "2026-09",
      "sourceCount": 2,
      "confidence": "medium",
      "livabilityScore": 78,
      "livabilityScoreBasis": "editorial-estimate",
      "investmentGrade": "A",
      "priceTrends": [{ "period": "2026-09", "avgPriceInr": 6750000 }],
      "strengthTags": ["it_proximity"],
      "watchouts": ["traffic peaks 8–10am"],
      "highlights": ["IT corridor"]
    },
    "Ganapathy": { "pricePerSqftInr": 4200, "asOfMonth": "2026-09", "confidence": "low" }
  },
  "disclaimer": "AVnester estimates; not professional investment advice.",
  "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

400Need 2–3 localities
Provide 2 or 3 locality names in localities[].
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 compare_localities 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