Playground Sign in Start free
Marketplaces and classifieds · craigslist.org

How to scrape Craigslist

Craigslist is a marketplace and classifieds site where you can browse and search for items. Developers typically collect product listings, item details, and search results from its public pages.

Ujeebu scrapes any public website. Not listed here? Try any URL in the Playground or ask us about a site.

Working 5 credits a page, about $0.50 per 1,000 on Pro

21 of 21 of our checks passed in the last 7 days (100%).

Last check 2026-11-22 21:31 UTC · last pass 2026-11-22 21:31 UTC · checked with our own requests, never customer data.

Try it in the Playground

No one-call recipe yet for Craigslist: the extract rules below do the same job in your request, or ask us.

Run the code on this page with your own key: 5,000 free credits for 7 days, no card. Get a free API key →

Recipe

Search and listing pages contain SearchResultsPage structured data with breadcrumbs and descriptions, plus ItemList data with item positions and item details. Detail pages show information about individual items. Each recipe was run on two real Craigslist pages and keeps only the fields that came back on both; it is checked again every week, and hidden if it stops working.

Search and listing pages

Validated 2026-11-18

What these rules extract

FieldTypeExample
adslist of 3+ items
ads[].urlURLhttps://www.craigslist.org/view/d/san-francisco-gray-shaped-couch-o...
ads[].titletextGray L-Shaped Couch & Ottoman
ads[].pricetext$700
ads[].locationtextpacific heights

Examples from sfbay.craigslist.org/search/sss on 2026-11-18, shortened.

Sample output (real, trimmed)

{
    "ads": [
        {
            "url": "https://www.craigslist.org/view/d/port-costa-couch/t42RQCVjs1gprUhwhYCRRR",
            "title": "Couch",
            "price": "$300",
            "location": "vallejo / benicia"
        },
        {
            "url": "https://www.craigslist.org/view/d/alameda-love-seat-sofa-couch-end-table/qYhgzLCHnvc18vZG8nFBhN",
            "title": "Love Seat Sofa Couch End Table Coffee Tea Table Ottoman Desk",
            "price": "$250",
            "location": "alameda"
        },
        {
            "url": "https://www.craigslist.org/view/d/berkeley-price-reduced-ikea-couch-in/o6ABMBPV3ziARvmKJXAG7B",
            "title": "Price Reduced ! IKEA couch in excellent, clean condition.",
            "price": "$50",
            "location": "berkeley"
        }
    ]
}
extract_rules (1 rule)
{
    "ads": {
        "selector": "div.cl-search-result",
        "type": "obj",
        "multiple": true,
        "children": {
            "url": {
                "selector": "a.posting-title",
                "type": "link"
            },
            "title": {
                "selector": "a.posting-title span.label",
                "type": "text"
            },
            "price": {
                "selector": "span.priceinfo",
                "type": "text"
            },
            "location": {
                "selector": "span.result-location",
                "type": "text"
            }
        }
    }
}

Code

Complete scripts: set the UJEEBU_API_KEY environment variable and run them as they are. Each one sends the settings on this page and the extraction recipe, prints the extracted JSON, and prints the credits the request cost (the Ujb-Credits response header) on stderr. A non-200 answer stops the script with the API's error message.

Search and listing pages

Runs the recipe on the two pages it was validated on, one after the other.

craigslist_listing_sdk.py pip install ujeebu-python==0.1.5
# Scrape Craigslist search and listing pages with the Ujeebu Scrape API.
# Settings and extract rules validated on real pages on 2026-11-18 (Ujeebu site guide).
# Uses the official SDK ujeebu-python 0.1.5: pip install ujeebu-python==0.1.5
# Run: UJEEBU_API_KEY=your_key python3 craigslist_listing_sdk.py

import json
import os
import sys
import time

import requests
from ujeebu_python import UjeebuClient

