ScrapeUnblocker Documentation

The Craigslist Search plugin turns any Craigslist search into structured JSON. Give it a keyword, a metro and a section, and it returns the listings Craigslist shows - each with a posting id, title, numeric price and currency, location, image and a clean listing URL. Filter by price and cap the count with max_results. It runs on the same fetch chain that serves getPageSource. One fetch returns Craigslist’s full gallery (~200 listings), which the plugin merges from the gallery DOM and Craigslist’s own embedded JSON-LD - no Craigslist account needed.

Try it in the dashboard first: app.scrapeunblocker.com/dashboard/plugins. You get a live results view plus a copy-paste snippet.

Endpoint

POST /marketplace/craigslist-search

Field	Required	Notes
`query`	yes	What to search, e.g. `bicycle` or `sofa`.
`site`	no	Metro subdomain, e.g. `newyork`, `sfbay`, `losangeles`, `chicago`. Default `newyork`.
`category`	no	Craigslist section code. Default `sss` (for sale). See the list below.
`min_price` / `max_price`	no	Price range in USD.
`max_results`	no	How many listings to return. Default `120`, max `500`.
`proxy_country`	no	Exit-IP country (ISO-2). Defaults to a US exit.

curl -X POST "https://api.scrapeunblocker.com/marketplace/craigslist-search?query=bicycle&site=sfbay&max_price=500&max_results=200" \
  -H "x-scrapeunblocker-key: YOUR_API_KEY"

Section codes

sss for sale (all, default) · cta cars & trucks · apa apts / housing · jjj jobs Any Craigslist category code is accepted; the list above is just the common ones. site accepts any metro subdomain too, so an unlisted metro is passed straight through.

Response

{
  "query": "bicycle",
  "site": "sfbay",
  "resultsCollected": 120,
  "listings": [
    {
      "pid": "7712345678",
      "title": "Specialized Rockhopper Mountain Bike",
      "url": "https://sfbay.craigslist.org/eby/bik/d/....html",
      "price": 350.0,
      "currency": "USD",
      "location": "oakland",
      "image": "https://images.craigslist.org/....jpg"
    }
  ]
}

Listing fields

Field	Notes
`pid`	Craigslist’s own posting id.
`price` / `currency`	Numeric price and ISO currency (USD), read from the card or the JSON-LD.
`location`	Neighbourhood / city the poster set, when present.
`image`	Listing thumbnail URL.
`url`	Direct listing URL.

Any field with no value is omitted from a listing, so each item carries only the fields Craigslist actually showed (e.g. price, location or image may be absent - many classifieds carry no price).

What you can build

Local marketplace monitoring - watch a category in one metro for new deals.
Price research - pull a whole category’s price distribution across metros.
Lead and inventory sourcing - find sellers and stock in cta (cars) or sss (for sale).
Deal alerts - filter with max_price and re-run to catch fresh listings.

Get Started

No-code area

Spider Cloud

Plugins

AI Assistants

Guides

Code Examples

Craigslist Search plugin

Endpoint

Section codes

Response

Listing fields

What you can build

Next steps

Open the plugins

Get an API key

​Endpoint

​Section codes

​Response

​Listing fields

​What you can build

​Next steps

Open the plugins

Get an API key

Endpoint

Section codes

Response

Listing fields

What you can build

Next steps