App Logo
craigslist.org

Craigslist API: get a Craigslist apartment listing

Automatically get a Craigslist apartment listing on craigslist.org. 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.

Input

url required

The listing's page, e.g. https://www.craigslist.org/view/d/san-francisco-sunny-1br/1xpNaQ2v8YtyoDNKXYd6SQ, as search_housing returns it. The older https://<city>.craigslist.org/.../<post id>.html form works too.

Output

url required

The page as the site resolved it.

found required

false when the listing no longer exists (deleted, expired or removed); every other field is then absent.

body optional

The full description as shown.

price optional

Asking rent as shown, e.g. "$2,100".

title optional
images optional
postId optional
address optional
housing optional

The size line under the title, e.g. "1br - 525ft2".

bedrooms optional
latitude optional
postedAt optional

ISO 8601 with the poster's UTC offset.

bathrooms optional
longitude optional
updatedAt optional

ISO 8601; null when never edited.

attributes optional

Every amenity line, in page order. key is the site's own name for it (laundry, parking, housing_type, pets_cat, pets_dog, is_furnished, rent_period, private_room, private_bath, no_smoking…), null for the headline lines (bedrooms/bathrooms, square feet, availability date).

petsAllowed optional
neighborhood optional

The poster's own location text.

smokingAllowed optional

FAQ

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.
Ask an AI agent connected to Reduck to run reduck/craigslist.org/get_housing_listing, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/craigslist.org/get_housing_listing
You do not need one. "Craigslist API: get a Craigslist apartment listing" drives the real craigslist.org pages in a browser, so it works whether or not craigslist.org offers an API for this.
Required: url.
It returns url, body, found, price, title, images, postId, address, housing, bedrooms, latitude, postedAt, bathrooms, longitude, updatedAt, attributes, petsAllowed, neighborhood, smokingAllowed.
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/get_housing_listing, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/craigslist.org/get_housing_listing
It is part of Reduck's official curated catalogue.

Related scripts

craigslist.org

Craigslist API: search Craigslist apartments for rent

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.

Start building not clicking

Get started for free