/autoru/offers/search

POST /api/autoru/offers/search

Price: 20 credits

Search Auto.ru car listings with the full filter set: region, mark/model/generation, section (new/used/all), price/year/mileage/power/acceleration/displacement ranges, max fuel rate, min ground clearance, min trunk volume, transmission, engine/fuel type, charging port type (electric), drive, body type, steering wheel side, maximum owners, PTS status, damage state, customs-cleared, in-stock, trade-in exchange, photo-only, verified real photos, exterior panoramas, manufacturer-certified, no-mileage-in-Russia, recently posted and an extensive equipment catalogue (airbags, assist systems, climate, cameras, multimedia, lighting, wheels, interior, seats, suspension). Sort by relevance, price, year, mileage or alphabet. Returns full offer cards with price, price history, owner expenses, discount options, mileage, vehicle specification, documents, photos and seller.

How to use it

Search Auto.ru car listings. region is a city slug (default 'moskva', e.g. 'sankt-peterburg'). Narrow by mark (brand slug, e.g. 'bmw') and model (e.g. 'x5', requires mark). section new/used/all (default all). Filters: price_from/price_to (RUB), year_from/year_to, mileage_from/mileage_to (km), power_from/power_to (hp), acceleration/displacement ranges, fuel_rate_to (l/100km), clearance_from (mm), trunk_volume_from (l), transmission (AUTOMATIC/MECHANICAL/ROBOT/VARIATOR), engine_type (GASOLINE/DIESEL/HYBRID/ELECTRO/LPG), charge_connector (TYPE_2/CCS_COMBO_1/CCS_COMBO_2/GBT_AC/GBT_DC, electric), drive (FORWARD_CONTROL/REAR_DRIVE/ALL_WHEEL_DRIVE), body_type (SEDAN/ALLROAD_5_DOORS/HATCHBACK_5_DOORS/WAGON/COUPE/CABRIO/MINIVAN/PICKUP/...), steering_wheel (LEFT/RIGHT), owners_count_to, pts_status (ORIGINAL/DUPLICATE), damage (NOT_BEATEN/BEATEN/ANY), customs, in_stock, exchange, only_with_photo, real_photo, external_panoramas, certificate_manufacturer, without_mileage_in_russia, top_days, catalog_equipment (option codes). Sort by relevance/date_desc/price_asc/price_desc/year/mileage/alphabet. count is required. Each result is a full offer card.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• region string — Region slug for the search (e.g. 'moskva', 'sankt-peterburg') (default: "moskva")
• category string — Vehicle category (default: "cars"; one of: "cars", "motorcycle", "lcv", "trucks", "bus")
• section string — Listing section: new, used or all (default: "all"; one of: "used", "new", "all")
• mark string nullable — Mark/brand slug (e.g. 'bmw', 'lada', 'toyota') (minLength: 1)
• model string nullable — Model slug (e.g. 'x5', 'camry'); requires mark to be set (minLength: 1)
• generation string nullable — Generation id to narrow to a specific model generation (minLength: 1)
• price_from integer nullable — Minimum price (RUB) (min: 0)
• price_to integer nullable — Maximum price (RUB) (min: 0)
• year_from integer nullable — Minimum production year (min: 1900)
• year_to integer nullable — Maximum production year (min: 1900)
• mileage_from integer nullable — Minimum mileage (km) (min: 0)
• mileage_to integer nullable — Maximum mileage (km) (min: 0)
• power_from integer nullable — Minimum engine power (hp) (min: 0)
• power_to integer nullable — Maximum engine power (hp) (min: 0)
• acceleration_from number nullable — Minimum 0-100 km/h acceleration (s) (min: 0)
• acceleration_to number nullable — Maximum 0-100 km/h acceleration (s) (min: 0)
• displacement_from integer nullable — Minimum engine displacement (cc) (min: 0)
• displacement_to integer nullable — Maximum engine displacement (cc) (min: 0)
• fuel_rate_to number nullable — Maximum fuel consumption (l/100km) (min: 0)
• clearance_from integer nullable — Minimum ground clearance (mm) (min: 0)
• trunk_volume_from integer nullable — Minimum trunk volume (l) (min: 0)
• transmission array — Transmission types to include (default: []; one of: "AUTOMATIC", "MECHANICAL", "ROBOT", "VARIATOR")
• engine_type array — Engine/fuel types to include (default: []; one of: "GASOLINE", "DIESEL", "HYBRID", "ELECTRO", "LPG")
• charge_connector array — Charging port types to include (for electric vehicles) (default: []; one of: "TYPE_2", "CCS_COMBO_1", "CCS_COMBO_2", "GBT_AC", "GBT_DC")
• drive array — Drive types to include (default: []; one of: "FORWARD_CONTROL", "REAR_DRIVE", "ALL_WHEEL_DRIVE")
• body_type array — Body types to include (default: []; one of: "SEDAN", "ALLROAD_5_DOORS", "ALLROAD_3_DOORS", "HATCHBACK_5_DOORS", "HATCHBACK_3_DOORS", "LIFTBACK", "WAGON", "COUPE", "CABRIO", "MINIVAN", "PICKUP", "VAN", "LIMOUSINE")
• steering_wheel string nullable — Steering wheel side (left or right) (one of: "LEFT", "RIGHT")
• owners_count_to integer nullable — Maximum number of previous owners (min: 1)
• pts_status string nullable — Vehicle passport (PTS) status (one of: "ORIGINAL", "DUPLICATE")
• damage string nullable — Damage state (not beaten, beaten or any) (one of: "NOT_BEATEN", "BEATEN", "ANY")
• customs boolean nullable — Require customs-cleared vehicles only
• in_stock boolean nullable — Require vehicles in stock (not on order)
• exchange boolean nullable — Require offers open to trade-in exchange
• only_with_photo boolean nullable — Require offers with photos
• real_photo boolean nullable — Require offers with verified real photos
• external_panoramas boolean nullable — Require offers with exterior 360 panoramas
• certificate_manufacturer boolean nullable — Require offers certified by the manufacturer
• without_mileage_in_russia boolean nullable — Require offers with no mileage accrued in Russia
• top_days integer nullable — Only offers posted within the last N days (min: 1)
• catalog_equipment array — Required equipment/options (all must be present) (default: []; one of: "airbag-driver", "airbag-passenger", "central-airbag", "airbag-side", "airbag-rear-side", "airbag-curtain", "knee-airbag", "knee-airbag-pass", "fcw", "collision-prevention-assist", "pedestrian-detection", "ldw", "lane-keeping-assist", "tja", "drowsy-driver-alert-system", "traffic-sign-recognition", "asr", "vsm", "bas", "hcc", "dha", "blind-spot", "rcta", "night-vision", "isofix", "isofix-front", "tyre-pressure", "abs", "esp", "power-child-locks-rear-doors", "glonass", "armored", "climate-control-1", "climate-control-2", "multizone-climate-control", "condition", "auto-cruise", "cruise-control", "auto-park", "park-assist-f", "park-assist-r", "360-camera", "front-camera", "rear-camera", "projection-display", "drive-mode-sys", "remote-engine-start", "easy-trunk-opening", "multi-wheel", "electronic-gage-panel", "keyless-entry", "start-button", "programmed-block-heater", "electro-trunk", "auto-mirrors", "mirrors-memory", "steering-wheel-gear-shift-paddles", "adj-pedals", "start-stop-function", "electro-mirrors", "power-latching-doors", "wheel-configuration1", "wheel-configuration2", "e-adjustment-wheel", "wheel-memory", "electro-window-front", "electro-window-back", "wheel-power", "servo", "rus-multi", "audiosystem-tv", "entertainment-system-for-rear-seat-passengers", "remote-car-services", "wireless-charger", "usb", "navigation", "voice-recognition", "android-auto", "apple-carplay", "ya-auto", "bluetooth", "aux", "12v-socket", "220v-socket", "music-super", "audiosystem-cd", "audiopreparation", "ptf", "adaptive-light", "rain-sensor", "light-sensor", "drl", "automatic-lighting-control", "high-beam-assist", "light-cleaner", "auto-dimming-mirror", "xenon", "laser-lights", "led-lights", "windcleaner-heat", "windscreen-heat", "mirrors-heat", "heated-wash-system", "feedback-alarm", "alarm", "lock", "volume-sensor", "immo", "steel-wheels", "alloy-wheel-disks", "12-inch-wheels", "13-inch-wheels", "14-inch-wheels", "15-inch-wheels", "16-inch-wheels", "17-inch-wheels", "18-inch-wheels", "19-inch-wheels", "20-inch-wheels", "21-inch-wheels", "22-inch-wheels", "23-inch-wheels", "24-inch-wheels", "25-inch-wheels", "26-inch-wheels", "27-inch-wheels", "28-inch-wheels", "duo-body-color", "body-kit", "roof-rails", "airbrush", "body-mouldings", "protective-film", "light-interior", "dark-interior", "velvet-seats", "natural-leather", "alcantara", "leather", "fabric-seats", "driver-seat-updown", "passenger-seat-updown", "driver-seat-electric", "passenger-seat-electric", "electro-rear-seat", "driver-seat-support", "front-seat-support", "front-seats-heat", "rear-seats-heat", "front-seats-heat-vent", "rear-seat-heat-vent", "sport-seats", "hatch", "panorama-roof", "massage-seats", "wheel-heat", "wheel-leather", "leather-gear-stick", "black-roof", "rear-armrest", "third-row-seats", "seat-transformation", "folding-front-passenger-seat", "folding-tables-rear", "decorative-interior-lighting", "front-centre-armrest", "third-rear-headrest", "tinted-glass", "roller-blinds-for-rear-side-windows", "roller-blind-for-rear-window", "sport-pedals", "door-sill-panel", "cap-seats-rear", "athermal-glass", "driver-seat-memory", "seat-memory", "rear-seat-memory", "seats-2", "seats-4", "seats-5", "seats-6", "seats-7", "seats-8", "seats-9", "activ-suspension", "sport-suspension", "air-suspension", "spare-wheel", "reduce-spare-wheel", "turnbuckle", "engine-proof", "add-tires")
• sort string — Sort order (default: "fresh_relevance_1-desc"; one of: "fresh_relevance_1-desc", "cr_date-desc", "price-asc", "price-desc", "year-asc", "year-desc", "km_age-asc", "km_age-desc", "alphabet-asc")
• count integer required — Max number of results to return (min: 1)

