Skip to content
Gridlode
Docs · Reference

Craigslist Listings Search

GET /v1/classifieds/craigslist1 credit / listingcache 30 min

Listings from any Craigslist city site by category and keyword (bikes in austin, cars and trucks in sfbay, apartments in london): title, price, currency, neighbourhood, area, posted date, coordinates, listing URL, images and the attributes Craigslist shows in results (bedrooms and square feet for housing, odometer for vehicles), with price range, picture, posted-today and title-only filters, newest, relevance or price order, up to 360 listings per query (the first batch Craigslist's own search page loads). Read from the public search the signed-out site uses; poster contact details are never collected and phone numbers or e-mail addresses typed into titles are removed. Billed per listing returned; blocked or failed requests are free.

Query parameters

site
string · required
Craigslist city site: the part before .craigslist.org, e.g. 'austin', 'sfbay', 'london'. A URL such as https://austin.craigslist.org also works.
category
string
Craigslist category code: sss all for sale, cta cars & trucks, bia bicycles, fua furniture, ela electronics, apa apartments for rent, hhh all housing, bbb services, ggg gigs, jjj jobs.
Default: "sss"
query
string
Keywords to search for, e.g. 'trek' or 'toyota tacoma'.
Default: null
sort
string
Result order.
Default: "date"
Allowed: date, relevance, price_asc, price_desc
min_price
string
Minimum price.
Default: null
max_price
string
Maximum price.
Default: null
has_image
boolean
Only listings with pictures.
Default: false
posted_today
boolean
Only listings posted today.
Default: false
title_only
boolean
Match the keywords in titles only.
Default: false
limit
integer
Maximum listings to return (1-360).
Default: 50
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

    Example

    curl "https://api.gridlode.com/v1/classifieds/craigslist?site=austin&category=bia&query=trek&limit=20" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the Craigslist Listings Search API page.