Skip to main content
POST
/
api
/
drom
/
cars
/
search
/drom/cars/search
curl --request POST \
  --url https://api.anysite.io/api/drom/cars/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "brand": "toyota",
  "model": "camry",
  "condition": "all",
  "damage": "any",
  "price_min": 1,
  "price_max": 1,
  "year_min": 1901,
  "year_max": 1901,
  "mileage_min": 1,
  "mileage_max": 1,
  "power_min": 1,
  "power_max": 1,
  "color_id": 2,
  "available_only": false,
  "sort": "relevance"
}
'
[
  {
    "id": "<string>",
    "url": "<string>",
    "@type": "@drom_car_card",
    "title": "<string>",
    "subtitle": "<string>",
    "price": 123,
    "location": "<string>",
    "date": "<string>",
    "is_dealer": true,
    "dealer_name": "<string>",
    "is_sold": true,
    "attributes": [],
    "image": "<string>",
    "images": []
  }
]

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
​
brand
string | null

Brand slug, e.g. 'toyota', 'lada', 'bmw'

Example:

"toyota"

​
model
string | null

Model slug, e.g. 'camry' (requires brand)

Example:

"camry"

​
fuel
enum<string> | null

Fuel type

Available options:
petrol,
diesel,
hybrid,
gas,
electro
​
body_type
enum<string> | null

Body type

Available options:
sedan,
hatchback,
liftback,
coupe,
suv,
wagon,
van,
pickup
​
condition
enum<string>
default:all

Listing condition

Available options:
all,
used,
new
​
transmission
enum<string> | null

Transmission type

Available options:
manual,
automatic,
variator
​
drive
enum<string> | null

Drive type

Available options:
front,
rear,
full
​
wheel
enum<string> | null

Steering wheel side

Available options:
left,
right
​
damage
enum<string>
default:any

Damage filter

Available options:
any,
damaged,
not_damaged
​
price_min
integer | null

Minimum price (RUB)

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

Maximum price (RUB)

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

Minimum production year

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

Maximum production year

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

Minimum mileage (km)

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

Maximum mileage (km)

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

Minimum engine power (hp)

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

Maximum engine power (hp)

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

Color id (source-specific numeric code)

Required range: x >= 1
​
available_only
boolean
default:false

Exclude already sold listings

​
sort
enum<string>
default:relevance

Sort order

Available options:
relevance,
price_asc,
price_desc,
year_asc,
year_desc

Response

Successful Response

​
id
string
required
​
url
string
required
​
@type
string
default:@drom_car_card
​
title
string | null
​
subtitle
string | null
​
price
integer | null
​
location
string | null
​
date
string | null
​
is_dealer
boolean | null
​
dealer_name
string | null
​
is_sold
boolean | null
​
attributes
string[]
​
image
string | null
​
images
string[]