Reef AI: ask for any data. Try it
Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the Craigslist API page →
Classifieds & Second-hand

Craigslist API & Scraper

The Craigslist API returns listings from all 707 Craigslist sites in 79 countries as JSON: cars, apartments, jobs, for sale, gigs, services and events, with the filters Craigslist shows for each category and the full listing.

11 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

It reads Craigslist logged out. `search` covers every section and category, `vehicles`, `housing` and `jobs` are the same search with the filters of those sections. A search takes a Craigslist site (sfbay, newyork, toronto, london), a postal code with a radius, or latitude,longitude, plus the filters Craigslist itself shows for the category: price range, posted today, has image, titles only, owner or dealer, make and model, model year, odometer, body type, drive, fuel, transmission, title status for cars; rent, bedrooms, bathrooms, floor area, cats and dogs, laundry, parking, housing type, furnished, availability and open-house date for housing; employment type, remote, internship and non-profit for jobs. Rows come 60, 120 or 360 per page with the listing id, title, price and currency, the time of the last post or repost, place name and map position, every photo and the section's own fields (bedrooms and floor area, odometer, company and pay, event dates). When a place has few results Craigslist adds listings from nearby areas: those rows are marked is_nearby, total counts the local ones only, and include_nearby=false leaves the nearby rows out. `listing` returns the full post: description, all photos, the attribute table the poster filled, address and map pin when given, the posted time the page prints, the last repost and the updated time, repost link, and the VIN decode on dealer car posts. `counts` tells how many listings match a query in each category before you search; `filters` lists each category's filter form; `locations`, `nearby_locations` and `categories` return the site and category codes.

Reference

What a Craigslist field actually contains

Fields that read differently from how they look. Every row was measured against live Craigslist on 2026-11-15.

FieldWhat it holds
idCraigslist's 22-character listing id (jnZ87DKWyQzjpZjXu8iL1f). It goes into `listing`; 32 of 32 ids taken from search rows came back as the same listing with the same price and title.
post_idThe numeric posting number printed on the page and in old .html links. `listing` also accepts those links.
total, is_nearbytotal is Craigslist's own count for the searched place only. When a place has few results Craigslist appends listings from nearby areas: those rows carry is_nearby: true and meta.nearby_rows says how many are on the page (Austin "honda civic" from 2015: total 17, 60 rows, 43 nearby). include_nearby=false returns the 17 local rows only.
posted_at, last_posted_at, updated_atposted_at is the "posted" time the listing page prints (matched on 18 of 18 listings). last_posted_at is the last time the listing was reposted or renewed; sort=newest orders by it, so an old listing renewed today sorts first. updated_at is the page's "updated" time, empty when the post was never edited. Search rows carry last_posted_at; listing returns all three.
max_rowsHow many rows the result list really holds. Craigslist serves at most 10,000 rows per search (SF bay cars: total 15,559, list 10,000).
duplicate_post_ids, duplicates_hiddenCraigslist groups reposts of the same ad. Housing hides them by default (New York apartments: 5,879 listings shown as 3,840); hide_duplicates does the same elsewhere, show_duplicates turns it off in housing. The newest post of each group stays, the others are listed on it.
price, price_text, currencyThe asking price as a number, the price as Craigslist prints it ($2,500), and the site's currency (USD, CAD, GBP, EUR …). Listings without a price return null.
location.nameThe place the poster typed (Oakland, Staten Island Richmond Terrace) — free text, sometimes a phone number or a dealer slogan, returned as written.
specs, attributesThe poster's attribute table: attributes as printed (label and value), specs with numbers parsed (year 2009, odometer 129000, bedrooms 1, area 680 with area_unit sqft).
has_contact_infoCraigslist releases the phone or e-mail only through its reply button, not on the listing page, so this flag says whether the poster left contact details. Numbers written into the description are returned with it.