Response

• @type string (default: "AutoruOffer")
• id string required
• hash string nullable
• sale_id string nullable
• url string nullable
• description string nullable
• category string nullable
• section string nullable
• status string nullable
• availability string nullable
• color_hex string nullable
• price integer nullable
• currency string nullable
• has_nds boolean nullable
• predicted_price object nullable
  • @type string (default: "AutoruPriceRange")
  • price_from integer nullable
  • price_to integer nullable
  • currency string nullable
• price_history array (default: [])
  • @type string (default: "AutoruPricePoint")
  • price_rur integer nullable
  • price_eur integer nullable
  • price_usd integer nullable
  • created_at integer nullable
• owner_expenses object nullable
  • @type string (default: "AutoruOwnerExpenses")
  • transport_tax integer nullable
  • transport_tax_year integer nullable
  • osago_insurance array (default: [])
    • @type string (default: "AutoruInsuranceQuote")
    • insurance_company string nullable
    • price integer nullable
• discount_options object nullable
  • @type string (default: "AutoruDiscountOptions")
  • tradein integer nullable
  • insurance integer nullable
  • credit integer nullable
  • max_discount integer nullable
• mileage integer nullable
• condition string nullable
• images array (default: [])
• image_count integer nullable
• vehicle object nullable
  • @type string (default: "AutoruVehicle")
  • mark string nullable
  • mark_ru string nullable
  • model string nullable
  • model_ru string nullable
  • generation string nullable
  • generation_id string nullable
  • year_from integer nullable
  • year_to integer nullable
  • price_segment string nullable
  • body_type string nullable
  • door_count integer nullable
  • seats array (default: [])
  • auto_class string nullable
  • engine_type string nullable
  • transmission string nullable
  • drive string nullable
  • engine_volume integer nullable
  • power_hp integer nullable
  • power_kw integer nullable
  • acceleration number nullable
  • fuel_rate number nullable
  • modification string nullable
  • complectation string nullable
  • steering_wheel string nullable
  • vendor string nullable
  • equipment array (default: [])
  • equipment_groups array (default: [])
    • @type string (default: "AutoruEquipmentGroup")
    • name string required
    • values array (default: [])
