Craigslist
Overview
Classic US classifieds platform — search listings across cities and categories, view listing details, browse category structure. Pure server-rendered HTML, no JS framework.
Workflows
Search and view listings
getCategories(city) → code, name, section per categorysearchListings(category, city, query) → title, price, url, postId- Parse listing
url → extract category, slug, id
getListing(category, slug, id, city) → title, body, price, location, images, attributes
Quick search
searchListings(category, city, query) → title, price, url, postId- Parse
url → category, slug, id → getListing for full details
Operations
| Operation |
Intent |
Key Input |
Key Output |
Notes |
| searchListings |
Search listings by category + keyword |
category (<- getCategories code), city, query |
title, price, url, postId |
entry point; city defaults to sfbay |
| getListing |
Full listing detail |
category, slug, id (<- searchListings url path parts), city |
title, body, price, location, images, attributes |
|
| getCategories |
List category codes |
city |
name, code, section |
entry point; homepage category links |
Quick Start
# Search SF apartments
openweb craigslist exec searchListings '{"category": "apa", "city": "sfbay", "query": "2br"}'
# Search NYC jobs
openweb craigslist exec searchListings '{"category": "jjj", "city": "newyork"}'
# Get listing details
openweb craigslist exec getListing '{"category": "apa", "slug": "sunny-2br-mission", "id": "7891234567", "city": "sfbay"}'
# Browse categories
openweb craigslist exec getCategories '{"city": "sfbay"}'
Common Category Codes
apa — apartments/housing for rentroo — rooms/sharedrea — real estate for salejjj — jobssss — all for-saleccc — communityggg — gigsbbb — services offered
1---2name: craigslist3description: Craigslist4---5# Craigslist67## Overview8Classic US classifieds platform — search listings across cities and categories, view listing details, browse category structure. Pure server-rendered HTML, no JS framework.910## Workflows1112### Search and view listings131. `getCategories(city)` → `code`, `name`, `section` per category142. `searchListings(category, city, query)` → `title`, `price`, `url`, `postId`153. Parse listing `url` → extract `category`, `slug`, `id`164. `getListing(category, slug, id, city)` → `title`, `body`, `price`, `location`, `images`, `attributes`1718### Quick search191. `searchListings(category, city, query)` → `title`, `price`, `url`, `postId`202. Parse `url` → `category`, `slug`, `id` → `getListing` for full details2122## Operations2324| Operation | Intent | Key Input | Key Output | Notes |25|-----------|--------|-----------|------------|-------|26| searchListings | Search listings by category + keyword | category (<- getCategories `code`), city, query | title, price, url, postId | **entry point**; city defaults to sfbay |27| getListing | Full listing detail | category, slug, id (<- searchListings `url` path parts), city | title, body, price, location, images, attributes | |28| getCategories | List category codes | city | name, code, section | **entry point**; homepage category links |2930## Quick Start3132```bash33# Search SF apartments34openweb craigslist exec searchListings '{"category": "apa", "city": "sfbay", "query": "2br"}'3536# Search NYC jobs37openweb craigslist exec searchListings '{"category": "jjj", "city": "newyork"}'3839# Get listing details40openweb craigslist exec getListing '{"category": "apa", "slug": "sunny-2br-mission", "id": "7891234567", "city": "sfbay"}'4142# Browse categories43openweb craigslist exec getCategories '{"city": "sfbay"}'44```4546### Common Category Codes47- `apa` — apartments/housing for rent48- `roo` — rooms/shared49- `rea` — real estate for sale50- `jjj` — jobs51- `sss` — all for-sale52- `ccc` — community53- `ggg` — gigs54- `bbb` — services offered
spike-faye-lei