# Craigslist Posting Detail API Documentation

Retrieve a single Craigslist posting by its 22-character id: title, url, price and currency, plain-text description, category, posting time and last update time (ISO 8601 UTC), attribute pairs such as condition or size, all images and an approximate location with coordinates. Street addresses and all contact data are never returned, and phone numbers and email addresses inside the description text are replaced by [redacted]. An unknown or expired posting returns a not billable 404.

- **Documentation:** [https://scrappa.co/docs/craigslist-api/craigslist_posting](https://scrappa.co/docs/craigslist-api/craigslist_posting)
- **API group:** Craigslist API
- **Endpoint:** `GET https://scrappa.co/api/craigslist/posting`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | Yes | The 22-character posting id from the search results. Example: g5tuoYXMyVFFgpXzYbiXMq. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/craigslist/posting?id=g5tuoYXMyVFFgpXzYbiXMq"
```

## Example response

```json
{
    "success": true,
    "data": {
        "posting": {
            "id": "g5tuoYXMyVFFgpXzYbiXMq",
            "posting_id": 7946124093,
            "title": "LeMond Greg Lemond Road Bike 55cm ((( REDUCED )))",
            "url": "https://www.craigslist.org/view/g5tuoYXMyVFFgpXzYbiXMq",
            "price": 200,
            "description": "Estate Sale Find Nice Bike ..... FIRST CALL With 300.00 CASH Takes Home .....Excellent Riding Bike ! .. Fits Rider 5\"4 - 5\" 8 ... CALL or Text If Local Only ... Thanks",
            "category": "bicycles - by owner",
            "category_code": "bik",
            "posted_at": "2026-07-09T17:56:11Z",
            "updated_at": "2026-10-15T19:19:12Z",
            "attributes": [
                {
                    "label": "bicycle type",
                    "value": "road"
                },
                {
                    "label": "frame size",
                    "value": "55cm"
                },
                {
                    "label": "wheel size",
                    "value": "700C"
                },
                {
                    "label": "condition",
                    "value": "excellent"
                },
                {
                    "label": "make / manufacturer",
                    "value": "Lemonds"
                },
                {
                    "label": "model name / number",
                    "value": "Road Bike"
                }
            ],
            "images": [
                "https://images.craigslist.org/00f0f_52oL7PFWTmc_0CI0lN_600x450.jpg",
                "https://images.craigslist.org/00o0o_7s8PevWIQe8_0CI0lN_600x450.jpg",
                "https://images.craigslist.org/00505_jFRAv7Cqove_0lN0CI_600x450.jpg",
                "https://images.craigslist.org/00y0y_bKnHO1Cve0_0lN0CI_600x450.jpg",
                "https://images.craigslist.org/00M0M_ioRjf0szqmB_09G06h_600x450.jpg"
            ],
            "location": {
                "name": "Tigard",
                "site": "portland",
                "subarea": "wsc",
                "latitude": 45.4403,
                "longitude": -122.7793
            }
        }
    },
    "meta": {
        "endpoint_family": "posting",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable. |
| 404 | Resource Not Found | The posting id is unknown or the posting has expired. This response is not billable. |
| 502 | Invalid Source Response | Craigslist answered with a shape that no longer matches the documented contract. This response is not billable. |
| 503 | Service Unavailable | The upstream service is temporarily unavailable. Please retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)