API_KEY = os.environ.get("UJEEBU_API_KEY")
URLS = [
    "https://sfbay.craigslist.org/search/sss?query=couch",
    "https://newyork.craigslist.org/search/sss?query=iphone",
]
SETTINGS = {
    "js": False,
}
EXTRACT_RULES = {
    "ads": {
        "selector": "div.cl-search-result",
        "type": "obj",
        "multiple": True,
        "children": {
            "url": {
                "selector": "a.posting-title",
                "type": "link",
            },
            "title": {
                "selector": "a.posting-title span.label",
                "type": "text",
            },
            "price": {
                "selector": "span.priceinfo",
                "type": "text",
            },
            "location": {
                "selector": "span.result-location",
                "type": "text",
            },
        },
    },
}


def scrape(client, url):
    # with extract_rules, client.scrape sends a JSON POST and the API answers {"result": {...}}
    try:
        response = client.scrape(url, params={**SETTINGS, "extract_rules": EXTRACT_RULES})
    except requests.RequestException as error:
        sys.exit(f"Request failed for {url}: {error}")
    if response.status_code != 200:
        try:
            message = response.json().get("message", response.text)
        except ValueError:
            message = response.text
        sys.exit(f"HTTP {response.status_code} for {url}: {str(message)[:300]}")
    print(f"Ujb-Credits: {response.headers.get('Ujb-Credits')}", file=sys.stderr)
    return response.json()["result"]


if not API_KEY:
    sys.exit("Set the UJEEBU_API_KEY environment variable.")

client = UjeebuClient(api_key=API_KEY)

for i, url in enumerate(URLS):
    if i:
        time.sleep(2)  # be polite: one page at a time
    print(json.dumps(scrape(client, url), indent=2, ensure_ascii=False))

SDK tabs use the official Ujeebu SDKs (ujeebu-python 0.1.5, @ujeebu-org/ujeebu-sdk 0.1.2, github.com/ujeebu/ujeebu-go v0.1.8); there is no PHP SDK, so the PHP tab calls the API with curl. For agents and scripts, the same status and settings are at /scrape/craigslist.json.

Try it yourself

Run this on Craigslist with your own key

Get a free API key, set UJEEBU_API_KEY and run any script above as it is. 5,000 free credits for 7 days, no card.

Settings that work today

From our health checks over the last 7 days: the cheapest settings that return the real page most of the time.

Endpoint/scrape
jstrue
Costup to 5 credits a request (only HTTP 200 and 404 are billed; blocked, timed-out and failed requests are free)

For search and listing pages, change the query or the page parameter in the URL to paginate, and fetch the pages one after another rather than in bursts. Collect detail page URLs from listing pages first, then fetch each detail page. Our checks run with JavaScript rendering on (js=true): keep it on.

Try it in the Playground

What people build with Craigslist data

  • Price researchSee what similar items sell for, by condition and location.More on this use case
  • New ads alertsCatch new ads for the searches you care about shortly after they appear.

Limits and etiquette

  • Public pages only. Pages behind a login, and data shown only to signed-in users, are out of scope.
  • Keep the rate modest: fetch pages one after another or with low concurrency, and cache what you already have.
  • Read Craigslist's terms of service before you collect data at scale, and do not collect personal data you have no basis to process. This guide is not legal advice.

Questions

Can you scrape Craigslist with Ujeebu?

Yes. 21 of 21 checks of public Craigslist pages passed in the last 7 days with the settings on this page.

Which settings work for Craigslist?

Call /scrape with js=true.

How many credits does a Craigslist request cost?

With these settings a request costs up to 5 credits. Only responses with HTTP 200 or 404 are billed: a blocked or timed-out request is free.

Which fields can I extract from Craigslist?

With the extraction recipes on this page, validated on real Craigslist pages through our API: search and listing pages: url, title, price, location. Pass the recipe as extract_rules in a POST to /scrape and the API returns those fields as JSON.

How fresh is this page?

The status and settings come from our own health checks of craigslist.org, which run around the clock. Last check: 2026-11-22 21:31:57 UTC; last pass: 2026-11-22 21:31:57 UTC.