Skip to main content
POST
Craigslist Postings Search

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
area
string
required

Area. e.g. sfbay

keyword
string

Search term (optional). e.g. bike

category
string

Category (optional). e.g. sss

max_items
integer
default:25

Max items (up to 500)

Required range: 1 <= x <= 500
start_page
integer
default:1

Starting page

Required range: x >= 1
subarea
string

Sub-area. e.g. sfc

sort
enum<string>

Sort by. Options: oldest = Oldest, price_asc = Price: low to high, price_desc = Price: high to low, distance = Distance, relevance = Relevance, upcoming = Upcoming

Available options:
oldest,
price_asc,
price_desc,
distance,
relevance,
upcoming
purveyor
enum<string>

Sold by. Options: all = All, owner = Owner, dealer = Dealer

Available options:
all,
owner,
dealer
min_price
number

Price (min)

max_price
number

Price (max)

condition
enum<string>[]

Condition

Available options:
new,
like new,
excellent,
good,
fair,
salvage
language
enum<string>[]

Posting language

Available options:
afrikaans,
català,
dansk,
deutsch,
english,
español,
suomi,
français,
italiano,
nederlands,
norsk,
português,
svenska,
filipino,
türkçe,
中文,
العربية,
日本語,
한국말,
русский,
tiếng việt
free
boolean

Free items only

titles_only
boolean

Search titles only

has_image
boolean

Has image

posted_today
boolean

Posted today

hide_duplicates
boolean

Hide duplicates

crypto_ok
boolean

Crypto accepted

delivery_available
boolean

Delivery available

postal
string

Postal code. e.g. 94103

lat
number

Latitude

lon
number

Longitude

radius
number

Radius (miles)

make_model
string

Make and model. e.g. honda civic

min_auto_year
number

Model year (min)

max_auto_year
number

Model year (max)

min_auto_miles
number

Odometer (min)

max_auto_miles
number

Odometer (max)

min_monthly_payment
number

Monthly payment (min)

max_monthly_payment
number

Monthly payment (max)

transmission
enum<string>[]

Transmission

Available options:
manual,
automatic,
other
drivetrain
enum<string>[]

Drivetrain

Available options:
fwd,
rwd,
4wd
fuel_type
enum<string>[]

Fuel

Available options:
gas,
diesel,
hybrid,
electric,
other
title_status
enum<string>[]

Title status

Available options:
clean,
salvage,
rebuilt,
parts only,
lien,
missing
body_type
enum<string>[]

Body type

Available options:
bus,
convertible,
coupe,
hatchback,
minivan,
offroad,
pickup,
sedan,
truck,
SUV,
wagon,
van,
other
paint
enum<string>[]

Paint color

Available options:
black,
blue,
brown,
green,
grey,
orange,
purple,
red,
silver,
white,
yellow,
custom
cylinders
enum<string>[]

Cylinders

Available options:
3 cylinders,
4 cylinders,
5 cylinders,
6 cylinders,
8 cylinders,
10 cylinders,
12 cylinders,
other
min_engine_displacement_cc
number

Engine displacement, cc (min)

max_engine_displacement_cc
number

Engine displacement, cc (max)

Street legal only

motorcycle_motor
enum<string>[]

Motor

Available options:
gas,
electric,
other
motorcycle_type
enum<string>[]

Type

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

Length overall (min)

max_boat_length
number

Length overall (max)

min_year_manufactured
number

Year manufactured (min)

max_year_manufactured
number

Year manufactured (max)

boat_propulsion
enum<string>[]

Propulsion

Available options:
sail,
power,
human
boat_type
enum<string>[]

Boat type

Available options:
other,
commercial boat,
houseboat,
kayak/canoe/SUP,
luxury/classic yacht,
personal watercraft (jet ski),
pontoon boat,
powerboat,
rowboat,
rowing shell,
sailboat,
ski boat,
small outboard/fishing,
trawler
min_bedrooms
number

Bedrooms (min)

max_bedrooms
number

Bedrooms (max)

min_bathrooms
number

Bathrooms (min)

max_bathrooms
number

Bathrooms (max)

min_sqft
number

Area, sq ft (min)

max_sqft
number

Area, sq ft (max)

availability
enum<string>

Move-in availability. Options: all = All dates, within_30_days = Within 30 days, beyond_30_days = Beyond 30 days

Available options:
all,
within_30_days,
beyond_30_days
rent_period
enum<string>[]

Rent period

Available options:
daily,
weekly,
monthly
housing_type
enum<string>[]

Housing type

Available options:
apartment,
condo,
cottage/cabin,
duplex,
flat,
house,
in-law,
loft,
townhouse,
manufactured,
assisted living,
land
laundry
enum<string>[]

Laundry

Available options:
w/d in unit,
w/d hookups,
laundry in bldg,
laundry on site,
no laundry on site
parking
enum<string>[]

Parking

Available options:
carport,
attached garage,
detached garage,
off-street parking,
street parking,
valet parking,
no parking
housing_features
enum<string>[]

Required features

Available options:
cats ok,
dogs ok,
furnished,
no smoking,
wheelchair accessible,
air conditioning,
EV charging,
no application fee,
no broker fee
employment_type
enum<string>[]

Employment type

Available options:
full-time,
part-time,
contract,
employee's choice
is_internship
boolean

Internships only

is_nonprofit
boolean

Non-profit employers only

is_telecommuting
boolean

Telecommuting allowed

is_paid
enum<string>

Gig pay. Options: all = All, paid = Paid, unpaid = Unpaid

Available options:
all,
paid,
unpaid
lost_or_found
enum<string>[]

Lost or found

Available options:
lost,
found
event_types
enum<string>[]

Event types

Available options:
food/drink,
art/film,
career,
tech,
free,
fitness/health,
competition,
fest/fair,
kid friendly,
singles,
charitable,
outdoor,
dance,
literary,
sale,
sustainability,
music

Response

Run completed.

session_id
string

Session identifier for this run.

kind
string

Data source identifier for this endpoint.

area
string
category
string
subarea
any
keyword
any
sort
string
max_items
integer
start_page
integer
hide_duplicates
boolean
filters
object
partial
boolean

True when the scrape stopped early and returned the records collected so far.

human
string

Markdown summary of the result, for display.

machine
object

Structured result payload.

total_points
integer

Points charged for this run.