losangeles.craigslist.org APIlosangeles.craigslist.org ↗
Search and retrieve Craigslist LA listings by keyword, price, category, and ZIP code. Access full listing details including description, geo, images, and attributes.
curl -X GET 'https://api.parse.bot/scraper/45a8c020-22bf-42e8-8b66-2b14e04077d8/search_listings?limit=5&query=laptop' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for listings across all categories on Craigslist Los Angeles. Returns paginated results from the search API with listing summaries including title, price, posting date, and images.
| Param | Type | Description |
|---|---|---|
| sort | string | Sort order. Accepted values: date, rel, priceasc, pricedsc. |
| limit | integer | Maximum number of results to return per request. |
| query | string | Search keyword to filter listings. |
| offset | integer | Result offset for pagination. |
| category | string | Category code (sss=all for sale, cta=cars+trucks, hhh=housing, jjj=jobs, apa=apartments, boa=boats, ele=electronics, fua=furniture). |
| max_price | integer | Maximum price filter. |
| min_price | integer | Minimum price filter. |
{
"type": "object",
"fields": {
"limit": "integer max results returned",
"offset": "integer current pagination offset",
"listings": "array of listing objects with id, title, price, posted_date, url, image_urls, subarea, category",
"total_count": "integer total number of matching results"
},
"sample": {
"data": {
"limit": 5,
"offset": 0,
"listings": [
{
"id": "7930031024",
"url": "https://losangeles.craigslist.org/lgb/sss/d/long-beach-warmarter-kt-w1-k2-uhf/7930031024.html",
"price": 30,
"title": "Warmarter KT W1 K2 UHF Wireless Microphone System",
"subarea": "lgb",
"category": "sss",
"image_urls": [
"https://images.craigslist.org/00X0X_l2v6XJCaO8T_600x450.jpg"
],
"posted_date": "2026-05-11 23:50:03"
}
],
"total_count": 2677
},
"status": "success"
}
}About the losangeles.craigslist.org API
This API exposes 4 endpoints for querying Craigslist Los Angeles across every major section — for sale, housing, jobs, gigs, services, and community. The search_listings endpoint returns paginated summaries including title, price, posting date, image URLs, and category. The get_listing_detail endpoint fetches full descriptions, structured attributes, geolocation coordinates, and address fields for any individual listing URL.
Search and Filter Listings
The search_listings endpoint accepts keyword queries, price range filters (min_price, max_price), category codes, and sort orders (date, rel, priceasc, pricedsc). Results are paginated via limit and offset parameters, and each listing object in the response includes id, title, price, posted_date, url, image_urls, subarea, and category. The total_count field tells you how many results match so you can implement full pagination.
Category codes follow Craigslist's own scheme: sss for all for-sale items, cta for cars and trucks, hhh for housing, apa for apartments, jjj for jobs, boa for boats, ele for electronics, and others returned by get_categories. Use get_categories to retrieve the full mapping of codes to human-readable names, organized into six top-level sections: community, services, housing, for sale, jobs, and gigs.
Location-Based Search
The search_with_location endpoint extends keyword and category filtering with a ZIP code and radius in miles. Pass any 5-digit US ZIP code alongside a radius value to narrow results to listings posted near a specific geographic area. The response shape mirrors search_listings — an array of listing objects with id, title, price, posted_date, url, image_urls, subarea, and category, plus pagination fields.
Full Listing Details
Call get_listing_detail with a complete Craigslist listing URL to retrieve the full record. The response includes a description string, a structured attributes object of key-value pairs (condition, make, model, etc., depending on category), an array of image_urls, a geo object with latitude and longitude, a location object with addressLocality, postalCode, and addressRegion fields, and the ISO-formatted posted_date.
- Aggregate apartment and housing listings filtered by price range and subarea for a rental search tool.
- Monitor used car inventory on Craigslist LA by polling
search_listingswith categoryctaand sorting bydate. - Build a price-comparison feed for electronics by querying category
elewithmin_priceandmax_pricebounds. - Geocode listing locations using the
geolatitude/longitude fields returned byget_listing_detailfor map-based display. - Pull job postings by category
jjjand index them into a local search engine with full description text. - Send alerts when new listings matching a keyword appear within a set mile radius of a ZIP code using
search_with_location. - Enumerate all available subcategories programmatically via
get_categoriesbefore building category-specific scrapers or filters.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Craigslist have an official developer API?+
What does `get_listing_detail` return beyond what search results include?+
description text, a structured attributes object (key-value pairs like condition, make, model, or size depending on category), a geo object with latitude and longitude, and a location object with address components including addressLocality, postalCode, and addressRegion. Search result objects only include summary fields: title, price, posting date, image URLs, subarea, and category.Does the API cover Craigslist regions outside Los Angeles?+
Are listing contact details such as phone numbers or email addresses returned?+
How does pagination work in `search_listings`?+
total_count integer representing the full number of matching results. Use offset to move through pages and limit to control how many results are returned per request. Increment offset by limit on each subsequent call to walk through the full result set.