# Craigslist API: Get listing details

> Gets the public details of a Craigslist listing from its link. Deleted or expired listings are not returned, and hidden contact details are not included.

Unofficial. Not affiliated with or endorsed by Craigslist.

- Page: https://fous.com/methods/craigslist.org/get-listing
- Method: `craigslist.org/get_listing`, version 2
- Website: craigslist.org
- Returns: title, price, currency, description, neighbourhood, city area, dates, attributes, photos, map link, posting ID
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `listing` | string | yes | `"https://sfbay.craigslist.org/sfc/bik/d/san-francisco-kids-bike-accessories/7942706789.html"` | Link to the Craigslist listing, for example https://sfbay.craigslist.org/sfc/bik/d/san-francisco-kids-bike-accessories/7942706789.html. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "listing": "https://sfbay.craigslist.org/sfc/bik/d/san-francisco-kids-bike-accessories/7942706789.html"
}
```

Its output:

```json
{
  "price": 1,
  "title": "Kid's Bike Accessories",
  "currency": "USD",
  "map_link": "https://www.google.com/maps/search/37.735400,-122.457100",
  "city_area": "san francisco",
  "attributes": [
    {
      "name": "bicycle type",
      "value": "mountain"
    },
    {
      "name": "frame size",
      "value": "Medium, 24"
    },
    {
      "name": "suspension",
      "value": "suspension fork (hardtail)"
    }
  ],
  "posting_id": "7942706789",
  "description": "Kid's bike stuff:\n\nRear Cargo rack - $10 (OBO) - Includes sweet rear light (needs batteries, and probably works)\n\nTraining wheels - $Free with purchase\n\nTag along bike, trailer bike, trailer cycle (whatever you call it) - $45\n\nTag along bikes, trailer bikes, trailer cycles – whatever you call them, …",
  "photo_links": [
    "https://images.craigslist.org/00f0f_bIKkHm3BM6i_1320MM_600x450.jpg",
    "https://images.craigslist.org/00909_4qelc7yarjT_0MM132_600x450.jpg",
    "https://images.craigslist.org/00404_7BpgJvtEfcY_0MM132_600x450.jpg"
  ],
  "posted_date": "2026-06-22",
  "listing_link": "https://www.craigslist.org/view/d/san-francisco-kids-bike-accessories/j8LWNyjdpdnn47hU79WaM9",
  "updated_date": "2026-10-21",
  "neighbourhood": "west portal / forest hill"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"craigslist.org/get_listing","input":{"listing":"https://sfbay.craigslist.org/sfc/bik/d/san-francisco-kids-bike-accessories/7942706789.html"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What's the asking price and full description for this listing? https://seattle.craigslist.org/see/fuo/d/seattle-mid-century-walnut-dresser/7951234876.html
- Pull the photos, posting date, and neighborhood for https://chicago.craigslist.org/chc/apa/d/chicago-sunny-2br-logan-square/7948812230.html
- Can you check this Craigslist ad and tell me the bike's attributes like frame size and condition? https://portland.craigslist.org/mlt/bik/d/portland-trek-fx3-hybrid/7955019342.html
- I need the title, price, and map link for this used car post: https://denver.craigslist.org/cto/d/aurora-2014-honda-civic-ex/7953377105.html
- Get me the posting ID, when it was last updated, and what area of town this Craigslist rental is in: https://newyork.craigslist.org/brk/roo/d/brooklyn-room-in-bushwick-loft/7949960418.html

## Input schema

```json
{
  "type": "object",
  "required": [
    "listing"
  ],
  "properties": {
    "listing": {
      "type": "string",
      "description": "Link to the Craigslist listing, for example https://sfbay.craigslist.org/sfc/bik/d/san-francisco-kids-bike-accessories/7942706789.html."
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "title",
    "price",
    "currency",
    "description",
    "neighbourhood",
    "city_area",
    "posted_date",
    "updated_date",
    "attributes",
    "photo_links",
    "map_link",
    "listing_link",
    "posting_id"
  ],
  "properties": {
    "price": {
      "type": [
        "number",
        "null"
      ],
      "description": "Listed price, or null if none."
    },
    "title": {
      "type": "string",
      "description": "Listing title."
    },
    "currency": {
      "type": [
        "string",
        "null"
      ],
      "description": "Three-letter currency code, or null if no currency is shown."
    },
    "map_link": {
      "type": [
        "string",
        "null"
      ],
      "description": "Map location link when a map is shown."
    },
    "city_area": {
      "type": [
        "string",
        "null"
      ],
      "description": "Local Craigslist city or area shown in the listing navigation, when available."
    },
    "attributes": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "value"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "description": "Public listing characteristics."
    },
    "posting_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "Craigslist posting ID.",
      "x-fous-developer": true
    },
    "description": {
      "type": "string",
      "description": "Full publicly displayed listing description as plain text."
    },
    "photo_links": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Full-sized listing photo links."
    },
    "posted_date": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "Date the listing was posted."
    },
    "listing_link": {
      "type": "string",
      "description": "Public listing page link."
    },
    "updated_date": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "Date the listing was last updated, when shown."
    },
    "neighbourhood": {
      "type": [
        "string",
        "null"
      ],
      "description": "Neighbourhood shown with the listing title, when available."
    }
  },
  "additionalProperties": false
}
```

## See more

- [Craigslist API: Search listings](https://fous.com/methods/craigslist.org/search-listings.md): Searches public Craigslist listings in a city or area, newest first. Renewed listings may have older original posting dates.
- [eBay API: Get listing details](https://fous.com/methods/ebay.com/get-listing.md): Gets the full public details of an eBay listing by link or item number: price, sale type, bids, condition, shipping, delivery, returns, location, item specifics, the seller's description, photos, seller and listing status. Shipping and delivery text may vary by destination; unavailable details are null.
- [Airbnb API: Get listing](https://fous.com/methods/airbnb.com/get-listing.md): Gets public details for one Airbnb listing from its link. When dates are given, it also returns dated prices and cancellation terms if Airbnb offers a quote.
- [Realtor.com API: Get home details](https://fous.com/methods/realtor.com/get-home.md): Gets a home's details from Realtor.com by street address or Realtor.com property link: status, list price, value estimate, beds, baths, size, year built, HOA fee, property and tax history, nearby schools, flood risk and photos.
- [Homes.com API: Search homes for sale](https://fous.com/methods/homes.com/search-homes.md): Searches Homes.com homes for sale in a US city, neighborhood, or ZIP code, with optional price, bedroom, bathroom and home type filters. Returns listings in site order; days on market is null when not shown.
- [Realtor.com API: Search homes](https://fous.com/methods/realtor.com/search-homes.md): Searches Realtor.com homes for sale, for rent, or recently sold in a city, neighborhood or ZIP code, with optional price, bedroom, bathroom and home type filters and sort order. Rentals with price ranges use the lowest advertised rent; withheld sold prices are blank.
- [OfferUp API: Search listings](https://fous.com/methods/offerup.com/search-listings.md): Finds OfferUp items for sale near a US city or ZIP code, with prices, condition, seller names, distance and links. Distances use approximate listing locations.
- [Zillow API: Search homes for sale](https://fous.com/methods/zillow.com/search-homes.md): Searches Zillow homes for sale in a city and state, neighborhood or ZIP code, with optional price, bedroom, bathroom and property type filters and sort order, from Zillow's public search pages (up to 100 listings).
- [All Craigslist methods](https://fous.com/methods/craigslist.org.md)