Skip to main content
POST
/gumtree/listings/search

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
count
integer
required
Required range: x >= 1
timeout
integer
default:300
Required range: 20 <= x <= 1500
keyword
string | null
Minimum string length: 1
search_category
string | null
Minimum string length: 1
search_location
string | null
Minimum string length: 1
distance
enum<string> | null
Available options:
1,
3,
5,
10,
15,
30,
50,
75,
100,
1000
sort
enum<string> | null
Available options:
relevance,
date,
price_lowest_first,
price_highest_first,
distance
seller_type
enum<string>[] | null
Available options:
trade,
private
min_price
number | null
Required range: x >= 0
max_price
number | null
Required range: x >= 0
has_photos
boolean
default:false
is_urgent
boolean
default:false
search_in_description
boolean
default:false
condition
enum<string>[] | null
Available options:
new,
as_good_as_new,
good,
fair
delivery_available
boolean
default:false
vehicle_make
enum<string> | null
Available options:
abarth,
ac,
aixam,
alfa_romeo,
aston_martin,
audi,
austin,
bedford,
bentley,
bmc,
bmw,
byd,
cadillac,
caterham,
chery,
chevrolet,
chrysler,
citroen,
cupra,
dacia,
daewoo,
daf_trucks,
daihatsu,
daimler,
dodge,
ds,
ferrari,
fiat,
ford,
genesis,
great_wall,
honda,
hummer,
hyundai,
ineos,
infiniti,
isuzu,
isuzu_trucks,
iveco,
jaecoo,
jaguar,
jeep,
kgm,
kia,
ktm,
lamborghini,
land_rover,
ldv,
leapmotor,
levc,
lexus,
lotus,
lti,
man,
marcos,
marlin,
maserati,
maxus,
maybach,
mazda,
mclaren,
mercedes_benz,
mg,
mg_motor_uk,
microcar,
mini,
mitsubishi,
mitsubishi_fuso,
morgan,
nissan,
omoda,
opel,
perodua,
peugeot,
piaggio,
polestar,
porsche,
proton,
reliant,
renault,
renault_trucks,
rolls_royce,
rover,
saab,
scania,
seat,
skoda,
smart,
ssangyong,
subaru,
suzuki,
talbot,
tesla,
toyota,
tvr,
vauxhall,
volkswagen,
volvo,
westfield,
other_manufacturer
vehicle_model
string[] | null
vehicle_body_type
enum<string>[] | null
Available options:
car_derived_van,
convertible,
coupe,
estate,
hatchback,
light_4x4_utility,
minibus,
motor_caravan,
mpv,
panel_van,
pick_up,
saloon,
sports,
window_van,
other
vehicle_fuel_type
enum<string>[] | null
Available options:
diesel,
electric,
gas,
gas_bi_fuel,
hybrid_electric,
petrol,
petrol_gas,
other
vehicle_transmission
enum<string>[] | null
Available options:
automatic,
manual,
semi_auto,
other
vehicle_colour
enum<string>[] | null
Available options:
biege,
black,
blue,
bronze,
brown,
cream,
gold,
green,
grey,
maroon,
mauve,
multi_coloured,
orange,
pink,
purple,
red,
silver,
white,
yellow,
other
vehicle_doors
integer[] | null
vehicle_seats
integer[] | null
vehicle_average_mpg
enum<string> | null
Available options:
over_30,
over_40,
over_50,
over_60
min_vehicle_registration_year
integer | null
Required range: x >= 1900
max_vehicle_registration_year
integer | null
Required range: x >= 1900
min_vehicle_mileage
integer | null
Required range: x >= 0
max_vehicle_mileage
integer | null
Required range: x >= 0
min_vehicle_engine_size
integer | null
Required range: x >= 0
max_vehicle_engine_size
integer | null
Required range: x >= 0
property_type
enum<string>[] | null
Available options:
flat,
house,
other
min_bedrooms
integer | null
Required range: x >= 0
max_bedrooms
integer | null
Required range: x >= 0
all_bills_included
boolean
default:false
council_tax_included
boolean
default:false
pets_allowed
boolean
default:false
job_contract_type
enum<string>[] | null
Available options:
cashinhand,
contract,
freelance,
locum,
permanent,
selfemployed,
subcontractor,
voluntary
job_hours
enum<string>[] | null
Available options:
evening,
full_time,
morning,
nights,
part_time,
saturday_job,
term-time,
weekends
job_level
enum<string>[] | null
Available options:
apprenticeship,
experienced,
graduate,
internship,
management
job_language
enum<string>[] | null
Available options:
arabic,
filipino,
english,
french,
german,
greek,
hindi,
italian,
polish,
romanian,
spanish,
swedish,
thai,
turkish,
urdu
recruiter_type
enum<string>[] | null
Available options:
direct,
agency
is_course
boolean
default:false
min_salary
integer | null
Required range: x >= 0
max_salary
integer | null
Required range: x >= 0

Response

Successful Response

id
string
required
url
string
required
@type
string
default:GumtreeAdCard
price
number | null
currency
string
default:GBP
city
string | null
region
string | null
distance
string | null
posted_at
integer | null
status
string | null
category_id
string | null
is_urgent
boolean
default:false
is_standout
boolean
default:false
is_premium
boolean
default:false
has_video
boolean
default:false
seller_id
string | null
is_pro_seller
boolean
default:false
favourite_count
integer | null
attributes
object
image
string | null
images
string[]
image_count
integer | null