Sign in Get API key
Craigslist API

Craigslist API for Classifieds Search, Posting Details, City Sites, and Categories

Scrappa's Craigslist API returns structured JSON from Craigslist, the classifieds platform. Search any city site and category with keyword, price range and sort filters, page through up to 28 pages of 360 results, open any posting for description, attributes, images and approximate location, and list all city sites and categories. Contact data is never returned. Scrappa is an independent service and is not affiliated with or endorsed by Craigslist.

500 free credits
No card needed
From $0.20 / 1k
Pay as you go
Structured JSON
Ready for apps
API key access
Test in minutes
Start for free View documentation
Browse endpoints Try first endpoint
4
Endpoints
700+
City sites
$0.20
Per 1k requests

Try it now

Make one request. Inspect structured JSON.

Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.

Get free API key Try in Playground Open docs
Request preview
Request 
curl -X GET "https://scrappa.co/api/craigslist/search?site=portland&category=bia&query=bike&min_price=50&max_price=300" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"
JSON response 
{
  "success": true,
  "data": {
    "total": 831,
    "page": 1,
    "per_page": 360,
    "has_more": true,
    "results": [
      {
        "position": 1,
        "id": "g5tuoYXMyVFFgpXzYbiXMq",
        "posting_id": 7946124093,
        "title": "LeMond Greg Lemond Road Bike 55cm ((( REDUCED )))",
        "url": "https://www.craigslist.org/view/g5tuoYXMyVFFgpXzYbiXMq",
        "price": 200,
        "currency": "USD",
        "images": [
          "https://images.craigslist.org/00f0f_52oL7PFWTmc_0CI0lN_600x450.jpg"
        ],
        "slug": "portland-lemond-greg-lemond-road-bike",
        "location": {
          "name": "Tigard",
          "site": "portland",
          "subarea": "wsc",
          "latitude": 45.4403,
          "longitude": -122.7793
        },
        "bumped_at": "2026-10-15T19:24:12Z"
      }
    ]
  },
  "meta": {
    "endpoint_family": "search",
    "billable": true
  }
}

What you can build

Structured data for real applications. Here are some ideas.

Price Monitoring

Track asking prices for any product, vehicle or rental on any city site with whole-unit prices and a price range filter.

Local Deal Alerts

Sort by newest and page through fresh postings to spot new listings within minutes.

Rental Market Research

Search housing categories by city or subarea and read bedrooms, area and approximate location for each rental.

Used Goods Sourcing

Search for sale categories such as bicycles, cars or furniture and open postings for condition, size and photos.

City and Category Discovery

Build site and category pickers from the sites and categories endpoints.

Craigslist scraper API

Craigslist API for classifieds search, posting details, city sites, and categories

The Craigslist API is built for price research, local deal alerts and rental monitoring. Each search result includes the posting id, title, url, price, images, approximate location and the time of the latest bump. The posting endpoint adds the plain-text description, attribute pairs and posting time. The sites and categories endpoints list every valid site hostname and category code.

Search any city site or subarea and category with keyword, price range and sort filters.

Page with a 1-based page parameter up to 28 pages of 360 results and read has_more.

Open any posting for description, attributes, images, and approximate coordinates.

List all Craigslist city sites and categories to build pickers.

Street addresses and contact data are never returned.

Choose the right Craigslist API endpoint

Use Search endpoint

Search Craigslist classifieds on any city site and category with filters and pagination.

Open Craigslist Search API docs

Use Posting Detail endpoint

Get one Craigslist posting with description, attributes and images.

Open Craigslist Posting Detail API docs

Use Sites endpoint

List all Craigslist city sites with country, coordinates and subareas.

Open Craigslist Sites API docs

Use Categories endpoint

List all Craigslist categories with codes and sections.

Open Craigslist Categories API docs

Available endpoints

Everything you need in one API.

Related resources

Gumtree API overview

Add UK classifieds from Gumtree alongside Craigslist postings.

eBay API overview

Compare Craigslist asking prices with eBay listings.

Kleinanzeigen API overview

Add German classifieds from Kleinanzeigen alongside Craigslist.

Scrappa vs ScrapingBee / ScraperAPI

See how Scrappa compares to the official API.

Craigslist postings as JSON
Scrappa:
ScrapingBee / ScraperAPI: Build your own parser
Typed prices and ISO timestamps
Scrappa:
ScrapingBee / ScraperAPI: Parse it yourself
Price per 1k requests
Scrappa: From $0.20
ScrapingBee / ScraperAPI: Varies by credits per request
Unified API key
Scrappa: Yes (80+ APIs)
ScrapingBee / ScraperAPI: Scraping only
Free tier
Scrappa: 500 credits/month
ScrapingBee / ScraperAPI: Trial credits

Key features

Search any Craigslist city site or subarea in every category with keyword, price and sort filters
Whole-unit prices with currency, images and approximate coordinates for every result
Posting details with plain-text description, attributes, posting time and all images
All city sites and categories as JSON, cached for 24 hours
Street addresses and contact data are never returned

Frequently asked questions

No. Scrappa is an independent service and is not affiliated with or endorsed by Craigslist. The Craigslist API returns structured JSON for public postings.

Every Scrappa account includes 500 free credits each month. After that, each request costs one credit, which works out to $0.20 per 1,000 requests at the standard rate.

Use the 1-based page parameter from 1 to 28. Each page has up to 360 results, and Craigslist exposes at most 10000 results per search. The response returns has_more. A valid empty search is a successful response.

No. An unknown or expired posting id answers a non-billable 404 with error code NOT_FOUND. Only successful 2xx responses are billed.

No. Street addresses and contact data are never returned, and phone numbers and email addresses inside description text are replaced by [redacted].

Start using the Craigslist API

Sign up and get 500 free credits. No credit card required.

Create Free Account View Documentation