# Craigslist For Sale Post Details API

> One Craigslist for-sale post per URL, with item title, price, coordinates, posted date, full description and photos.

- Page: https://cleanedweb.com/catalog/craigslist-for-sale-post-details-api/
- Contract (JSON): https://cleanedweb.com/catalog/craigslist-for-sale-post-details-api/contract.json
- Source: craigslist.org (https://www.craigslist.org/)
- Category: Commerce
- Updated: 2026-11-22

A run reads the one page you name and returns its record; `max_items`, `timeout_seconds` and your budget still bound it.

## Key fields

| Field | Type | Sample value |
| --- | --- | --- |
| `title` | string | `Epiphone inspired by Gibson ES335 - $450 (Portage)` |
| `price` | string | `450.00` |
| `currency` | string | `USD` |
| `description` | string | `On sale!!! Beautiful condition no wear. Been sitting on the stand. These are gr…` |
| `condition` | string | `like new` |
| `url` | string | `https://www.craigslist.org/view/d/portage-epiphone-inspired-by-gibson/j8ZspnBTNzHhQCpzv578sX` |
| `images` | array of string | `https://images.craigslist.org/00l0l_fDcBuiid7cw_0jz0CI_600x450.jpg, https://images.craigslist.org/00w0w_jzbUVqjtizV_0CI0k5_600x450.jpg, https://images.craigslist.org/01616_6dFD8OdTeNk_09G0cU_600x450.jpg, https://images.craigslist.org/00101…` |
| `image` | string | `https://images.craigslist.org/00l0l_fDcBuiid7cw_0jz0CI_600x450.jpg` |

Sample values come from one saved record, not a live run. Every field with its type, and the schemas, are in https://cleanedweb.com/catalog/craigslist-for-sale-post-details-api/contract.json. Some fields the source returns are not published, so a record can carry fields the schema does not list.

## Inputs

- `url` (string, required): Paste the URL of a craigslist.org page of the same kind as the sample: its path looks like /view/d/{slug}/{code}. Any such page works, not only the one the API was built from.

## Request

`POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_5a6ac3f12c9f1054beb88449/endpoints/generated_5a6ac3f12c9f1054beb88449_search/run`

```bash
curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_5a6ac3f12c9f1054beb88449/endpoints/generated_5a6ac3f12c9f1054beb88449_search/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: UNIQUE_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "url": "https://www.craigslist.org/view/d/portage-epiphone-inspired-by-gibson/j8ZspnBTNzHhQCpzv578sX"
  },
  "version": 1,
  "max_items": 25
}'
```

Send an `Idempotency-Key` header with every run and save it before you send. Reuse it only to retry the same request. If the run does not end within `wait_seconds`, read the result with the same API key and key:

`GET https://api.cleanedweb.com/v1/catalog/public/apis/generated_5a6ac3f12c9f1054beb88449/endpoints/generated_5a6ac3f12c9f1054beb88449_search/result`

## Versions

Current: `1.0`. Pin a major with "version": N in the run body (an integer). Leave it out and the call runs on the latest major. A sunset major runs on the latest major and the response says rerouted. An unknown major answers 404 catalog_version_not_found and lists the available majors.

- v1: current, newest minor `1.0`

### Changelog

- `1.0` (major) 2026-11-21

The same changelog, as data, is in https://cleanedweb.com/catalog/craigslist-for-sale-post-details-api/contract.json

## Use it from an AI agent

MCP server: https://api.cleanedweb.com/mcp?profile=catalog (Streamable HTTP). Sign in with a CleanedWeb account when the client asks (OAuth), or send an API key with the `read` and `run` scopes as `Authorization: Bearer`. Call `get_api` with `api_id` `generated_5a6ac3f12c9f1054beb88449`, then `run_api` with the `run_with` arguments it returns. See https://cleanedweb.com/docs/mcp/

## Run it

Reading the catalog needs no credential. Running needs a CleanedWeb account and an API key with the `run` scope; the first 5,000 records are free, then $1 per 1,000 records. See https://cleanedweb.com/docs/run-catalog-api/

CleanedWeb is not affiliated with www.craigslist.org.
