AVnester Public API
The public API from AVnester — 1 operation(s) for public.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/avnester-com:avnester-com-public-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: AVnester Public API
description: 'Public real-estate intelligence for India: listing discovery, locality insights, and deterministic financial calculators. Calls without signing in are permitted at their own per-IP limits. OAuth, or an application''s server API key, counts limits per user or per application instead, with no limit across tools or on uncached queries; a paid plan raises them. Tool results include disclaimers — not financial/legal advice.'
version: 1.0.0
contact:
email: connector-support@avnester.com
servers:
- url: https://api.avnester.com
description: Production
tags:
- name: Public
paths:
/public/v1/search_properties:
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
total:
type: integer
minimum: 0
description: Listings matching the filters.
listings:
type: array
items:
type: object
properties:
listingId:
type: string
title:
type: string
maxLength: 120
summary:
type: string
maxLength: 280
city:
type: string
locality:
type: string
bhk:
type:
- integer
- 'null'
bathrooms:
type:
- integer
- 'null'
carpetAreaSqft:
type:
- number
- 'null'
price:
type: integer
priceUnit:
enum:
- INR
listingType:
type: string
enum:
- sale
- rent
rentalStructure:
type:
- string
- 'null'
enum:
- monthly
- lease
- null
leaseAmount:
type:
- number
- 'null'
leaseTenureMonths:
type:
- integer
- 'null'
leaseRefundable:
type:
- boolean
- 'null'
furnishingStatus:
type:
- string
- 'null'
enum:
- furnished
- semi-furnished
- unfurnished
- null
parkingCount:
type:
- integer
- 'null'
post:
operationId: search_properties
summary: Search India property listings
description: Search residential property listings anywhere in Tamil Nadu, India — any city or town. Use when the user names a place, locality, price band, BHK, or transaction type. Returns sanitized listing cards with handoff URLs and a per-listing verification summary (verified + caveats); never returns seller contact details. Places outside Tamil Nadu return supported=false + scopeMessage — surface it.
x-openai-isConsequential: false
x-mcp-annotations:
title: Search India property listings
readOnlyHint: true
destructiveHint: false
idempotentHint: true
openWorldHint: true
tags:
- Public
security:
- {}
- oauth2:
- listings:read:public
- serverKey: []
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
city:
type: string
minLength: 1
maxLength: 60
format: regex
description: City or town in Tamil Nadu (e.g., "Coimbatore", "Madurai"). Omit to search every Tamil Nadu city.
locality:
type: string
minLength: 1
maxLength: 80
format: regex
description: Locality/neighborhood within the city (e.g., "Saravanampatti").
propertyType:
type: string
enum:
- apartment
- villa
- plot
- independent_house
description: Property type.
bedrooms:
type: integer
minimum: 1
maximum: 10
description: Number of bedrooms (BHK).
minPrice:
type: integer
minimum: 0
description: Minimum price in INR.
maxPrice:
type: integer
minimum: 0
description: Maximum price in INR.
transactionType:
type: string
enum:
- sale
- rent
description: Whether to search for sale or rent. Omit to include both.
rentalStructure:
type: string
enum:
- monthly
- lease
description: 'Rental money structure: monthly rent, or a lump-sum lease (one refundable amount for a fixed tenure, no monthly rent). Only meaningful with transactionType=rent. Omit to include both.'
furnishing:
type: string
enum:
- furnished
- semi-furnished
- unfurnished
description: Furnishing status (rental queries).
limit:
type: integer
minimum: 1
maximum: 20
default: 10
description: 'Maximum number of listings to return (cap: 20). v1 abuse defense.'
additionalProperties: false
components:
securitySchemes:
oauth2:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://auth.avnester.com/oauth/authorize
tokenUrl: https://auth.avnester.com/oauth/token
refreshUrl: https://auth.avnester.com/oauth/token
scopes:
calculators:use: Use deterministic real-estate calculators.
listings:read:public: Read public real-estate listing data.
locality:read:public: Read public locality insights and comparisons.
serverKey:
type: http
scheme: bearer
bearerFormat: avn_live_…
description: 'A server API key for one application (Business, Scale or Enterprise plan), created in the developer console and sent as `Authorization: Bearer avn_live_…` from a server. Its calls count against the application''s allowance. It cannot call /a2a. Licensed cities under a data contract reach a server key only when the contract allows server access and the key holds locality:read:public; an IP allowlist, when the key has one, admits only those addresses. The server credentials page of the developer docs explains it.'