Catalog / Craigslist Public Listings

Craigslist Public Listings API

craigslist.org

Read-only access to Craigslist's anonymous public market directory, category links, search result records, and individual listing pages. Start with regions, select a region and category, search listings, then pass a returned canonical URL to listing-detail. Posting, account, favorites, messaging, and other state-changing or authenticated flows are intentionally not exposed. Prices are preserved as displayed and parsed only when numeric.

  • Other
  • craigslist
  • classifieds
  • listings
  • search
  • public-data
4 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.

Then ask your agent to use the Craigslist Public Listings API for your task.

Call it over HTTP

Get an API key

Sign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.

Read the category links actually published on a selected region page; codes are source values, not a universal hard-coded enum.

Craigslist region slug from regions.

View call pricing
cURL · Categories
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/05423231-eb77-4832-aa0f-4b38ba0bebfe/categories' \
  --header "Authorization: Bearer $AGENT_DATA_API_KEY" \
  --data-urlencode 'region=newyork'

Endpoints

Inputs and response fields for every endpoint in this API.

GETCategories/categories

Read the category links actually published on a selected region page; codes are source values, not a universal hard-coded enum.

Input

regionRequiredQuery · string

Craigslist region slug from regions.

Example: newyork

Response

regionstring
categoriesobject[]
categories[].urlstring
categories[].codestring
categories[].namestring
source_urlstring
returned_countinteger
GETListing detail/listing-detail

Retrieve the full public listing page for a canonical URL returned by search-listings. This is caller-invoked detail retrieval and is never hidden inside search.

Input

urlRequiredQuery · string

Canonical Craigslist listing URL returned by search-listings.

Example: https://www.craigslist.org/view/d/brooklyn-japan-vista-1978-espada/rEDdBKuy4Y3fNoVZayBXNY

Response

pricenumber | null
titlestring
imagesstring[]
post_idstring | null
currencystring | null
locationstring | null
posted_atstring | null
attributesobject[]
attributes[].urlstring | null
attributes[].labelstring | null
attributes[].valuestring | null
price_textstring | null
source_urlstring
updated_atstring | null
coordinatesobject
coordinates.latitudenumber
coordinates.longitudenumber
description_htmlstring
description_textstring
seller_search_urlstring | null
GETRegions/regions

Retrieve Craigslist's live public region directory. Use a returned slug with categories or search-listings.

Input

No input parameters.

Response

regionsobject[]
regions[].urlstring
regions[].namestring
regions[].slugstring
source_urlstring
returned_countinteger
GETSearch listings/search-listings

Fetch one live Craigslist result page for a region/category and optional free-text query. The response contains only records on that source page; total_count and continuation remain null when Craigslist does not declare them.

Input

regionRequiredQuery · string

Craigslist region slug returned by regions.

Example: newyork

categoryRequiredQuery · string

Craigslist category code returned by categories.

Example: sss

queryOptionalQuery · string | null

Optional Craigslist free-text search phrase.

Example: bike

Response

querystring | null
regionstring
categorystring
listingsobject[]
listings[].urlstring
listings[].offerobject
listings[].offer.amountnumber | null
listings[].offer.currencystring | null
listings[].offer.coordinatesobject
listings[].offer.coordinates.latitudenumber
listings[].offer.coordinates.longitudenumber
listings[].pricenumber | null
listings[].titlestring
listings[].imagesstring[]
listings[].currencystring | null
listings[].locationstring | null
listings[].price_textstring | null
listings[].descriptionstring | null
source_urlstring
total_countinteger | null
continuationstring | null
returned_countinteger

Don’t see the endpoint you need?

Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.