Skip to main content
POST
/
api
/
autoru
/
offers
/
search
/autoru/offers/search
curl --request POST \
  --url https://api.anysite.io/api/autoru/offers/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "region": "moskva",
  "category": "cars",
  "section": "all",
  "mark": "<string>",
  "model": "<string>",
  "generation": "<string>",
  "price_from": 1,
  "price_to": 1,
  "year_from": 1901,
  "year_to": 1901,
  "mileage_from": 1,
  "mileage_to": 1,
  "power_from": 1,
  "power_to": 1,
  "acceleration_from": 1,
  "acceleration_to": 1,
  "displacement_from": 1,
  "displacement_to": 1,
  "fuel_rate_to": 1,
  "clearance_from": 1,
  "trunk_volume_from": 1,
  "transmission": [],
  "engine_type": [],
  "charge_connector": [],
  "drive": [],
  "body_type": [],
  "owners_count_to": 2,
  "customs": true,
  "in_stock": true,
  "exchange": true,
  "only_with_photo": true,
  "real_photo": true,
  "external_panoramas": true,
  "certificate_manufacturer": true,
  "without_mileage_in_russia": true,
  "top_days": 2,
  "catalog_equipment": [],
  "sort": "fresh_relevance_1-desc"
}
'
[
  {
    "id": "<string>",
    "@type": "@autoru_offer",
    "hash": "<string>",
    "sale_id": "<string>",
    "url": "<string>",
    "title": "<string>",
    "description": "<string>",
    "category": "<string>",
    "section": "<string>",
    "status": "<string>",
    "availability": "<string>",
    "color_hex": "<string>",
    "price": 123,
    "currency": "<string>",
    "has_nds": true,
    "predicted_price": {
      "@type": "@autoru_price_range",
      "price_from": 123,
      "price_to": 123,
      "currency": "<string>"
    },
    "price_history": [],
    "owner_expenses": {
      "@type": "@autoru_owner_expenses",
      "transport_tax": 123,
      "transport_tax_year": 123,
      "osago_insurance": []
    },
    "discount_options": {
      "@type": "@autoru_discount_options",
      "tradein": 123,
      "insurance": 123,
      "credit": 123,
      "max_discount": 123
    },
    "mileage": 123,
    "condition": "<string>",
    "images": [],
    "image_count": 123,
    "vehicle": {
      "@type": "@autoru_vehicle",
      "mark": "<string>",
      "mark_ru": "<string>",
      "model": "<string>",
      "model_ru": "<string>",
      "generation": "<string>",
      "generation_id": "<string>",
      "year_from": 123,
      "year_to": 123,
      "price_segment": "<string>",
      "body_type": "<string>",
      "door_count": 123,
      "seats": [],
      "auto_class": "<string>",
      "engine_type": "<string>",
      "transmission": "<string>",
      "drive": "<string>",
      "engine_volume": 123,
      "power_hp": 123,
      "power_kw": 123,
      "acceleration": 123,
      "fuel_rate": 123,
      "modification": "<string>",
      "complectation": "<string>",
      "steering_wheel": "<string>",
      "vendor": "<string>",
      "equipment": [],
      "equipment_groups": []
    },
    "documents": {
      "@type": "@autoru_documents",
      "year": 123,
      "owner_count": 123,
      "pts": "<string>",
      "is_pts_original": true,
      "is_custom_cleared": true,
      "vin": "<string>",
      "vin_resolution": "<string>",
      "pts_resolution": "<string>",
      "owners_resolution": "<string>",
      "legal_resolution": "<string>",
      "accidents_resolution": "<string>"
    },
    "seller": {
      "@type": "@autoru_seller",
      "name": "<string>",
      "seller_type": "<string>",
      "geo": {
        "@type": "@autoru_geo",
        "address": "<string>",
        "region": "<string>",
        "latitude": 123,
        "longitude": 123
      },
      "rating": 123,
      "review_count": 123,
      "registration_date": "<string>"
    },
    "salon": {
      "@type": "@autoru_salon",
      "id": "<string>",
      "name": "<string>",
      "alias": "<string>",
      "is_official": true,
      "rating": 123,
      "image": "<string>",
      "phones": [],
      "geo": {
        "@type": "@autoru_geo",
        "address": "<string>",
        "region": "<string>",
        "latitude": 123,
        "longitude": 123
      },
      "offer_count": 123
    },
    "view_count": 123,
    "rating": 123,
    "review_count": 123,
    "days_in_stock": 123,
    "created_at": 123,
    "updated_at": 123,
    "tags": []
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
count
integer
required

Max number of results to return

Required range: x >= 1
​
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
​
region
string
default:moskva

Region slug for the search (e.g. 'moskva', 'sankt-peterburg')

​
category
enum<string>
default:cars

Vehicle category

Available options:
cars,
motorcycle,
lcv,
trucks,
bus
​
section
enum<string>
default:all

Listing section: new, used or all

Available options:
used,
new,
all
​
mark
string | null

Mark/brand slug (e.g. 'bmw', 'lada', 'toyota')

Minimum string length: 1
​
model
string | null

Model slug (e.g. 'x5', 'camry'); requires mark to be set

Minimum string length: 1
​
generation
string | null

Generation id to narrow to a specific model generation

Minimum string length: 1
​
price_from
integer | null

Minimum price (RUB)

Required range: x >= 0
​
price_to
integer | null

Maximum price (RUB)

Required range: x >= 0
​
year_from
integer | null

Minimum production year

Required range: x >= 1900
​
year_to
integer | null

Maximum production year

Required range: x >= 1900
​
mileage_from
integer | null

Minimum mileage (km)

Required range: x >= 0
​
mileage_to
integer | null

Maximum mileage (km)

Required range: x >= 0
​
power_from
integer | null

Minimum engine power (hp)

Required range: x >= 0
​
power_to
integer | null

Maximum engine power (hp)

Required range: x >= 0
​
acceleration_from
number | null

Minimum 0-100 km/h acceleration (s)

Required range: x >= 0
​
acceleration_to
number | null

Maximum 0-100 km/h acceleration (s)

Required range: x >= 0
​
displacement_from
integer | null

Minimum engine displacement (cc)

Required range: x >= 0
​
displacement_to
integer | null

Maximum engine displacement (cc)

Required range: x >= 0
​
fuel_rate_to
number | null

Maximum fuel consumption (l/100km)

Required range: x >= 0
​
clearance_from
integer | null

Minimum ground clearance (mm)

Required range: x >= 0
​
trunk_volume_from
integer | null

Minimum trunk volume (l)

Required range: x >= 0
​
transmission
enum<string>[]

Transmission types to include

Available options:
AUTOMATIC,
MECHANICAL,
ROBOT,
VARIATOR
​
engine_type
enum<string>[]

Engine/fuel types to include

Available options:
GASOLINE,
DIESEL,
HYBRID,
ELECTRO,
LPG
​
charge_connector
enum<string>[]

Charging port types to include (for electric vehicles)

Available options:
TYPE_2,
CCS_COMBO_1,
CCS_COMBO_2,
GBT_AC,
GBT_DC
​
drive
enum<string>[]

Drive types to include

Available options:
FORWARD_CONTROL,
REAR_DRIVE,
ALL_WHEEL_DRIVE
​
body_type
enum<string>[]

Body types to include

Available options:
SEDAN,
ALLROAD_5_DOORS,
ALLROAD_3_DOORS,
HATCHBACK_5_DOORS,
HATCHBACK_3_DOORS,
LIFTBACK,
WAGON,
COUPE,
CABRIO,
MINIVAN,
PICKUP,
VAN,
LIMOUSINE
​
steering_wheel
enum<string> | null

Steering wheel side (left or right)

Available options:
LEFT,
RIGHT
​
owners_count_to
integer | null

Maximum number of previous owners

Required range: x >= 1
​
pts_status
enum<string> | null

Vehicle passport (PTS) status

Available options:
ORIGINAL,
DUPLICATE
​
damage
enum<string> | null

Damage state (not beaten, beaten or any)

Available options:
NOT_BEATEN,
BEATEN,
ANY
​
customs
boolean | null

Require customs-cleared vehicles only

​
in_stock
boolean | null

Require vehicles in stock (not on order)

​
exchange
boolean | null

Require offers open to trade-in exchange

​
only_with_photo
boolean | null

Require offers with photos

​
real_photo
boolean | null

Require offers with verified real photos

​
external_panoramas
boolean | null

Require offers with exterior 360 panoramas

​
certificate_manufacturer
boolean | null

Require offers certified by the manufacturer

​
without_mileage_in_russia
boolean | null

Require offers with no mileage accrued in Russia

​
top_days
integer | null

Only offers posted within the last N days

Required range: x >= 1
​
catalog_equipment
enum<string>[]

Required equipment/options (all must be present)

Available options:
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
enum<string>
default:fresh_relevance_1-desc

Sort order

Available options:
fresh_relevance_1-desc,
cr_date-desc,
price-asc,
price-desc,
year-asc,
year-desc,
km_age-asc,
km_age-desc,
alphabet-asc

Response

Successful Response

​
id
string
required
​
@type
string
default:@autoru_offer
​
hash
string | null
​
sale_id
string | null
​
url
string | null
​
title
string | null
​
description
string | null
​
category
string | null
​
section
string | null
​
status
string | null
​
availability
string | null
​
color_hex
string | null
​
price
integer | null
​
currency
string | null
​
has_nds
boolean | null
​
predicted_price
AutoruPriceRange · object
​
price_history
AutoruPricePoint · object[]
​
owner_expenses
AutoruOwnerExpenses · object
​
discount_options
AutoruDiscountOptions · object
​
mileage
integer | null
​
condition
string | null
​
images
string[]
​
image_count
integer | null
​
vehicle
AutoruVehicle · object
​
documents
AutoruDocuments · object
​
seller
AutoruSeller · object
​
salon
AutoruSalon · object
​
view_count
integer | null
​
rating
number | null
​
review_count
integer | null
​
days_in_stock
integer | null
​
created_at
integer | null
​
updated_at
integer | null
​
tags
string[]