Every search filter was checked on 2026-11-15 by comparing the unfiltered and the filtered count in the same minute; a filter a category does not offer is refused with the list of filters it does offer.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on .

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/craigslist/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "location": "sfbay",
    "category": "sss",
    "query": "bike"
  }
}
Captured response
{
  "ok": true,
  "meta": {
    "api": "craigslist",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 948.9,
    "record_count": 120,
    "bytes": 148817,
    "cache_hit": false,
    "nearby_rows": 0,
    "upstream_requests": 1,
    "charged_credits": 2,
    "version": "0.1.1",
    "request_id": "b4329f3d5d4b46c9",
    "queue_ms": 1.2,
    "fetched_at": "2026-11-15T18:52:17.881Z"
  },
  "data": {
    "results": [
      {
        "id": "e1qYbrjct3jdfW4kUvFC3w",
        "post_id": 8001083559,
        "title": "Head accel bicycle",
        "url": "https://www.craigslist.org/view/d/san-jose-head-accel-bicycle/e1qYbrjct3jdfW4kUvFC3w",
        "price": 180,
        "price_text": "$180",
        "currency": "USD",
        "last_posted_at": "2026-11-15T18:30:57Z",
        "category": {
          "id": 68,
          "code": "bik",
          "name": "bicycles - by owner",
          "section": "for_sale"
        },
        "is_nearby": false,
        "location": {
          "site": "sfbay",
          "area_id": 1,
          "subarea": "sby",
          "name": "san jose south",
          "neighborhood": "san jose south",
          "latitude": 37.2602,
          "longitude": -121.7709,
          "country": "US",
          "region": "CA"
        },
        "distance_km": null,
        "distance_mi": null,
        "thumbnail": "https://images.craigslist.org/00404_bzTisa2bDxz_0t20CI_300x300.jpg",
        "images": [
          "https://images.craigslist.org/00404_bzTisa2bDxz_0t20CI_1200x900.jpg"
        ],
        "image_count": 1,
        "bedrooms": null,
        "area": null,
        "area_unit": null,
        "odometer": null,
        "monthly_payment_text": null,
        "job_title": null,
        "company": null,
        "compensation": null,
        "start_date": null,
        "end_date": null,
        "open_house_dates": [],
        "sale_dates": [],
        "duplicate_group": null,
        "duplicate_post_ids": null
      },
      {
        "id": "q5yhSfJis6UaNkwynV2VRJ",
        "post_id": 7995932343,
        "title": "Cannondale Kids Quick 24 Bike light weight",
        "url": "https://www.craigslist.org/view/d/hayward-cannondale-kids-quick-24-bike/q5yhSfJis6UaNkwynV2VRJ",
        "price": 275,
        "price_text": "$275",
        "currency": "USD",
        "last_posted_at": "2026-11-15T18:31:16Z",
        "category": {
          "id": 68,
          "code": "bik",
          "name": "bicycles - by owner",
          "section": "for_sale"
        },
        "is_nearby": false,
        "location": {
          "site": "sfbay",
          "area_id": 1,
          "subarea": "eby",
          "name": "Hayward",
          "neighborhood": null,
          "latitude": 37.637,
          "longitude": -122.049,
          "country": "US",
          "region": "CA"
        },
        "distance_km": null,
        "distance_mi": null,
        "thumbnail": "https://images.craigslist.org/00V0V_hRBvuj9pW2B_0CI0wB_300x300.jpg",
        "images": [
          "https://images.craigslist.org/00V0V_hRBvuj9pW2B_0CI0wB_1200x900.jpg",
          "https://images.craigslist.org/00F0F_86HbhUntfN9_0CI0C4_1200x900.jpg",
          "https://images.craigslist.org/00Z0Z_kvspmeMmkiq_0CI0tt_1200x900.jpg"
        ],
        "image_count": 9,
        "bedrooms": null,
        "area": null,
        "area_unit": null,
        "odometer": null,
        "monthly_payment_text": null,
        "job_title": null,
        "company": null,
        "compensation": null,
        "start_date": null,
        "end_date": null,
        "open_house_dates": [],
        "sale_dates": [],
        "duplicate_group": null,
        "duplicate_post_ids": null
      },
      {
        "id": "ffKhSTAef5Pjkowou5geWN",
        "post_id": 8001082944,
        "title": "FREE exercise bike - pickup by Tuesday evening",
        "url": "https://www.craigslist.org/view/d/palo-alto-free-exercise-bike-pickup-by/ffKhSTAef5Pjkowou5geWN",
        "price": null,
        "price_text": "free",
        "currency": null,
        "last_posted_at": "2026-11-15T18:30:06Z",
        "category": {
          "id": 101,
          "code": "zip",
          "name": "free stuff",
          "section": "for_sale"
        },
        "is_nearby": false,
        "location": {
          "site": "sfbay",
          "area_id": 1,
          "subarea": "pen",
          "name": "palo alto",
          "neighborhood": "palo alto",
          "latitude": 37.4673,
          "longitude": -122.1388,
          "country": "US",
          "region": "CA"
        },
        "distance_km": null,
        "distance_mi": null,
        "thumbnail": "https://images.craigslist.org/00404_eHVSeW6NtB7_0jm0pO_300x300.jpg",
        "images": [
          "https://images.craigslist.org/00404_eHVSeW6NtB7_0jm0pO_1200x900.jpg"
        ],
        "image_count": 1,
        "bedrooms": null,
        "area": null,
        "area_unit": null,
        "odometer": null,
        "monthly_payment_text": null,
        "job_title": null,
        "company": null,
        "compensation": null,
        "start_date": null,
        "end_date": null,
        "open_house_dates": [],
        "sale_dates": [],
        "duplicate_group": null,
        "duplicate_post_ids": null
      }
    ],
    "count": 120,
    "total": 10027,
    "max_rows": 10000,
    "page": 1,
    "page_size": 120,
    "has_more": true,
    "sort": "relevance",
    "sort_requested": null,
    "query": "bike",
    "filters_applied": {},
    "duplicates_hidden": null,
    "category": {
      "id": null,
      "code": "sss",
      "name": "for sale",
      "section": "for_sale"
    },
    "location": {
      "site": "sfbay",
      "area_id": 1,
      "name": "SF bay area",
      "region": "CA",
      "country": "US",
      "postal_code": null,
      "latitude": 37.5,
      "longitude": -122.25,
      "radius": 60,
      "subarea": null,
      "currency": "USD",
      "distance_unit": "mi",
      "area_unit": "sqft"
    }
  }
}
Actions

