Sheypoor Classifieds

Get one Sheypoor ad in full: description, price, location, seller, every attribute and photo links. `id` comes from sp_search. `city_slug` and `category_slug` plug straight into sp_search; sp_similar finds comparable ads. Rentals have `prices` (رهن deposit, اجاره rent) instead of one price. The seller's phone number needs a Sheypoor login and is not available here (the site shows it masked); open `url` in a browser to contact the seller. For a list of similar ads call sp_search with the same category.

Compare asking prices between neighbourhoods of a city: median price, price per square metre, rent and deposit. Use it for "where is renting cheapest in Tehran" or "price per metre in Pounak vs Saadat Abad". It samples each area's newest 24 ads (one request per area), so medians are rough. Sale ads give `median_price` and, with meterage, `median_per_m2`; rentals give `median_deposit` and `median_rent`. Values in Toman. Pick ids with sp_filters(category, city, area=...); see sp_search with `neighbourhoods` for the ads themselves.

Get Sheypoor's daily car price list (قیمت روز خودرو): market price and factory price per model and year, with the day's change. Use it for "what is a 1404 Tiba worth today" or to check an ad's price against the market average; it is Sheypoor's average of market quotes, not ads. `market` is the open-market price, `factory` the maker's list price (null = none). Values are in Toman; `change_pct` is today's move of the market price. For real ad prices use sp_price_summary instead.

List Sheypoor's categories with the slug sp_search and sp_filters take, grouped under 11 top-level groups. Pass `query` to keep only matching groups or categories. Brands and models of cars live one level deeper: sp_filters(category="car") lists their slugs (e.g. car/peugeot). Use the slug of a sub-category alone (car, not vehicles/car).

Find the city or province slug that sp_search, sp_price_summary and sp_filters take. With `query`, returns matching cities (slug, province); a province slug also works as `city` and covers every city in it. Without `query`, lists the 31 provinces with their slugs and number of cities.

List the filters, sort orders, sub-categories (car brands, models) and neighbourhoods Sheypoor offers in one category. Call this before using `filters` in sp_search or sp_price_summary; every category has its own (cars: year, km, gearbox; sale: meterage mn68085/mx68085, rooms; rent: deposit mn68090 and rent mn68092; jobs: salary, contract). Each filter has a `name` (a<id>, mn<id>, mx<id>) and, for choices, `options` as {id, label}: pass {name: id}. Range filters list min/max names (pass a plain number, e.g. mn68101='1400'). Yes/no filters have `value` '1' (pass {name: '1'}); number filters take a plain number. `subcategories` slugs (car/peugeot, then car/peugeot/206) go in `category`. `neighbourhoods` (id, name, ads) go in sp_search `neighbourhoods`; pass `area` to search the full list by name. The nearest-first sort needs the visitor's GPS and is not offered. Prices use min_price/max_price instead.

Summarise asking prices of the newest ads for a search: count, min, median, quartiles, max, plus cheapest and priciest ads. Use it to answer "what does X cost on Sheypoor". It samples the newest ads (up to 5 pages), so it shows current asking prices, not sold prices. Ads without a numeric price and placeholder prices under 10,000 Toman are left out. Narrow the query (year, brand, city via sp_filters/sp_cities) for a useful median. Values are in Toman.

Search Sheypoor classified ads (cars, real estate, goods, jobs, services) by words, city, category and price. Use it to find ads or see what is on sale; call sp_ad with an ad `id` for the full text, seller and all attributes. Slugs come from sp_cities and sp_categories; for attribute filters (year, brand, colour, gearbox, area...) call sp_filters first. `price` is in Toman (null when the seller wrote negotiable: see `price_text`); prices of 1,000 Toman are placeholders. Rentals carry `prices` ({رهن deposit, اجاره rent}; `price` is the first of them). Use `neighbourhoods` (ids from sp_filters area=...) for areas inside a city. `nearby` ads are from around the city: the site adds them when few ads match inside it. `promoted` ads are paid showcase slots and may not match your filters exactly. `matching` is the count of real matches; `total` also counts nearby/padding ads. Sorting by price puts placeholder prices first: set min_price to skip them. For a median or range of prices use sp_price_summary instead.

Get one internet shop or agency: name, hours, group, its agents and its current ads. `slug` comes from sp_shops (or `seller.shop` ads from sp_ad). Phone numbers are masked on the site and left out. Each ad has an `id` for sp_ad.

List Sheypoor's internet shops and agencies (real-estate offices, car dealers...) in a city and group. Use it to find businesses rather than single ads; call sp_shop with a shop `slug` for its details and ads. `category` is a top-level group (real-estate, vehicles...), not a sub-category such as car. Shops with no ads are left out (the site lists them but their page is gone), so a page may hold fewer than `limit` shops.

Find ads comparable to one ad: same city and deepest category (car model...), price within a percent band. Use it to judge whether an ad is cheap or dear, or to find alternatives; the `id` comes from sp_search. If fewer than 3 ads match, it widens to the parent category (car/hyundai/creta -> car/hyundai) and says so in `category`. Rentals and ads without a numeric price are matched by category only. Newest first; the ad itself and paid showcase ads are left out. For the price distribution of the category use sp_price_summary.