/autoru/offers

POST /api/autoru/offers

Price: 10 credits

Get a single Auto.ru car listing by its identifier. Returns the full offer card: price and predicted price range, mileage, condition, photos, the full vehicle specification (mark, model, generation, body type, engine, transmission, drive, power, equipment), documents (year, owners, PTS, VIN status, accident/legal checks), the seller (private person or dealer salon with rating and location), view counters and timestamps.

How to use it

Get an Auto.ru car listing by id. Provide offer as the '{saleId}-{hash}' identifier (e.g. '1132375431-0b6ede1e') or the full listing URL. category (cars/motorcycle/lcv/trucks/bus, default cars) and section (used/new, default used) help locate the offer when only the bare id is given. Returns id, title, price, currency, mileage, condition, images, vehicle (mark/model/generation/body_type/engine_type/transmission/drive/power_hp/equipment), documents (year/owner_count/pts/vin), seller or salon, rating and timestamps.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• offer string required — Offer identifier ('{saleId}-{hash}', e.g. '1132375431-0b6ede1e') or the full listing URL (examples: "1132375431-0b6ede1e"; minLength: 1)
• category string — Vehicle category (default: "cars"; one of: "cars", "motorcycle", "lcv", "trucks", "bus")
• section string — Listing section (new or used vehicles) (default: "used"; one of: "used", "new")

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 — Offer not found 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.