What the Craigslist API does

ActionDescriptionConcrete use caseKey params
searchSearch any Craigslist category on any site (default: everything for sale). 60 / 120 / 360 rows per page with title, price, date, place and map position, photos, and the section's own fields (bedrooms + floor area for housing, odometer for cars, company + pay for jobs, dates for events). Every filter of the site's form is available; a filter the category does not offer is refused (the site would ignore it).Price-intelligence teams call search to search any Craigslist category on any site (default.location, category, query, subarea, radius, ...
vehiclesCars & trucks, motorcycles, boats, RVs, ATVs / snowmobiles, trailers, heavy equipment — by owner, dealer or both, with make / model, year, odometer, body type, drive, fuel, transmission, title status, paint, cylinders, price and monthly payment filters.Classifieds aggregators call vehicles to get cars & trucks, motorcycles, boats, RVs, ATVs / snowmobiles, trailers, heavy equipment.location, category, query, subarea, radius, ...
housingApartments for rent, rooms, sublets, vacation rentals, real estate for sale, office / commercial, parking — rent / price, bedrooms, bathrooms, floor area, pets, laundry, parking, housing type, furnished, availability and fee filters.Resale and arbitrage tools call housing to get apartments for rent, rooms, sublets, vacation rentals, real estate for sale, office / commerc….location, category, query, subarea, radius, ...
jobsJob listings (31 job categories) with title, company and pay where the poster gives them; employment type, remote, internship and non-profit filters.Lead-generation teams call jobs to get job listings (31 job categories) with title, company and pay where the poster gives them; emp….location, category, query, subarea, radius, ...
listingOne listing in full: description, every photo, price, the attribute table the poster filled (make / model, year, odometer, bedrooms, bathrooms, floor area, pets, pay, employment type …), map position and address when given, posted / updated dates, repost link, category and site.Price-intelligence teams call listing to get one listing in full.listing
countsHow many listings match a query in every section and category of one site (or subarea): where to search before searching.Classifieds aggregators call counts to get how many listings match a query in every section and category of one site (or subarea).location, query, subarea, radius
suggestionsSearch-box autocomplete: Craigslist-wide, or one site's (narrowed to a category); type make_model completes vehicle makes and models.Resale and arbitrage tools call suggestions to get search-box autocomplete.query, location, category, type
filtersThe filter form Craigslist shows for one category (they differ: cars have drive and fuel, apartments laundry and pets): each filter with this API's parameter name, type and options.Lead-generation teams call filters to get the filter form Craigslist shows for one category (they differ.category, location
locationsThe Craigslist sites (707 in 79 countries) with their subareas, coordinates and time zone; filter by country (US, CA, GB …), region (state / province) or a name search.Price-intelligence teams call locations to get the Craigslist sites (707 in 79 countries) with their subareas, coordinates and time zone; fi….query, country, region
nearby_locationsThe Craigslist sites nearest a point or another site, closest first, plus Craigslist's own name for the point (city, postal code, the site and subarea that cover it).Classifieds aggregators call nearby_locations to get the Craigslist sites nearest a point or another site, closest first, plus Craigslist's own na….location, limit
categoriesEvery Craigslist category code in its 8 sections (134 categories), with the by-owner / by-dealer codes of each for-sale category.Resale and arbitrage tools call categories to get every Craigslist category code in its 8 sections (134 categories), with the by-owner / by-dea….section
Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/craigslist/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"location":"sfbay","category":"sss","query":"bike"}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.craigslist.search with {"location":"sfbay","category":"sss","query":"bike"}.
Use cases

