App Logo
craigslist.org

Craigslist API: search Craigslist apartments for rent

Automatically search Craigslist apartments for rent on craigslist.org. An unofficial Craigslist scraper API for apartment listings: search apartments, rooms and sublets for rent in any city, newest first, filtered by rent, bedrooms, pets and distance, as data in one call. Run it every few minutes to catch new listings first. Search Craigslist's housing-for-rent listings in any Craigslist city (the SF Bay Area by default, or one part of it such as San Francisco, East Bay or Peninsula), for whole apartments, rooms in shared homes, or sublets. Filter by keywords, rent, bedrooms, bathrooms, square feet, cats or dogs allowed, furnished, listings with photos, listings posted today, and distance from a ZIP code; sort by newest or by price. Each result gives the listing link, title, asking rent, neighborhood, city, bedrooms, bathrooms and map coordinates. One search returns up to the newest few hundred matches and says whether that is all of them; when it is not, narrow the filters to reach the rest. Pass a listing link to get_housing_listing for the full description, address, photos and amenities.

Input

site optional

The Craigslist city, as its web address starts: sfbay (SF Bay Area), newyork, losangeles, seattle, boston, chicago…

Default: "sfbay"
sort optional
Default: "newest"
query optional

Keywords, as typed in the site's search box.

catsOk optional

Only listings that allow cats.

dogsOk optional

Only listings that allow dogs.

maxSqft optional
minSqft optional
subarea optional

One part of the city's area, as Craigslist abbreviates it. For sfbay: sfc (San Francisco), eby (East Bay), pen (Peninsula), sby (South Bay), nby (North Bay), scz (Santa Cruz). Omit for the whole area.

category optional

apartments: whole units for rent. rooms: a room in a shared home. sublets: sublets and temporary stays.

Default: "apartments"
hasImage optional

Only listings with photos.

maxPrice optional

Maximum monthly rent, in the site's currency.

minPrice optional

Minimum monthly rent, in the site's currency.

furnished optional

Only furnished listings.

postalCode optional

ZIP code to measure distance from; use with distanceMiles.

titlesOnly optional

Match the keywords against listing titles only.

maxBedrooms optional
minBedrooms optional
postedToday optional

Only listings posted today.

maxBathrooms optional
minBathrooms optional
distanceMiles optional

Only listings within this many miles of postalCode.

Output

count required
total required

How many listings match on the site, counting reposts of one listing that the site shows once.

complete required

true: every match is in listings. false: only the newest batch came back; narrow the filters to reach the rest.

listings required
searchUrl required

The search page as the site resolved it.

FAQ

An unofficial Craigslist scraper API for apartment listings: search apartments, rooms and sublets for rent in any city, newest first, filtered by rent, bedrooms, pets and distance, as data in one call. Run it every few minutes to catch new listings first. Search Craigslist's housing-for-rent listings in any Craigslist city (the SF Bay Area by default, or one part of it such as San Francisco, East Bay or Peninsula), for whole apartments, rooms in shared homes, or sublets. Filter by keywords, rent, bedrooms, bathrooms, square feet, cats or dogs allowed, furnished, listings with photos, listings posted today, and distance from a ZIP code; sort by newest or by price. Each result gives the listing link, title, asking rent, neighborhood, city, bedrooms, bathrooms and map coordinates. One search returns up to the newest few hundred matches and says whether that is all of them; when it is not, narrow the filters to reach the rest. Pass a listing link to get_housing_listing for the full description, address, photos and amenities.
Ask an AI agent connected to Reduck to run reduck/craigslist.org/search_housing, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/craigslist.org/search_housing
You do not need one. "Craigslist API: search Craigslist apartments for rent" drives the real craigslist.org pages in a browser, so it works whether or not craigslist.org offers an API for this.
Optional: site, sort, query, catsOk, dogsOk, maxSqft, minSqft, subarea, category, hasImage, maxPrice, minPrice, furnished, postalCode, titlesOnly, maxBedrooms, minBedrooms, postedToday, maxBathrooms, minBathrooms, distanceMiles.
It returns count, total, complete, listings, searchUrl.
No. It only uses pages of craigslist.org that are reachable without signing in.
It only reads. It looks things up on craigslist.org and changes nothing there.
Ask an AI agent connected to Reduck to run reduck/craigslist.org/search_housing, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/craigslist.org/search_housing
It is part of Reduck's official curated catalogue.

Related scripts

craigslist.org

Craigslist API: get a Craigslist apartment listing

An unofficial Craigslist API for one apartment listing: address, rent, photos, amenities and the full description as data, from its link. Read one Craigslist housing listing (an apartment, a room or a sublet) from its link, as returned by search_housing. Returns the post id, title, asking rent, the size line (bedrooms and square feet), neighborhood, street address and ZIP code when the poster gave them, map coordinates, bedrooms, bathrooms, whether pets and smoking are allowed, every amenity the listing shows (rent period, laundry, parking, housing type, cats and dogs, furnished, availability date and others), the full description, all photo links, and when it was posted and last updated. A listing that the poster deleted or Craigslist removed comes back as not found rather than as an error. Phone numbers the poster hid behind the site's contact button are not revealed.

Start building not clicking

Get started for free