Ads near a point
dv_nearbyRead-onlyIdempotent
Find Divar ads near a GPS point by category, radius, price, and filters; results are sorted nearest first with coordinates, distances, price chips, and thumbnails.
Instructions
Ads on the map around a GPS point, nearest first, with coordinates, distance, price chips and a thumbnail.
Up to 200 ads per area are available (total_in_area is the true count). Pin positions are fuzzed by about 500 m
for most categories (approximate_location), so distances are approximate. A category is required (Divar's map
returns nothing without one). Map prices are rounded in the site's display (1.5 billion = 1,500,000,000); sale
pins give the total price and, for homes, price_per_m2. Next: dv_post for details.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | Yes | Latitude, e.g. 35.7. Get one from dv_place_search or dv_districts. | |
| lon | Yes | Longitude, e.g. 51.4. | |
| limit | No | Max ads in the answer. | |
| query | No | Free text in title or description, e.g. 'پراید 111'. | |
| filters | No | Other category filters (keys from dv_filters): {'size': {'min': 80, 'max': 120}, 'rooms': ['دو'], 'parking': true}. Unknown keys are returned in `ignored`. | |
| category | Yes | Required: the map shows nothing without a category. Slug or Persian name, e.g. 'apartment-sell', 'apartment-rent', 'light'. List them with dv_categories. | |
| radius_m | No | Search radius in metres. | |
| max_price | No | Toman; monthly rent in rent categories. | |
| min_price | No | Toman; monthly rent in rent categories. | |
| brand_model | No | Vehicles, phones: brand/model, e.g. ['پژو 206']. | |
| max_deposit | No | Rent categories: deposit (ودیعه) in Toman. | |
| min_deposit | No | Rent categories: deposit (ودیعه) in Toman. |