Who uses this API and why

  • Track used-car asking prices by make, model, year and mileage across US metro areas.
  • Collect rental listings with rent, bedrooms, floor area and pet rules for a city or ZIP code.
  • Watch new job and gig posts in chosen categories every morning.
  • Count how many listings a product has in each Craigslist category before searching.
  • Pull full listings with all photos and the poster's attribute table for resale research.
FAQ

Questions developers ask before integrating

Is there a Craigslist API for listings?

Yes. The craigslist API on ReefAPI returns search results and full listings from all 707 Craigslist sites in 79 countries as JSON (cars, apartments, jobs, for sale, gigs, services and events) with the filters Craigslist shows for each category, without a Craigslist account.

Do I need a Craigslist account?

No. Everything is read logged out.

Which cities and countries are covered?

All 707 Craigslist sites in 79 countries (413 in the US, 55 in Canada, 27 in the UK). Toronto cars, London and Berlin for-sale and Sydney cars were among the searches measured on 2026-11-15. `locations` lists every site with its subareas.

Can I search by ZIP code or coordinates?

Yes: location takes a postal code (94103, M5V 2T6) or latitude,longitude with a radius. SF bay cars: 7,391 within the default 30 miles of 94103, 235 within 3 miles. A postal code Craigslist does not know returns NOT_FOUND instead of another city's listings.

Why do I get listings from outside my city?

When a place has few results Craigslist itself appends listings from nearby areas. Those rows carry is_nearby: true, total counts only the local listings, and include_nearby=false returns the local rows only (Austin "honda civic" from 2015: total 17, 60 rows of which 43 nearby).

How deep can I page?

Up to 10,000 rows per search, 60, 120 or 360 per page. Consecutive pages were measured without repeats or gaps: 720 of 720 rows unique at 120 per page, 420 of 420 at 60 per page.

Which car filters are there?

Price, monthly payment, make and model, model year, odometer, drive, transmission, body type, paint colour, cylinders, title status, fuel, condition and owner or dealer. SF bay cars on 2026-11-15: 15,562 → model year 2018 or newer 6,608, electric 603, SUV 4,289, toyota tacoma 201, salvage title 422.

Which housing filters are there?

Rent, bedrooms, bathrooms, floor area, cats, dogs, furnished, no smoking, wheelchair access, air conditioning, EV charging, no broker fee, no application fee, rent period, availability, housing type, laundry, parking and open-house date. New York apartments: 5,878 → 3+ bedrooms 1,613, w/d in unit 1,452, furnished 214.

Do I get the seller's phone number?

Only when the poster wrote it into the title or description. Craigslist releases contact details only through its reply button, not on the listing page; has_contact_info says whether there are any.

How fresh is the data?

Every call reads Craigslist live. Pages after the first come from the same result list for three minutes so that pages do not overlap.

What is the Craigslist API?

Craigslist API is a ReefAPI endpoint group for listings from all 707 craigslist sites: cars, apartments, jobs, for sale, gigs, services and events, with every filter of the site and the full listing. It returns live JSON through POST requests under /craigslist/v1.

Is the Craigslist API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Craigslist calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Craigslist login or account?

No login to Craigslist is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Craigslist data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

docs / craigslist

Craigslist

Listings from all 707 Craigslist sites: cars, apartments, jobs, for sale, gigs, services and events, with every filter of the site and the full listing.

base /craigslist/v111 endpoints
post/craigslist/v1/vehicles3 credits

Cars & trucks, motorcycles, boats, RVs, ATVs / snowmobiles, trailers, heavy equipment — by owner, dealer or both, with make / model, year, odometer, body type, drive, fuel, transmission, title status, paint, cylinders, price and monthly payment filters.

