# Craigslist API for for-sale listings

> Pass a Craigslist city and search words, and get every result Craigslist shows for that search, up to about 350 in one call: title, price in the local currency, neighbourhood and the listing link.

Canonical page: https://scrapercompany.com/craigslist-api. Endpoints and prices checked against the API on 2026-10-27.

Resellers, price researchers and marketplace builders use Craigslist to see what second-hand goods sell for in a city and how much is on offer. Craigslist does not offer an API for reading its listings. This API reads Craigslist’s public search page for a city and returns each result as JSON, with the price as a number and its currency named.

The city is the Craigslist area name you see in its addresses: newyork, sfbay, chicago, toronto, vancouver, london and so on. One call returns the whole result page, up to about 350 listings for a common search, across the city’s own area (Toronto includes Mississauga and Brampton). Prices come in the city’s currency: USD in US cities, CAD in Canadian ones, GBP in London.

## What you get

- `id, url`: the listing id and its craigslist.org link
- `title`: the listing title as posted
- `price, currency`: the asking price as a number, and the city’s currency (USD, CAD, GBP…)
- `location`: the neighbourhood or town the seller gave
- `total`: how many listings the call returned

## Endpoints and price per call

| Endpoint | Method and path | What it returns | Credits per successful call | Price per call |
| --- | --- | --- | --- | --- |
| [For-sale search](https://scrapercompany.com/docs/reference/craigslist-search) | `POST /v1/craigslist/search` | Every result on the search page for a city and query, up to about 350 | 2 credits | $0.0024 on Starter, $0.0020 on Growth, $0.0016 on Scale, $0.0013 on Business |

Pricing: free trial of 50 calls or 14 days, whichever ends first, no card needed; Starter $49/month for 40,000 credits; Growth $149/month for 150,000 credits; Scale $399/month for 500,000 credits; Business $999/month for 1,500,000 credits; credit packs $15 for 7,500, $60 for 35,000, $200 for 125,000 (valid 12 months). Failed requests (4xx or 5xx) and empty results cost 0 credits. https://scrapercompany.com/pricing

## Example

`POST /v1/craigslist/search`, 2 credits per successful call.

```bash
curl -X POST "https://api.scrapercompany.com/v1/craigslist/search" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "city": "string",
    "query": "string"
  }'
```

Response (trimmed):

```json
{
  "search_parameters": {
    "engine": "craigslist_search",
    "city": "newyork",
    "query": "bike",
    "limit": 100
  },
  "url": "https://newyork.craigslist.org/search/sss?query=bike",
  "total": 1,
  "listings": [
    {
      "id": "iHRAyxVtfScQUpm2w9iEEW",
      "url": "https://www.craigslist.org/view/d/brooklyn-state-track-bike-52cm-small/iHRAyxVtfScQUpm2w9iEEW",
      "title": "State Track Bike 52cm Small",
      "price": 200,
      "currency": "USD",
      "location": "Brooklyn"
    }
  ]
}
```

## FAQ

### Does Craigslist have an API?

Not for reading listings. ScraperCompany is independent of Craigslist: this API reads Craigslist’s public search pages and needs no Craigslist account.

### Which cities can I search?

Any Craigslist area, named as in its address (newyork, sfbay, losangeles, toronto, montreal, london). Results cover the whole area, including the towns Craigslist groups under it.

### How many listings does one call return?

Every result Craigslist shows on the search page: up to about 350 for a common search, fewer for a rare one. Set limit for fewer. It is one call and one price either way.

### Are photos and descriptions included?

Not from the search page, which shows only the title, price and neighbourhood. Kijiji (Canada) adds the address, coordinates, a short description, an image and the posting time, on the same key.

### Do failed requests cost credits?

No. A failed or blocked call (any 4xx or 5xx response) costs 0 credits, and so does a search page that comes back empty. You pay only for successful results.

### How do I get an API key?

Create an account on the sign-up page and verify your email. You get a free trial of 50 calls or 14 days, whichever ends first, no card needed on the travel endpoints (hotels, rentals, flights, reviews); for everything else, and after the trial, buy a credit pack (from $15) or pick a plan. You create and rotate keys yourself in the dashboard.

## Read next

- [E-commerce scraping API](https://scrapercompany.com/ecommerce-scraping-api)
- [Kijiji search reference](https://scrapercompany.com/docs/reference/kijiji-search)
- [Vertical engines guide](https://scrapercompany.com/docs/guides/vertical-engines#classifieds)
- [All APIs](https://scrapercompany.com/apis.md)