Divar Scraper — Iran Classified Ads, Prices & Cities

Divar.ir in rows: ad title, price in toman as a real number, condition, city and district, photo count and a direct ad link — from any Iranian city or category.

What does the Divar Scraper do?

This Actor collects classified ads from Divar, by far the largest marketplace in Iran and the place almost every private sale in the country goes through. It returns one row per ad with the price converted from Persian numerals into a number you can sort on, alongside the original text exactly as the site printed it.

That conversion is the point. Divar publishes prices as "۸۵٬۰۰۰٬۰۰۰ تومان" — Persian-Indic digits that no spreadsheet will treat as a figure. The Actor transliterates them and keeps both forms, so you can filter on price and still check any row against the site by eye.

The other thing it handles for you is paging. Divar's gateway does not accept a page number past the first request: it hands back a cursor carrying the last ad's timestamp and the tokens already served, and expects that object back verbatim. Send a page number instead and you get the opening block over and over — which is why a naive crawl of Divar quietly returns the same twenty-four ads forever.

Who is it for?

• Market researchers studying Iranian consumer prices and supply.
• Pricing analysts tracking second-hand values across cities.
• Automotive and property analysts measuring listing volumes and asking prices.
• Economists and journalists using classified prices as an inflation signal.
• Trade and sourcing teams mapping what is available in the Iranian market.
• Academics studying informal and second-hand economies at scale.

Use cases

• Track asking prices for a product category across Tehran over time.
• Compare prices for the same category between several cities.
• Measure listing volume in a category as a demand indicator.
• Build a second-hand price index from real classified data.
• Watch new-versus-used supply using the condition column.
• Collect ads with photos for a visual catalogue.
• Study how prices move in a high-inflation market month to month.

Why use this Divar Scraper?

• Cursor pagination handled properly, which is the difference between thousands of ads and the same first page repeated.
• Persian numerals converted to real numbers, with the original text kept alongside.
• City and district on every row, so you can compare neighbourhoods, not just cities.
• Keyword, category and multi-city crawling in a single run.
• Iran-pinned residential proxying, because Divar answers requests from inside the country.
• Condition and promotion flags, so paid-bump listings can be separated from ordinary ones.

What data can you extract?

Field	Description
token	Divar's own ad token, stable per listing
title	Ad title
price	Price in toman as a number
priceText	Price exactly as Divar printed it
condition	New, used or the seller's own wording
city	City in Persian
district	Neighbourhood in Persian
imageCount	How many photos the ad carries
isPromoted	Whether the seller paid to bump the ad
imageUrl	First photo
url	Direct link to the ad

Sample output

{
  "token": "galV9lwr",
  "title": "آیفون ۱۶ قسطی با شرایط ویژه بدون ضامن",
  "price": 85000000,
  "priceText": "۸۵,۰۰۰,۰۰۰ تومان",
  "condition": "نو",
  "city": "تهران",
  "district": "گیشا",
  "imageCount": 5,
  "isPromoted": true,
  "imageUrl": "https://s100.divarcdn.com/static/photo/neda/webp_thumbnail/k.webp",
  "url": "https://divar.ir/v/galV9lwr"
}

How to use the Divar Scraper

Option A — one city, one category

Leave City IDs as 1 (Tehran), set Category slug to something like mobile-phones, set Maximum ads and run.

Option B — several cities at once

Add more IDs to City IDs, one per line. All of them are crawled into the same dataset.

Option C — keyword search

Put a term into Search terms. Persian works best, but Latin brand and model names appear in many titles too.

Option D — a whole city

Leave both the category and the search empty. The crawl then walks everything currently listed in the chosen cities.

Input parameters

Parameter	Type	Description
cityIds	array	Divar city IDs, one per line; Tehran is 1
category	string	Category slug from a Divar category URL
searchQueries	array	Free-text search terms
maxItems	integer	How many ads to collect in total
proxyConfiguration	object	Iran-pinned residential proxy, required

Tips for best results

• Leave the proxy pinned to Iran. Divar does not serve its listing gateway to requests from outside the country.
• Use price, not priceText, for anything numeric. The text form is there so you can verify a row, not so you can compute with it.
• Category slugs come from the URL. Open the category on Divar and copy the last path segment.
• Ads marked isPromoted are paid bumps. Filter them out when you want an unbiased view of supply.
• Free items and "price on request" ads have no price, so a small share of rows carry text but no number.

Integrations

Send results to Google Sheets, Airtable, Slack, Zapier, Make or your own service through Apify's integrations, or schedule a run to track a category over time.

API usage

curl -X POST "https://api.apify.com/v2/acts/YOUR_USERNAME~divar-scraper/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "cityIds": ["1"],
    "category": "mobile-phones",
    "maxItems": 1000
  }'

Results export as JSON, CSV, Excel, XML or RSS.

Use with AI agents (MCP)

Available as a tool through Apify's MCP server, so an agent can look up Iranian market prices or summarise what is listed in a category.

FAQ

Do I need a Divar account or API key?

No. The listing gateway this Actor reads is the same one the Divar website calls.

How many ads can one run return?

Divar's cursor pages a long way back, so several thousand ads from a busy category is routine.

Where do I find a city ID?

Tehran is 1. Other cities have their own numeric IDs, visible in the requests Divar's own site makes when you switch city.

Why is the price sometimes empty?

Because the ad has no price — free items, swaps and "call for price" listings are common on Divar. The text column shows whatever the seller wrote.

What does isPromoted mean?

The seller paid to bump the ad back to the top. It is worth filtering out when you are measuring genuine supply.

Are titles and cities in Persian?

Yes. Divar is a Persian-language site and the Actor reports its text as written rather than machine-translating it.

Can I search in English?

Partly. Latin brand and model names do appear in Divar titles, but Persian terms return far more.

Can I export to CSV or Excel?

Yes — JSON, CSV, Excel, XML and RSS.

How fresh is the data?

Every run reads Divar live.

Why did my run return zero ads?

Usually a category slug that does not exist. Open the category on divar.ir and copy the slug from its URL.

Is it legal to scrape Divar?

This Actor reads publicly listed ads, which is generally lawful to collect. You are responsible for how you use the data — check Divar's terms, treat any seller detail as personal data under applicable privacy law, and do not use it for unsolicited bulk contact.

Related scrapers

Pair with the other classifieds Actors in the store to cover the Middle East, South Asia and Europe alongside Iran.

---

*Maintained: last verified 2026-09-01 — checked end-to-end against live run history (reliability, output fields and types, and time/memory budgets).