Divar Real Estate Listings API
Live Divar real-estate listings from Divar's structured HTTP post-list service. Start with /v1/cities using a Persian or Latin substring; pass its returned slug or numeric id unchanged to the city listing route. The city route covers the source's mixed real-estate feed (sale, rent and other real-estate categories) for one source-resolved city. The sale route is a Tehran-only residential-sale feed. Start a request without a cursor, then pass next_cursor back unchanged to continue quickly; the legacy numeric page input is retained only for the first few pages and is deprecated for deep traversal. Prices are displayed Persian text in toman (sale total or rent/deposit labels), and area is null when Divar omits it. Unknown city slugs return an actionable 404 rather than silently broadening to Iran.
Endpoint health
Loading verification…
Connect your agent
Connect through MCP so your agent can find this API, read its docs, and call its endpoints.
Add the server from your terminal.
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcpIn Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.
Then ask your agent to use the Divar Real Estate Listings API for your task.
Call it over HTTP
Get an API keySign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/5392b2dc-fc1a-4ca5-8703-f031d37f2627/v1/buy-home-listings' \
--header "Authorization: Bearer $AGENT_DATA_API_KEY"Endpoints
Inputs and response fields for every endpoint in this API.
GETBuy home listings/v1/buy-home-listings
Return a live Tehran residential-sale page with cursor continuation.
Input
pageOptionalQuery · integer, min: 0, default: 0Deprecated zero-based page for the first few pages only. Prefer next_cursor for sale-feed continuation; values above 3 are rejected quickly.
Example: 0
cursorOptionalQuery · string | nullSource-derived cursor example below may expire; cursors are opaque and callers should use the current next_cursor unchanged for subsequent Tehran sale pages.
Response
itemsobject[]items[].citystringitems[].pricestring | nullitems[].titlestringitems[].tokenstringitems[].area_m2integer | nullitems[].categorystring | nullitems[].districtstring | nullitems[].listing_urlstringitems[].source_typestring | nullhas_morebooleannext_pageinteger | nulltransportstringnext_cursorstring | nullFor the next page, pass next_cursor from the response as cursor. Leave it empty on the first call.
GETCities/v1/cities
Resolve familiar location text to source IDs and route values.
Input
queryOptionalQuery · string | nullOptional substring in a Persian city name, accepted Latin slug, or province. Omit it to return Divar's complete anonymous city catalog.
Example: تهران
Response
countintegeritemsobject[]items[].idstringitems[].namestringitems[].slugstring | nullitems[].provincestring | nullquerystring | nulltransportstringGETListings by token/v1/listings/{token}
Fetch one public listing detail page on caller request. Search deliberately does not call this endpoint for each result. This keeps collection retrieval bounded and lets callers choose which listing needs the richer public description, area, coordinates, and image URLs.
Input
tokenRequiredPath · stringThe final token segment of a listing_url returned by a search result. Do not use a display title or list position.
Example: gaVT9lXU
Response
citystring | nullroomsstring | nulltitlestringtokenstringimagesstring[]addressstring | nullarea_m2number | nullcategorystring | nulldistrictstring | nulllatitudenumber | nulllongitudenumber | nulltransportstringdescriptionstring | nulllisting_urlstringGETReal estate listings/v1/real-estate-listings/{city_slug}
Fetch one live source search page; never reads saved HTML or test fixtures.
Input
city_slugRequiredPath · stringA value returned by /v1/cities: an accepted Latin slug, the source Persian city name, or a source city id. Examples include tehran, تهران, and 1.
Example: tehran
queryOptionalQuery · string | nullOptional Divar search text; native q parameter.
Example: آپارتمان
pageOptionalQuery · integer, min: 0, default: 0Deprecated zero-based page for the first few pages only. Prefer next_cursor for continuation; values above 3 are rejected quickly to avoid replaying a long source chain.
Example: 0
cursorOptionalQuery · string | nullSource-derived cursor example below may expire; cursors are opaque and callers should use the current next_cursor with the same city_slug and query.
Response
itemsobject[]items[].citystringitems[].pricestring | nullitems[].titlestringitems[].tokenstringitems[].area_m2integer | nullitems[].categorystring | nullitems[].districtstring | nullitems[].listing_urlstringitems[].source_typestring | nullhas_morebooleannext_pageinteger | nulltransportstringnext_cursorstring | nullFor the next page, pass next_cursor from the response as cursor. Leave it empty on the first call.
Don’t see the endpoint you need?
Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.
An account is required to submit an extension. Prepare your request, then sign in to build.