# Craigslist API: Search listings > Searches public Craigslist listings in a city or area, newest first. Renewed listings may have older original posting dates. Unofficial. Not affiliated with or endorsed by Craigslist. - Page: https://fous.com/methods/craigslist.org/search-listings - Method: `craigslist.org/search_listings`, version 1 - Website: craigslist.org - Returns: title, price, currency, neighbourhood, posted date, photo, link, posting id - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `area` | string | yes | `"San Francisco Bay Area"` | Craigslist city or area, such as San Francisco Bay Area or Chicago. | | `query` | string | yes | `"road bike"` | Words to search for, such as road bike. | | `category` | string | no | | Listing category, such as for_sale or housing. One of "for_sale", "housing", "jobs", "services", "cars_and_trucks", "gigs". Default "for_sale". | | `max_price` | number | no | | Highest price in local currency, such as 500. Leave empty for no maximum. | | `min_price` | number | no | | Lowest price in local currency, such as 100. Leave empty for no minimum. | | `max_results` | integer | no | | Most listings to return, such as 25. Default 25. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "area": "San Francisco Bay Area", "query": "road bike" } ``` Its output: ```json { "listings": [ { "price": 395, "title": "Specialized road bike", "photo_link": "https://images.craigslist.org/00u0u_973m0oItohK_0CI0t2_600x450.jpg", "posting_id": "7974087135", "posted_date": "2026-09-27", "listing_link": "https://www.craigslist.org/view/d/emeryville-specialized-road-bike/gGcjrby4x8iNiWu7ephyBo", "currency_code": "USD", "neighbourhood": "Oakland" }, { "price": 390, "title": "Specialized road bike", "photo_link": "https://images.craigslist.org/00L0L_9kLQq04wmQ7_0CI0t2_600x450.jpg", "posting_id": "7966025037", "posted_date": "2026-09-13", "listing_link": "https://www.craigslist.org/view/d/emeryville-specialized-road-bike/dtuVsLD7RNkzraDrjzfJ5w", "currency_code": "USD", "neighbourhood": "Berkeley" }, { "price": 2600, "title": "talaria mx 4 sting for sale", "photo_link": "https://images.craigslist.org/00b0b_lqrVCOkA7FP_1320MM_600x450.jpg", "posting_id": "7949673589", "posted_date": "2026-07-26", "listing_link": "https://www.craigslist.org/view/d/rio-vista-talaria-mx-sting-for-sale/jCzJUuAh3bgbdGYqGB9RNx", "currency_code": "USD", "neighbourhood": "brentwood / oakley" } ], "area_used": "SF bay area" } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"craigslist.org/search_listings","input":{"area":"San Francisco Bay Area","query":"road bike"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Find me 10 listings for used road bikes under 400 dollars in Chicago, newest first - Show cheap apartments for rent in the San Francisco Bay Area between 1000 and 2000 dollars - Look up for-sale listings of standing desks in Austin with a 150 dollar cap - Any craigslist gigs for graphic design work in Seattle posted recently? - I need up to 50 cars and trucks listings in Denver priced from 3000 to 8000 dollars ## Input schema ```json { "type": "object", "required": [ "query", "area" ], "properties": { "area": { "type": "string", "minLength": 1, "description": "Craigslist city or area, such as San Francisco Bay Area or Chicago." }, "query": { "type": "string", "minLength": 1, "description": "Words to search for, such as road bike." }, "category": { "enum": [ "for_sale", "housing", "jobs", "services", "cars_and_trucks", "gigs" ], "type": "string", "default": "for_sale", "description": "Listing category, such as for_sale or housing." }, "max_price": { "type": "number", "minimum": 0, "description": "Highest price in local currency, such as 500. Leave empty for no maximum." }, "min_price": { "type": "number", "minimum": 0, "description": "Lowest price in local currency, such as 100. Leave empty for no minimum." }, "max_results": { "type": "integer", "default": 25, "maximum": 100, "minimum": 1, "description": "Most listings to return, such as 25." } } } ``` ## Output schema ```json { "type": "object", "required": [ "area_used", "listings" ], "properties": { "listings": { "type": "array", "items": { "type": "object", "properties": { "price": { "type": [ "number", "null" ] }, "title": { "type": "string" }, "photo_link": { "type": [ "string", "null" ] }, "posting_id": { "type": [ "string", "null" ] }, "posted_date": { "type": [ "string", "null" ] }, "listing_link": { "type": "string" }, "currency_code": { "type": [ "string", "null" ] }, "neighbourhood": { "type": [ "string", "null" ] } } } }, "area_used": { "type": "string" } } } ``` ## See more - [Craigslist API: Get listing details](https://fous.com/methods/craigslist.org/get-listing.md): Gets the public details of a Craigslist listing from its link. Deleted or expired listings are not returned, and hidden contact details are not included. - [OfferUp API: Search listings](https://fous.com/methods/offerup.com/search-listings.md): Finds OfferUp items for sale near a US city or ZIP code, with prices, condition, seller names, distance and links. Distances use approximate listing locations. - [CARFAX API: Search used cars](https://fous.com/methods/carfax.com/search-cars.md): Searches CARFAX used-car listings for a make and model near a US ZIP code, in CARFAX order, with listing details and free vehicle-history highlights. Paid full history reports are not included. - [Cars.com API: Search listings](https://fous.com/methods/cars.com/search-cars.md): Searches Cars.com car listings for a make and model around a US ZIP code within a radius, optionally by condition (new, used or certified pre-owned) and maximum price, in Cars.com search order. - [CarGurus API: Search cars for sale](https://fous.com/methods/cargurus.com/search-cars.md): Searches new and used cars for sale near a US ZIP code for a make and model, with prices, dealer details and CarGurus deal ratings. Used cars come first, then new cars, each in CarGurus order; market difference is positive below market and negative above. - [Autotrader API: Search cars](https://fous.com/methods/autotrader.com/search-cars.md): Searches Autotrader car listings near a US ZIP code by make and model, with condition, price, year and distance filters. Returns up to 100 listings in site order. - [Realtor.com API: Search homes](https://fous.com/methods/realtor.com/search-homes.md): Searches Realtor.com homes for sale, for rent, or recently sold in a city, neighborhood or ZIP code, with optional price, bedroom, bathroom and home type filters and sort order. Rentals with price ranges use the lowest advertised rent; withheld sold prices are blank. - [Zillow API: Search homes for sale](https://fous.com/methods/zillow.com/search-homes.md): Searches Zillow homes for sale in a city and state, neighborhood or ZIP code, with optional price, bedroom, bathroom and property type filters and sort order, from Zillow's public search pages (up to 100 listings). - [All Craigslist methods](https://fous.com/methods/craigslist.org.md)