• documents object nullable
  • @type string (default: "AutoruDocuments")
  • year integer nullable
  • owner_count integer nullable
  • pts string nullable
  • is_pts_original boolean nullable
  • is_custom_cleared boolean nullable
  • vin string nullable
  • vin_resolution string nullable
  • pts_resolution string nullable
  • owners_resolution string nullable
  • legal_resolution string nullable
  • accidents_resolution string nullable
• seller object nullable
  • @type string (default: "AutoruSeller")
  • name string nullable
  • seller_type string nullable
  • geo object nullable
    • @type string (default: "AutoruGeo")
    • address string nullable
    • region string nullable
    • latitude number nullable
    • longitude number nullable
  • rating number nullable
  • review_count integer nullable
  • registration_date string nullable
• salon object nullable
  • @type string (default: "AutoruSalon")
  • id string nullable
  • name string nullable
  • alias string nullable
  • is_official boolean nullable
  • rating number nullable
  • image string nullable
  • phones array (default: [])
  • geo object nullable
    • @type string (default: "AutoruGeo")
    • address string nullable
    • region string nullable
    • latitude number nullable
    • longitude number nullable
  • offer_count integer nullable
• view_count integer nullable
• rating number nullable
• review_count integer nullable
• days_in_stock integer nullable
• created_at integer nullable
• updated_at integer nullable
• tags array (default: [])

Errors

• 422 — The request body did not validate Check the fields against this schema. A URN with the wrong prefix is the most common cause.
• 408 — The request ran past its time limit Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.
• 412 — The entity was not found, or a precondition failed Retrying will not help: either the entity does not exist, or the input points at a different one.
• 429 — Too many requests: a rate limit or a usage window is exhausted When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.
• 500 — Something broke on our side Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.
• 529 — Rate limit reached, or the endpoint is overloaded Wait at least 30 seconds, then retry.

Response headers

• X-Error — Error message text (present only on error)
• X-Request-ID — Unique request identifier
• X-Execution-Time — Execution time in seconds
• X-Result-Count — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.
• X-Total-Available-Results — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.
• X-Warning — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.
• X-Retry-After — Seconds to wait before retrying. Present only on 429.