ParameterAllowed / rangeDescription
locationrequired—Where to search: a Craigslist site (`sfbay`, `newyork`, `toronto`, `london`; the hostname, its 3-letter code or its name), any craigslist.org link on that site, a postal / ZIP code (`94103`, `M5V 2T6`) or `latitude,longitude` (`40.7128,-74.0060`). Postal code and coordinates search a radius (see `radius`). Sites: action `locations`.
category = ctaoptionalcta · cto · ctd · mca · mcy · mcd · boo · boa · bod · rva · rvs · rvd · sna · snw · snd · tra · tro · trb · hva · hvo · hvdCraigslist category code (a vehicle category; default `cta`). All codes: action `categories`.
queryoptional—Search words, e.g. `honda civic`, `studio`, `react developer`.
subareaoptional—Optional 3-letter subarea of the site (sfbay: `sfc` san francisco, `sby` south bay, `eby` east bay, `pen`, `nby`, `scz`); listed per site by action `locations`.
radius = 30optional1–400Search radius around a postal code or coordinates, in the site's distance unit (miles in the US / GB, km elsewhere). Default 30.
sortoptionalnewest · oldest · price_low · price_high · distance · relevance · upcomingOrder: newest, oldest, price_low, price_high, distance, relevance (needs a query), upcoming (events / garage sales). Default = Craigslist's own: relevance with a query, newest without (upcoming for events / garage sales). newest / oldest order by last_posted_at (the last (re)post or renewal), not by the original posted_at. The order the site applied is returned as `sort`.
page = 1optional1–1671-based page. Pages are `page_size` rows of one result list; the site serves at most 10 000 rows per search.
page_size = 120optional60 · 120 · 360Rows per page: 60, 120 (default) or 360.
include_nearby = trueoptional—When the searched place has few results Craigslist appends listings from nearby areas (is_nearby: true; total counts only the local ones). false drops those rows. Default true, as Craigslist shows them.
title_onlyoptional—Match the query in titles only.
has_imageoptional—Only listings with a photo.
posted_todayoptional—Only listings posted today.
hide_duplicatesoptional—Collapse the site's duplicate clusters (not offered in housing; use show_duplicates there).
min_priceoptional0–Minimum price (site currency).
max_priceoptional0–Maximum price (site currency).
seller_typeoptionalowner · dealerFor sale / vehicles / real estate: owner or dealer (all by default).
make_modeloptional—For sale / vehicles: make and model text, e.g. `honda civic` (action `suggestions` with type make_model completes it).
conditionoptionalnew · like_new · excellent · good · fair · salvageFor sale / vehicles: condition: one or more of the site's own options, by label or id (e.g. `new`). Several values = any of them.
min_yearoptional0–Vehicles / boats: minimum model year (boats: year manufactured).
max_yearoptional0–Vehicles / boats: maximum model year (boats: year manufactured).
min_odometeroptional0–Vehicles: minimum odometer.
max_odometeroptional0–Vehicles: maximum odometer.
min_monthly_paymentoptional0–Cars: minimum monthly payment.
max_monthly_paymentoptional0–Cars: maximum monthly payment.
drivetrainoptionalfwd · rwd · 4wdCars / RVs: drive: one or more of the site's own options, by label or id (e.g. `fwd`). Several values = any of them.
transmissionoptionalmanual · automatic · otherVehicles: transmission: one or more of the site's own options, by label or id (e.g. `manual`). Several values = any of them.
body_typeoptionalbus · convertible · coupe · hatchback · minivan · offroad · pickup · sedan · truck · suv · wagon · van · otherCars: body type: one or more of the site's own options, by label or id (e.g. `bus`). Several values = any of them.
paint_coloroptionalblack · blue · brown · green · grey · orange · purple · red · silver · white · yellow · customCars / RVs: paint colour: one or more of the site's own options, by label or id (e.g. `black`). Several values = any of them.
cylindersoptional3_cylinders · 4_cylinders · 5_cylinders · 6_cylinders · 8_cylinders · 10_cylinders · 12_cylinders · otherCars / RVs: cylinders: one or more of the site's own options, by label or id (e.g. `3_cylinders`). Several values = any of them.
title_statusoptionalclean · salvage · rebuilt · parts_only · lien · missingVehicles: title status: one or more of the site's own options, by label or id (e.g. `clean`). Several values = any of them.
fuel_typeoptionalgas · diesel · hybrid · electric · otherCars / RVs: fuel: one or more of the site's own options, by label or id (e.g. `gas`). Several values = any of them.
min_engine_ccoptional0–Motorcycles: minimum engine displacement (cc).
max_engine_ccoptional0–Motorcycles: maximum engine displacement (cc).
street_legaloptional—Motorcycles: street legal.
motor_typeoptionalgas · electric · otherMotorcycles: motor: one or more of the site's own options, by label or id (e.g. `gas`). Several values = any of them.
motorcycle_typeoptionaladventure · bobber · cafe_racer · chopper · cruiser · dirtbike · dual_sport · scooter_moped · sport_bike · sport_touring · standard · touring · trike · otherMotorcycles: type: one or more of the site's own options, by label or id (e.g. `adventure`). Several values = any of them.
min_lengthoptional0–Boats (length overall) / RVs (feet): minimum length.
max_lengthoptional0–Boats (length overall) / RVs (feet): maximum length.
boat_typeoptionalcommercial_boat · houseboat · kayak_canoe_sup · luxury_classic_yacht · personal_watercraft_jet_ski · pontoon_boat · powerboat · rowboat · rowing_shell · sailboat · ski_boat · small_outboard_fishing · trawler · otherBoats: type: one or more of the site's own options, by label or id (e.g. `commercial_boat`). Several values = any of them.
propulsion_typeoptionalsail · power · humanBoats: propulsion: one or more of the site's own options, by label or id (e.g. `sail`). Several values = any of them.
rv_typeoptionalclass_a · class_b · class_c · fifth_wheel_trailer · travel_trailer · hybrid_trailer · folding_popup_trailer · teardrop_compact_trailer · toy_hauler · truck_camper · otherRVs: type: one or more of the site's own options, by label or id (e.g. `class_a`). Several values = any of them.
atv_typeoptionalsnowmobile · atv · side_by_side_utv · golf_cart · go_kart · dune_buggy · otherATVs / UTVs / snowmobiles: vehicle type: one or more of the site's own options, by label or id (e.g. `snowmobile`). Several values = any of them.
delivery_availableoptional—For sale: delivery available.
cryptocurrency_okoptional—For sale: cryptocurrency accepted.
languageoptionalafrikaans · català · dansk · deutsch · english · español · suomi · français · italiano · nederlands · norsk · português · svenska · filipino · türkçe · 中文 · العربية · 日本語 · 한국말 · русский · tiếng_việtLanguage of the posting: one or more of the site's own options, by label or id (e.g. `afrikaans`). Several values = any of them.
Try in playground →
post/craigslist/v1/housing3 credits

