Catalog / Divar Real Estate Listings

Divar Real Estate Listings API

divar.ir

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.

  • Real estate
  • real-estate
  • divar
  • iran
4 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In 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 key

Sign 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.

Return a live Tehran residential-sale page with cursor continuation.

Optional parameters 2

Deprecated zero-based page for the first few pages only. Prefer next_cursor for sale-feed continuation; values above 3 are rejected quickly.

Source-derived cursor example below may expire; cursors are opaque and callers should use the current next_cursor unchanged for subsequent Tehran sale pages.

View call pricing
cURL · Buy home listings
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: 0

Deprecated 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 | null

Source-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[].citystring
items[].pricestring | null
items[].titlestring
items[].tokenstring
items[].area_m2integer | null
items[].categorystring | null
items[].districtstring | null
items[].listing_urlstring
items[].source_typestring | null
has_moreboolean
next_pageinteger | null
transportstring
next_cursorstring | null

For 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 | null

Optional substring in a Persian city name, accepted Latin slug, or province. Omit it to return Divar's complete anonymous city catalog.

Example: تهران

Response

countinteger
itemsobject[]
items[].idstring
items[].namestring
items[].slugstring | null
items[].provincestring | null
querystring | null
transportstring
GETListings 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 · string

The 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 | null
roomsstring | null
titlestring
tokenstring
imagesstring[]
addressstring | null
area_m2number | null
categorystring | null
districtstring | null
latitudenumber | null
longitudenumber | null
transportstring
descriptionstring | null
listing_urlstring
GETReal estate listings/v1/real-estate-listings/{city_slug}

Fetch one live source search page; never reads saved HTML or test fixtures.

Input

city_slugRequiredPath · string

A 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 | null

Optional Divar search text; native q parameter.

Example: آپارتمان

pageOptionalQuery · integer, min: 0, default: 0

Deprecated 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 | null

Source-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[].citystring
items[].pricestring | null
items[].titlestring
items[].tokenstring
items[].area_m2integer | null
items[].categorystring | null
items[].districtstring | null
items[].listing_urlstring
items[].source_typestring | null
has_moreboolean
next_pageinteger | null
transportstring
next_cursorstring | null

For 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.