Skip to main content
POST
/craigslist/postings/search

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
area
string
required
Minimum string length: 1
count
integer
required
Required range: 1 <= x <= 10000
timeout
integer
default:300
Required range: 20 <= x <= 1500
category
string
default:sss
keyword
string | null
subarea
string | null
sort
enum<string>
default:newest
Available options:
newest,
oldest,
price_asc,
price_desc,
distance,
relevance,
upcoming
postal
string | null
lat
number | null
Required range: -90 <= x <= 90
lon
number | null
Required range: -180 <= x <= 180
radius
number | null
Required range: x >= 0
min_price
number | null
Required range: x >= 0
max_price
number | null
Required range: x >= 0
free
boolean
default:false
purveyor
enum<string> | null
Available options:
all,
owner,
dealer
titles_only
boolean
default:false
has_image
boolean
default:false
posted_today
boolean
default:false
hide_duplicates
boolean
default:false
crypto_ok
boolean
default:false
delivery_available
boolean
default:false
language
enum<string>[]
Available options:
afrikaans,
catala,
dansk,
deutsch,
english,
espanol,
suomi,
francais,
italiano,
nederlands,
norsk,
portugues,
svenska,
filipino,
turkce,
chinese,
arabic,
japanese,
korean,
russian,
vietnamese
condition
enum<string>[]
Available options:
new,
like_new,
excellent,
good,
fair,
salvage
make_model
string | null
min_auto_year
integer | null
Required range: x >= 0
max_auto_year
integer | null
Required range: x >= 0
min_auto_miles
integer | null
Required range: x >= 0
max_auto_miles
integer | null
Required range: x >= 0
min_monthly_payment
number | null
Required range: x >= 0
max_monthly_payment
number | null
Required range: x >= 0
transmission
enum<string>[]
Available options:
manual,
automatic,
other
drivetrain
enum<string>[]
Available options:
fwd,
rwd,
4wd
fuel_type
enum<string>[]
Available options:
gas,
diesel,
hybrid,
electric,
other
title_status
enum<string>[]
Available options:
clean,
salvage,
rebuilt,
parts_only,
lien,
missing
body_type
enum<string>[]
Available options:
bus,
convertible,
coupe,
hatchback,
minivan,
offroad,
pickup,
sedan,
truck,
suv,
wagon,
van,
other
paint
enum<string>[]
Available options:
black,
blue,
brown,
green,
grey,
orange,
purple,
red,
silver,
white,
yellow,
custom
cylinders
enum<string>[]
Available options:
3,
4,
5,
6,
8,
10,
12,
other
min_engine_displacement_cc
integer | null
Required range: x >= 0
max_engine_displacement_cc
integer | null
Required range: x >= 0
motorcycle_motor
enum<string>[]
Available options:
gas,
electric,
other
motorcycle_type
enum<string>[]
Available options:
adventure,
bobber,
cafe_racer,
chopper,
cruiser,
dirtbike,
dual_sport,
scooter_moped,
sport_bike,
sport_touring,
standard,
touring,
trike,
other
min_boat_length
number | null
Required range: x >= 0
max_boat_length
number | null
Required range: x >= 0
min_year_manufactured
integer | null
Required range: x >= 0
max_year_manufactured
integer | null
Required range: x >= 0
boat_propulsion
enum<string>[]
Available options:
sail,
power,
human
boat_type
enum<string>[]
Available options:
commercial_boat,
houseboat,
kayak_canoe_sup,
luxury_classic_yacht,
personal_watercraft,
pontoon_boat,
powerboat,
rowboat,
rowing_shell,
sailboat,
ski_boat,
small_outboard_fishing,
trawler,
other
min_bedrooms
integer | null
Required range: x >= 0
max_bedrooms
integer | null
Required range: x >= 0
min_bathrooms
number | null
Required range: x >= 0
max_bathrooms
number | null
Required range: x >= 0
min_sqft
integer | null
Required range: x >= 0
max_sqft
integer | null
Required range: x >= 0
housing_features
enum<string>[]
Available options:
cats_ok,
dogs_ok,
furnished,
no_smoking,
wheelchair_accessible,
air_conditioning,
ev_charging,
no_broker_fee,
no_application_fee,
private_room,
private_bath
rent_period
enum<string>[]
Available options:
daily,
weekly,
monthly
availability
enum<string> | null
Available options:
all,
within_30_days,
beyond_30_days
housing_type
enum<string>[]
Available options:
apartment,
condo,
cottage_cabin,
duplex,
flat,
house,
in_law,
loft,
townhouse,
manufactured,
assisted_living,
land
laundry
enum<string>[]
Available options:
in_unit,
hookups,
in_building,
on_site,
none
parking
enum<string>[]
Available options:
carport,
attached_garage,
detached_garage,
off_street,
street,
valet,
none
employment_type
enum<string>[]
Available options:
full_time,
part_time,
contract,
employees_choice
is_internship
boolean
default:false
is_nonprofit
boolean
default:false
is_telecommuting
boolean
default:false
is_paid
enum<string> | null
Available options:
all,
paid,
unpaid
lost_or_found
enum<string>[]
Available options:
lost,
found
event_types
enum<string>[]
Available options:
food_drink,
competition,
tech,
festival,
sustainability,
art_film,
singles,
fitness_health,
career,
outdoor,
sale,
free,
music,
charitable,
dance,
kid_friendly,
literary

Response

Successful Response

id
string
required
posting_id
integer
required
@type
string
default:CraigslistPostingCard
posting_title
string | null
alias
string | null
url
string | null
price
number | null
price_string
string | null
currency
string | null
monthly_payment_string
string | null
created_at
integer | null
category_id
integer | null
category_alias
string | null
category
string | null
location
object | null
image
string | null
images
string[]
image_count
integer
default:0
bedrooms
number | null
sqft
number | null
auto_miles
number | null
salary
string | null
company
string | null
job_title
string | null
start_date
string | null
end_date
string | null
open_house_dates
string[]
event_dates
string[]