Apartments for rent, rooms, sublets, vacation rentals, real estate for sale, office / commercial, parking — rent / price, bedrooms, bathrooms, floor area, pets, laundry, parking, housing type, furnished, availability and fee filters.

ParameterAllowed / rangeDescription
locationrequired—Where to search: a Craigslist site (`sfbay`, `newyork`, `toronto`, `london`; the hostname, its 3-letter code or its name), any craigslist.org link on that site, a postal / ZIP code (`94103`, `M5V 2T6`) or `latitude,longitude` (`40.7128,-74.0060`). Postal code and coordinates search a radius (see `radius`). Sites: action `locations`.
category = apaoptionalhhh · rea · reo · reb · apa · hou · roo · sha · sub · off · prk · sbw · swp · vac · rewCraigslist category code (a housing category; default `apa`). All codes: action `categories`.
queryoptional—Search words, e.g. `honda civic`, `studio`, `react developer`.
subareaoptional—Optional 3-letter subarea of the site (sfbay: `sfc` san francisco, `sby` south bay, `eby` east bay, `pen`, `nby`, `scz`); listed per site by action `locations`.
radius = 30optional1–400Search radius around a postal code or coordinates, in the site's distance unit (miles in the US / GB, km elsewhere). Default 30.
sortoptionalnewest · oldest · price_low · price_high · distance · relevance · upcomingOrder: newest, oldest, price_low, price_high, distance, relevance (needs a query), upcoming (events / garage sales). Default = Craigslist's own: relevance with a query, newest without (upcoming for events / garage sales). newest / oldest order by last_posted_at (the last (re)post or renewal), not by the original posted_at. The order the site applied is returned as `sort`.
page = 1optional1–1671-based page. Pages are `page_size` rows of one result list; the site serves at most 10 000 rows per search.
page_size = 120optional60 · 120 · 360Rows per page: 60, 120 (default) or 360.
include_nearby = trueoptional—When the searched place has few results Craigslist appends listings from nearby areas (is_nearby: true; total counts only the local ones). false drops those rows. Default true, as Craigslist shows them.
title_onlyoptional—Match the query in titles only.
has_imageoptional—Only listings with a photo.
posted_todayoptional—Only listings posted today.
min_priceoptional0–Minimum price (site currency).
max_priceoptional0–Maximum price (site currency).
seller_typeoptionalowner · dealerFor sale / vehicles / real estate: owner or dealer (all by default).
min_bedroomsoptional0–Housing: minimum bedrooms.
max_bedroomsoptional0–Housing: maximum bedrooms.
min_bathroomsoptional0–Housing: minimum bathrooms.
max_bathroomsoptional0–Housing: maximum bathrooms.
min_areaoptional0–Housing: minimum floor area (ft² in the US / CA, m² elsewhere: the site's unit).
max_areaoptional0–Housing: maximum floor area (the site's unit).
private_roomoptional—Rooms / sublets: private room.
private_bathoptional—Rooms / sublets: private bath.
cats_okoptional—Housing: cats OK.
dogs_okoptional—Housing: dogs OK.
furnishedoptional—Housing: furnished.
no_smokingoptional—Housing: no smoking.
wheelchair_accessibleoptional—Housing: wheelchair accessible.
air_conditioningoptional—Housing: air conditioning.
ev_chargingoptional—Housing: EV charging.
no_broker_feeoptional—Housing for rent: no broker fee.
no_application_feeoptional—Housing for rent: no application fee.
rent_periodoptionaldaily · weekly · monthlyHousing: rent period: one or more of the site's own options, by label or id (e.g. `daily`). Several values = any of them.
availabilityoptionalwithin_30_days · beyond_30_daysHousing: available within 30 days or beyond 30 days.
housing_typeoptionalapartment · condo · cottage_cabin · duplex · flat · house · in_law · loft · townhouse · manufactured · assisted_living · landHousing: housing type: one or more of the site's own options, by label or id (e.g. `apartment`). Several values = any of them.
laundryoptionalw_d_in_unit · w_d_hookups · laundry_in_bldg · laundry_on_site · no_laundry_on_siteHousing: laundry: one or more of the site's own options, by label or id (e.g. `w_d_in_unit`). Several values = any of them.
parkingoptionalcarport · attached_garage · detached_garage · off_street_parking · street_parking · valet_parking · no_parkingHousing: parking: one or more of the site's own options, by label or id (e.g. `carport`). Several values = any of them.
show_duplicatesoptional—Housing only: also show listings the site marks as duplicates (hidden by default there).
dateoptional—A day, YYYY-MM-DD: garage sales on that day (gms), open houses on that day (housing), events on that day (eee). Other categories do not offer it.
Try in playground →
post/craigslist/v1/jobs2 credits

Job listings (31 job categories) with title, company and pay where the poster gives them; employment type, remote, internship and non-profit filters.

ParameterAllowed / rangeDescription
locationrequired—Where to search: a Craigslist site (`sfbay`, `newyork`, `toronto`, `london`; the hostname, its 3-letter code or its name), any craigslist.org link on that site, a postal / ZIP code (`94103`, `M5V 2T6`) or `latitude,longitude` (`40.7128,-74.0060`). Postal code and coordinates search a radius (see `radius`). Sites: action `locations`.
category = jjjoptionaljjj · web · bus · mar · etc · wri · sof · acc · ofc · med · hea · ret · npo · lgl · egr · sls · sad · tfr · hum · tch · edu · trd · gov · sci · csr · trp · spa · rej · mnu · fbh · lab · secCraigslist category code (a jobs category; default `jjj`). All codes: action `categories`.
queryoptional—Search words, e.g. `honda civic`, `studio`, `react developer`.
subareaoptional—Optional 3-letter subarea of the site (sfbay: `sfc` san francisco, `sby` south bay, `eby` east bay, `pen`, `nby`, `scz`); listed per site by action `locations`.
radius = 30optional1–400Search radius around a postal code or coordinates, in the site's distance unit (miles in the US / GB, km elsewhere). Default 30.
sortoptionalnewest · oldest · price_low · price_high · distance · relevance · upcomingOrder: newest, oldest, price_low, price_high, distance, relevance (needs a query), upcoming (events / garage sales). Default = Craigslist's own: relevance with a query, newest without (upcoming for events / garage sales). newest / oldest order by last_posted_at (the last (re)post or renewal), not by the original posted_at. The order the site applied is returned as `sort`.
page = 1optional1–1671-based page. Pages are `page_size` rows of one result list; the site serves at most 10 000 rows per search.
page_size = 120optional60 · 120 · 360Rows per page: 60, 120 (default) or 360.
include_nearby = trueoptional—When the searched place has few results Craigslist appends listings from nearby areas (is_nearby: true; total counts only the local ones). false drops those rows. Default true, as Craigslist shows them.
title_onlyoptional—Match the query in titles only.
has_imageoptional—Only listings with a photo.
posted_todayoptional—Only listings posted today.
hide_duplicatesoptional—Collapse the site's duplicate clusters (not offered in housing; use show_duplicates there).
employment_typeoptionalfull_time · part_time · contract · employees_choiceJobs: employment type: one or more of the site's own options, by label or id (e.g. `full_time`). Several values = any of them.
is_remoteoptional—Jobs: telecommuting OK.
is_internshipoptional—Jobs: internship.
is_nonprofitoptional—Jobs: non-profit organisation.
Try in playground →
post/craigslist/v1/listing1 credit

One listing in full: description, every photo, price, the attribute table the poster filled (make / model, year, odometer, bedrooms, bathrooms, floor area, pets, pay, employment type …), map position and address when given, posted / updated dates, repost link, category and site.

ParameterAllowed / rangeDescription
listingrequired—The `id` of a search row (`jnZ87DKWyQzjpZjXu8iL1f`) or any craigslist.org listing link (`https://www.craigslist.org/view/d/<title>/<id>` or `https://sfbay.craigslist.org/eby/cto/d/<title>/8001017925.html`).
Try in playground →
post/craigslist/v1/counts1 credit

How many listings match a query in every section and category of one site (or subarea): where to search before searching.

ParameterAllowed / rangeDescription
locationrequired—Where to search: a Craigslist site (`sfbay`, `newyork`, `toronto`, `london`; the hostname, its 3-letter code or its name), any craigslist.org link on that site, a postal / ZIP code (`94103`, `M5V 2T6`) or `latitude,longitude` (`40.7128,-74.0060`). Postal code and coordinates search a radius (see `radius`). Sites: action `locations`.
queryrequired—Search words, e.g. `honda`, `iphone`, `nurse` (Craigslist counts need a query).
subareaoptional—Optional 3-letter subarea of the site (sfbay: `sfc` san francisco, `sby` south bay, `eby` east bay, `pen`, `nby`, `scz`); listed per site by action `locations`.
radius = 30optional1–400Search radius around a postal code or coordinates, in the site's distance unit (miles in the US / GB, km elsewhere). Default 30.
Try in playground →
post/craigslist/v1/suggestions1 credit

Search-box autocomplete: Craigslist-wide, or one site's (narrowed to a category); type make_model completes vehicle makes and models.

ParameterAllowed / rangeDescription
queryrequired—The start of a search, e.g. `hond`.
locationoptional—Optional Craigslist site for that site's own suggestions.
categoryoptional—Optional category code with `location` (default sss; cta for make_model).
type = searchoptionalsearch · make_modelsearch (default) or make_model.
Try in playground →
post/craigslist/v1/filters1 credit

The filter form Craigslist shows for one category (they differ: cars have drive and fuel, apartments laundry and pets): each filter with this API's parameter name, type and options.

ParameterAllowed / rangeDescription
categoryrequired—Category code, e.g. `cta`, `apa`, `jjj`, `bia`.
locationoptional—Optional site (default sfbay); the form also lists that site's subareas.
Try in playground →
post/craigslist/v1/locations1 credit

The Craigslist sites (707 in 79 countries) with their subareas, coordinates and time zone; filter by country (US, CA, GB …), region (state / province) or a name search.

ParameterAllowed / rangeDescription
queryoptional—Site name / hostname / code to look up, e.g. `san francisco`, `nyc`.
countryoptional—2-letter country code, e.g. US, CA, GB, DE.
regionoptional—State / province code, e.g. CA, NY, ON.
Try in playground →
post/craigslist/v1/nearby_locations1 credit

The Craigslist sites nearest a point or another site, closest first, plus Craigslist's own name for the point (city, postal code, the site and subarea that cover it).

ParameterAllowed / rangeDescription
locationrequired—`latitude,longitude` or a Craigslist site.
limit = 10optional1–50How many sites (default 10).
Try in playground →
post/craigslist/v1/categoriesfree

Every Craigslist category code in its 8 sections (134 categories), with the by-owner / by-dealer codes of each for-sale category.

ParameterAllowed / rangeDescription
sectionoptionalfor_sale · housing · jobs · gigs · services · community · events · resumesOptional section: for_sale, housing, jobs, gigs, services, community, events, resumes.
Try in playground →
Built for volume
5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?
We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support
2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance
Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.