# Craigslist

Best for: Local for-sale classifieds in a city. Category: Retail and marketplaces.

Every Craigslist for-sale result for a search in one city, up to about 350 in one call: title, price and its currency, neighbourhood and the listing link.

- Look up by: Craigslist city (the subdomain, e.g. newyork or sfbay) and search words
- Coverage: Every Craigslist city, in its own currency (USD, CAD, GBP and so on, named on each listing)
- Cost: 2 credits a call; failed and empty calls are free
- Answers: Search, Prices

## Endpoints

- `POST /v1/craigslist/search`: Craigslist search, 2 credits. https://scrapercompany.com/docs/reference/craigslist-search

## Example

Craigslist search (`POST /v1/craigslist/search`):

```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"
  }'
```

## Good to know

- The search page has no description or photo for a listing.
- A page with no results is free.

## Guides

- [Classifieds and handmade](https://scrapercompany.com/docs/guides/vertical-engines#classifieds)

- [All data sources](https://scrapercompany.com/docs/data-sources)