Skip to main content
POST
/
api
/
carsales
/
listings
/
search
/carsales/listings/search
curl --request POST \
  --url https://api.anysite.io/api/carsales/listings/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "make": "<string>",
  "model": "<string>",
  "private_sellers_only": false,
  "price_min": 1,
  "price_max": 1,
  "year_min": 1901,
  "year_max": 1901,
  "odometer_max": 1,
  "sort": "featured"
}
'
[
  {
    "id": "<string>",
    "@type": "CarsalesListing",
    "guid": "<string>",
    "url": "<string>",
    "make": "<string>",
    "model": "<string>",
    "badge": "<string>",
    "year": 123,
    "price": 123,
    "price_type": "<string>",
    "market_position": "<string>",
    "body_type": "<string>",
    "transmission": "<string>",
    "engine": "<string>",
    "fuel": "<string>",
    "odometer_km": 123,
    "build_date": "<string>",
    "ev_range_km": 123,
    "state": "<string>",
    "condition": "<string>",
    "seller_type": "<string>",
    "seller_id": "<string>",
    "image": "<string>",
    "images": [],
    "photo_count": 123,
    "badges": []
  }
]

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

Make slug (e.g. 'toyota', 'land-rover', 'mercedes-benz')

Minimum string length: 1
​
model
string | null

Model slug (e.g. 'corolla', 'hilux'); requires make to be set

Minimum string length: 1
​
condition
enum<string> | null

New or used

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

Body type

Available options:
suv,
sedan,
hatch,
ute,
wagon,
coupe,
convertible,
people-mover,
van,
bus,
cab-chassis
​
fuel_type
enum<string> | null

Fuel / electric type

Available options:
petrol,
diesel,
electric,
hybrid,
plug-in-hybrid,
dual-fuel,
gas-only
​
transmission
enum<string> | null

Transmission type

Available options:
automatic,
manual,
amt
​
color
enum<string> | null

Exterior color

Available options:
beige,
black,
blue,
bordeaux,
bronze,
brown,
burgundy,
gold,
green,
grey,
magenta,
maroon,
orange,
pink,
purple,
red,
silver,
white,
yellow
​
state
enum<string> | null

Australian state / territory

Available options:
new-south-wales,
victoria,
queensland,
south-australia,
western-australia,
tasmania,
northern-territory,
australian-capital-territory
​
cylinders
enum<string> | null

Number of engine cylinders

Available options:
2,
3,
4,
5,
6,
8,
10,
12
​
doors
enum<string> | null

Number of doors

Available options:
1,
2,
3,
4,
5,
6
​
induction
enum<string> | null

Engine induction type

Available options:
aspirated,
turbo,
supercharged,
turbo-supercharged
​
lifestyle
enum<string> | null

Lifestyle category

Available options:
family,
first-car,
green,
offroad-4x4,
performance,
prestige,
tradie,
unique
​
ev_connector
enum<string> | null

EV charging connector type

Available options:
ccs2,
chademo,
type-1,
type-2
​
private_sellers_only
boolean
default:false

Only private-seller listings

​
price_min
integer | null

Minimum price (AUD)

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

Maximum price (AUD)

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

Minimum build year

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

Maximum build year

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

Maximum odometer (km)

Required range: x >= 0
​
sort
enum<string>
default:featured

Sort order

Available options:
featured,
price_low,
price_high,
odometer_low,
odometer_high,
year_new,
year_old,
trade_in_bonus

Response

Successful Response

​
id
string
required
​
@type
string
default:CarsalesListing
​
guid
string | null
​
url
string | null
​
make
string | null
​
model
string | null
​
badge
string | null
​
year
integer | null
​
price
number | null
​
price_type
string | null
​
market_position
string | null
​
body_type
string | null
​
transmission
string | null
​
engine
string | null
​
fuel
string | null
​
odometer_km
number | null
​
build_date
string | null
​
ev_range_km
number | null
​
state
string | null
​
condition
string | null
​
seller_type
string | null
​
seller_id
string | null
​
image
string | null
​
images
string[]
​
photo_count
integer | null
​
badges
string[]