AVnesterDevelopers
← All tools

compare_properties

Side-by-side comparison of 2–4 listings on objective metrics (price per sqft, age, RERA, amenities).

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

Parameters

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

NameTypeRequiredDescription
listingIdsstring[]requiredBetween 2 and 4 listing IDs.

Worked example

# compare three apartments the user is weighing
curl -X POST https://api.avnester.com/public/v1/compare_properties \
  -H 'Content-Type: application/json' \
  -d '{
       "listingIds": ["lst_abc123", "lst_def456", "lst_ghi789"]
     }'
Response
{
  "supported": true,
  "comparison": {
    "metrics": ["pricePerSqft", "ageYears", "reraRegistered", "amenityScore"],
    "rows": [
      { "listingId": "lst_abc123", "pricePerSqft": 5508, "ageYears": 3, "reraRegistered": true, "amenityScore": 7 },
      { "listingId": "lst_def456", "pricePerSqft": 4900, "ageYears": 6, "reraRegistered": true, "amenityScore": 5 },
      { "listingId": "lst_ghi789", "pricePerSqft": 6100, "ageYears": 1, "reraRegistered": true, "amenityScore": 9 }
    ]
  },
  "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

  • 400Need 2–4 listingIds

    Provide between 2 and 4 listing IDs in listingIds[].

  • 429Rate limit exceeded

    Back off until the time in the Retry-After header; or authenticate with OAuth for the 10× tier.

Next steps