Craigslist Public Listings API
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.
Endpoint health
Loading verification…
Connect your agent
Connect through MCP so your agent can find this API, read its docs, and call its endpoints.
Add the server from your terminal.
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcpIn 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 keySign 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.
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 · stringCraigslist region slug from regions.
Example: newyork
Response
regionstringcategoriesobject[]categories[].urlstringcategories[].codestringcategories[].namestringsource_urlstringreturned_countintegerGETListing 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 · stringCanonical Craigslist listing URL returned by search-listings.
Example: https://www.craigslist.org/view/d/brooklyn-japan-vista-1978-espada/rEDdBKuy4Y3fNoVZayBXNY
Response
pricenumber | nulltitlestringimagesstring[]post_idstring | nullcurrencystring | nulllocationstring | nullposted_atstring | nullattributesobject[]attributes[].urlstring | nullattributes[].labelstring | nullattributes[].valuestring | nullprice_textstring | nullsource_urlstringupdated_atstring | nullcoordinatesobjectcoordinates.latitudenumbercoordinates.longitudenumberdescription_htmlstringdescription_textstringseller_search_urlstring | nullGETRegions/regions
Retrieve Craigslist's live public region directory. Use a returned slug with categories or search-listings.
Input
No input parameters.
Response
regionsobject[]regions[].urlstringregions[].namestringregions[].slugstringsource_urlstringreturned_countintegerGETSearch 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 · stringCraigslist region slug returned by regions.
Example: newyork
categoryRequiredQuery · stringCraigslist category code returned by categories.
Example: sss
queryOptionalQuery · string | nullOptional Craigslist free-text search phrase.
Example: bike
Response
querystring | nullregionstringcategorystringlistingsobject[]listings[].urlstringlistings[].offerobjectlistings[].offer.amountnumber | nulllistings[].offer.currencystring | nulllistings[].offer.coordinatesobjectlistings[].offer.coordinates.latitudenumberlistings[].offer.coordinates.longitudenumberlistings[].pricenumber | nulllistings[].titlestringlistings[].imagesstring[]listings[].currencystring | nulllistings[].locationstring | nulllistings[].price_textstring | nulllistings[].descriptionstring | nullsource_urlstringtotal_countinteger | nullcontinuationstring | nullreturned_countintegerDon’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.
An account is required to submit an extension. Prepare your request, then sign in to build.