# Craigslist API — listings from 707 Craigslist sites in 79 countries: cars, apartments, jobs, for sale, gigs, services, events; full listing with photos and attributes; counts, filters, sites, categories

> Search 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).
> ReefAPI engine `craigslist` · 11 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/craigslist/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/craigslist/v1/search — 2 credits
Search 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).

**Parameters:**
- `location` (string, required) — 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` (string, optional, default "sss") — Craigslist category code (any section or category; default `sss`). All codes: action `categories`.
- `query` (string, optional) — Search words, e.g. `honda civic`, `studio`, `react developer`.
- `subarea` (string, optional) — 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` (integer, optional, default 30) — Search radius around a postal code or coordinates, in the site's distance unit (miles in the US / GB, km elsewhere). Default 30.
- `sort` (enum, optional) — Order: 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`. [one of: newest, oldest, price_low, price_high, distance, relevance, upcoming]
- `page` (integer, optional, default 1) — 1-based page. Pages are `page_size` rows of one result list; the site serves at most 10 000 rows per search.
- `page_size` (integer, optional, default 120) — Rows per page: 60, 120 (default) or 360. [one of: 60, 120, 360]
- `include_nearby` (boolean, optional, default true) — 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_only` (boolean, optional) — Match the query in titles only.
- `has_image` (boolean, optional) — Only listings with a photo.
- `posted_today` (boolean, optional) — Only listings posted today.
- `hide_duplicates` (boolean, optional) — Collapse the site's duplicate clusters (not offered in housing; use show_duplicates there).
- `min_price` (number, optional) — Minimum price (site currency).
- `max_price` (number, optional) — Maximum price (site currency).
- `seller_type` (enum, optional) — For sale / vehicles / real estate: owner or dealer (all by default). [one of: owner, dealer]
- `make_model` (string, optional) — For sale / vehicles: make and model text, e.g. `honda civic` (action `suggestions` with type make_model completes it).
- `condition` (array, optional) — For sale / vehicles: condition: one or more of the site's own options, by label or id (e.g. `new`). Several values = any of them. [one of: new, like_new, excellent, good, fair, salvage]
- `free_only` (boolean, optional) — For sale: only free items.
- `delivery_available` (boolean, optional) — For sale: delivery available.
- `cryptocurrency_ok` (boolean, optional) — For sale: cryptocurrency accepted.
- `language` (array, optional) — Language of the posting: one or more of the site's own options, by label or id (e.g. `afrikaans`). Several values = any of them. [one of: afrikaans, català, dansk, deutsch, english, español, suomi, français, italiano, nederlands, norsk, português, svenska, filipino, türkçe, 中文, العربية, 日本語, 한국말, русский, tiếng_việt]
- `min_year` (number, optional) — Vehicles / boats: minimum model year (boats: year manufactured).
- `max_year` (number, optional) — Vehicles / boats: maximum model year (boats: year manufactured).
- `min_odometer` (number, optional) — Vehicles: minimum odometer.
- `max_odometer` (number, optional) — Vehicles: maximum odometer.
- `min_monthly_payment` (number, optional) — Cars: minimum monthly payment.
- `max_monthly_payment` (number, optional) — Cars: maximum monthly payment.
- `drivetrain` (array, optional) — Cars / RVs: drive: one or more of the site's own options, by label or id (e.g. `fwd`). Several values = any of them. [one of: fwd, rwd, 4wd]
- `transmission` (array, optional) — Vehicles: transmission: one or more of the site's own options, by label or id (e.g. `manual`). Several values = any of them. [one of: manual, automatic, other]
- `body_type` (array, optional) — Cars: body type: one or more of the site's own options, by label or id (e.g. `bus`). Several values = any of them. [one of: bus, convertible, coupe, hatchback, minivan, offroad, pickup, sedan, truck, suv, wagon, van, other]
- `paint_color` (array, optional) — Cars / RVs: paint colour: one or more of the site's own options, by label or id (e.g. `black`). Several values = any of them. [one of: black, blue, brown, green, grey, orange, purple, red, silver, white, yellow, custom]
- `cylinders` (array, optional) — Cars / RVs: cylinders: one or more of the site's own options, by label or id (e.g. `3_cylinders`). Several values = any of them. [one of: 3_cylinders, 4_cylinders, 5_cylinders, 6_cylinders, 8_cylinders, 10_cylinders, 12_cylinders, other]
- `title_status` (array, optional) — Vehicles: title status: one or more of the site's own options, by label or id (e.g. `clean`). Several values = any of them. [one of: clean, salvage, rebuilt, parts_only, lien, missing]
- `fuel_type` (array, optional) — Cars / RVs: fuel: one or more of the site's own options, by label or id (e.g. `gas`). Several values = any of them. [one of: gas, diesel, hybrid, electric, other]
- `min_engine_cc` (number, optional) — Motorcycles: minimum engine displacement (cc).
- `max_engine_cc` (number, optional) — Motorcycles: maximum engine displacement (cc).
- `street_legal` (boolean, optional) — Motorcycles: street legal.
- `motor_type` (array, optional) — Motorcycles: motor: one or more of the site's own options, by label or id (e.g. `gas`). Several values = any of them. [one of: gas, electric, other]
- `motorcycle_type` (array, optional) — Motorcycles: type: one or more of the site's own options, by label or id (e.g. `adventure`). Several values = any of them. [one of: adventure, bobber, cafe_racer, chopper, cruiser, dirtbike, dual_sport, scooter_moped, sport_bike, sport_touring, standard, touring, trike, other]
- `min_length` (number, optional) — Boats (length overall) / RVs (feet): minimum length.
- `max_length` (number, optional) — Boats (length overall) / RVs (feet): maximum length.
- `boat_type` (array, optional) — Boats: type: one or more of the site's own options, by label or id (e.g. `commercial_boat`). Several values = any of them. [one of: commercial_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, other]
- `propulsion_type` (array, optional) — Boats: propulsion: one or more of the site's own options, by label or id (e.g. `sail`). Several values = any of them. [one of: sail, power, human]
- `rv_type` (array, optional) — RVs: type: one or more of the site's own options, by label or id (e.g. `class_a`). Several values = any of them. [one of: class_a, class_b, class_c, fifth_wheel_trailer, travel_trailer, hybrid_trailer, folding_popup_trailer, teardrop_compact_trailer, toy_hauler, truck_camper, other]
- `atv_type` (array, optional) — ATVs / 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. [one of: snowmobile, atv, side_by_side_utv, golf_cart, go_kart, dune_buggy, other]
- `bicycle_type` (array, optional) — Bicycles: type: one or more of the site's own options, by label or id (e.g. `bmx`). Several values = any of them. [one of: bmx, cargo_pedicab, cruiser, cyclocross, folding, gravel, hybrid_comfort, kids, mountain, recumbent_trike, road, tandem, track, unicycle, other]
- `wheel_size` (array, optional) — Bicycles: wheel size: one or more of the site's own options, by label or id (e.g. `10_in`). Several values = any of them. [one of: 10_in, 12_in, 14_in, 16_in, 18_in, 20_in, 24_in, 25_in, 26_in, 26_5_in, 27_in, 27_5_in, 28_in, 29_in, 650b, 650c, 700c, other_unknown]
- `frame_material` (array, optional) — Bicycles: frame material: one or more of the site's own options, by label or id (e.g. `alloy`). Several values = any of them. [one of: alloy, aluminum, carbon_fiber, composite, scandium, steel, titanium, other_unknown]
- `suspension` (array, optional) — Bicycles: suspension: one or more of the site's own options, by label or id (e.g. `none_rigid`). Several values = any of them. [one of: none_rigid, suspension_fork_hardtail, frame_and_fork_full_suspension, other_unknown]
- `brake_type` (array, optional) — Bicycles: brake type: one or more of the site's own options, by label or id (e.g. `caliper`). Several values = any of them. [one of: caliper, cantilever, coaster, disc_hydraulic, disc_mechanical, drum, gyro_bmx, hydraulic_rim_brakes, none, u_brakes, v_brakes, other_unknown]
- `handlebar_type` (array, optional) — Bicycles: handlebar type: one or more of the site's own options, by label or id (e.g. `aero`). Several values = any of them. [one of: aero, bmx, bullhorn, cruiser, downhill, drop, flat, riser, triathlon, other_unknown]
- `electric_assist` (array, optional) — Bicycles: electric assist: one or more of the site's own options, by label or id (e.g. `none`). Several values = any of them. [one of: none, pedal_assist, throttle, other]
- `min_bedrooms` (number, optional) — Housing: minimum bedrooms.
- `max_bedrooms` (number, optional) — Housing: maximum bedrooms.
- `min_bathrooms` (number, optional) — Housing: minimum bathrooms.
- `max_bathrooms` (number, optional) — Housing: maximum bathrooms.
- `min_area` (number, optional) — Housing: minimum floor area (ft² in the US / CA, m² elsewhere: the site's unit).
- `max_area` (number, optional) — Housing: maximum floor area (the site's unit).
- `private_room` (boolean, optional) — Rooms / sublets: private room.
- `private_bath` (boolean, optional) — Rooms / sublets: private bath.
- `cats_ok` (boolean, optional) — Housing: cats OK.
- `dogs_ok` (boolean, optional) — Housing: dogs OK.
- `furnished` (boolean, optional) — Housing: furnished.
- `no_smoking` (boolean, optional) — Housing: no smoking.
- `wheelchair_accessible` (boolean, optional) — Housing: wheelchair accessible.
- `air_conditioning` (boolean, optional) — Housing: air conditioning.
- `ev_charging` (boolean, optional) — Housing: EV charging.
- `no_broker_fee` (boolean, optional) — Housing for rent: no broker fee.
- `no_application_fee` (boolean, optional) — Housing for rent: no application fee.
- `rent_period` (array, optional) — Housing: rent period: one or more of the site's own options, by label or id (e.g. `daily`). Several values = any of them. [one of: daily, weekly, monthly]
- `availability` (enum, optional) — Housing: available within 30 days or beyond 30 days. [one of: within_30_days, beyond_30_days]
- `housing_type` (array, optional) — Housing: housing type: one or more of the site's own options, by label or id (e.g. `apartment`). Several values = any of them. [one of: apartment, condo, cottage_cabin, duplex, flat, house, in_law, loft, townhouse, manufactured, assisted_living, land]
- `laundry` (array, optional) — Housing: 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. [one of: w_d_in_unit, w_d_hookups, laundry_in_bldg, laundry_on_site, no_laundry_on_site]
- `parking` (array, optional) — Housing: parking: one or more of the site's own options, by label or id (e.g. `carport`). Several values = any of them. [one of: carport, attached_garage, detached_garage, off_street_parking, street_parking, valet_parking, no_parking]
- `show_duplicates` (boolean, optional) — Housing only: also show listings the site marks as duplicates (hidden by default there).
- `date` (string, optional) — 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.
- `employment_type` (array, optional) — Jobs: employment type: one or more of the site's own options, by label or id (e.g. `full_time`). Several values = any of them. [one of: full_time, part_time, contract, employees_choice]
- `is_remote` (boolean, optional) — Jobs: telecommuting OK.
- `is_internship` (boolean, optional) — Jobs: internship.
- `is_nonprofit` (boolean, optional) — Jobs: non-profit organisation.
- `is_paid` (enum, optional) — Gigs: paid or unpaid (all by default). [one of: paid, unpaid]
- `lost_or_found` (array, optional) — Community / lost & found: lost or found: one or more of the site's own options, by label or id (e.g. `lost`). Several values = any of them. [one of: lost, found]
- `event_type` (array, optional) — Events: one or more of music, sustainability, charitable, food, free, tech, literary, festival, art, sale, kid_friendly, outdoor, career, competition, singles, fitness, dance. [one of: music, sustainability, charitable, food, free, tech, literary, festival, art, sale, kid_friendly, outdoor, career, competition, singles, fitness, dance]
- `resume_availability` (array, optional) — Resumes: available morning, afternoon, evening, overnight, weekdays, weekends (several = all of them). [one of: morning, afternoon, evening, overnight, weekdays, weekends]
- `education_level` (array, optional) — Resumes: education completed: one or more of the site's own options, by label or id (e.g. `less_than_high_school`). Several values = any of them. [one of: less_than_high_school, high_school_ged, some_college, associates, bachelors, masters, doctoral]

**Returns:** results[]{id (listing id for `listing`), post_id, title, url, price, price_text, currency, last_posted_at (last (re)post or renewal: what sort=newest orders by; the original posting time is listing.posted_at), category{id, code, name, section}, is_nearby (a row Craigslist appended from a nearby area because the searched place has few results), location{site, area_id, subarea, name, neighborhood, latitude, longitude, country, region}, distance_km, distance_mi, thumbnail, images[], image_count, bedrooms, area, area_unit, odometer, monthly_payment_text, job_title, company, compensation, start_date, end_date, open_house_dates[], sale_dates[], duplicate_group} + count + total (the site's own count for the searched place ONLY — appended nearby rows are not in it; meta.nearby_rows says how many rows on the page are nearby rows) + max_rows + page + page_size + has_more + sort + sort_requested + filters_applied{} + category{} + location{site, name, region, country, postal_code, latitude, longitude, radius, currency, distance_unit, area_unit}

**Example request body:**
```json
{
  "location": "sfbay",
  "category": "sss",
  "query": "bike"
}
```

### POST https://api.reefapi.com/craigslist/v1/vehicles — 3 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.

**Parameters:**
- `location` (string, required) — 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` (string, optional, default "cta") — Craigslist category code (a vehicle category; default `cta`). All codes: action `categories`. [one of: cta, cto, ctd, mca, mcy, mcd, boo, boa, bod, rva, rvs, rvd, sna, snw, snd, tra, tro, trb, hva, hvo, hvd]
- `query` (string, optional) — Search words, e.g. `honda civic`, `studio`, `react developer`.
- `subarea` (string, optional) — 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` (integer, optional, default 30) — Search radius around a postal code or coordinates, in the site's distance unit (miles in the US / GB, km elsewhere). Default 30.
- `sort` (enum, optional) — Order: 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`. [one of: newest, oldest, price_low, price_high, distance, relevance, upcoming]
- `page` (integer, optional, default 1) — 1-based page. Pages are `page_size` rows of one result list; the site serves at most 10 000 rows per search.
- `page_size` (integer, optional, default 120) — Rows per page: 60, 120 (default) or 360. [one of: 60, 120, 360]
- `include_nearby` (boolean, optional, default true) — 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_only` (boolean, optional) — Match the query in titles only.
- `has_image` (boolean, optional) — Only listings with a photo.
- `posted_today` (boolean, optional) — Only listings posted today.
- `hide_duplicates` (boolean, optional) — Collapse the site's duplicate clusters (not offered in housing; use show_duplicates there).
- `min_price` (number, optional) — Minimum price (site currency).
- `max_price` (number, optional) — Maximum price (site currency).
- `seller_type` (enum, optional) — For sale / vehicles / real estate: owner or dealer (all by default). [one of: owner, dealer]
- `make_model` (string, optional) — For sale / vehicles: make and model text, e.g. `honda civic` (action `suggestions` with type make_model completes it).
- `condition` (array, optional) — For sale / vehicles: condition: one or more of the site's own options, by label or id (e.g. `new`). Several values = any of them. [one of: new, like_new, excellent, good, fair, salvage]
- `min_year` (number, optional) — Vehicles / boats: minimum model year (boats: year manufactured).
- `max_year` (number, optional) — Vehicles / boats: maximum model year (boats: year manufactured).
- `min_odometer` (number, optional) — Vehicles: minimum odometer.
- `max_odometer` (number, optional) — Vehicles: maximum odometer.
- `min_monthly_payment` (number, optional) — Cars: minimum monthly payment.
- `max_monthly_payment` (number, optional) — Cars: maximum monthly payment.
- `drivetrain` (array, optional) — Cars / RVs: drive: one or more of the site's own options, by label or id (e.g. `fwd`). Several values = any of them. [one of: fwd, rwd, 4wd]
- `transmission` (array, optional) — Vehicles: transmission: one or more of the site's own options, by label or id (e.g. `manual`). Several values = any of them. [one of: manual, automatic, other]
- `body_type` (array, optional) — Cars: body type: one or more of the site's own options, by label or id (e.g. `bus`). Several values = any of them. [one of: bus, convertible, coupe, hatchback, minivan, offroad, pickup, sedan, truck, suv, wagon, van, other]
- `paint_color` (array, optional) — Cars / RVs: paint colour: one or more of the site's own options, by label or id (e.g. `black`). Several values = any of them. [one of: black, blue, brown, green, grey, orange, purple, red, silver, white, yellow, custom]
- `cylinders` (array, optional) — Cars / RVs: cylinders: one or more of the site's own options, by label or id (e.g. `3_cylinders`). Several values = any of them. [one of: 3_cylinders, 4_cylinders, 5_cylinders, 6_cylinders, 8_cylinders, 10_cylinders, 12_cylinders, other]
- `title_status` (array, optional) — Vehicles: title status: one or more of the site's own options, by label or id (e.g. `clean`). Several values = any of them. [one of: clean, salvage, rebuilt, parts_only, lien, missing]
- `fuel_type` (array, optional) — Cars / RVs: fuel: one or more of the site's own options, by label or id (e.g. `gas`). Several values = any of them. [one of: gas, diesel, hybrid, electric, other]
- `min_engine_cc` (number, optional) — Motorcycles: minimum engine displacement (cc).
- `max_engine_cc` (number, optional) — Motorcycles: maximum engine displacement (cc).
- `street_legal` (boolean, optional) — Motorcycles: street legal.
- `motor_type` (array, optional) — Motorcycles: motor: one or more of the site's own options, by label or id (e.g. `gas`). Several values = any of them. [one of: gas, electric, other]
- `motorcycle_type` (array, optional) — Motorcycles: type: one or more of the site's own options, by label or id (e.g. `adventure`). Several values = any of them. [one of: adventure, bobber, cafe_racer, chopper, cruiser, dirtbike, dual_sport, scooter_moped, sport_bike, sport_touring, standard, touring, trike, other]
- `min_length` (number, optional) — Boats (length overall) / RVs (feet): minimum length.
- `max_length` (number, optional) — Boats (length overall) / RVs (feet): maximum length.
- `boat_type` (array, optional) — Boats: type: one or more of the site's own options, by label or id (e.g. `commercial_boat`). Several values = any of them. [one of: commercial_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, other]
- `propulsion_type` (array, optional) — Boats: propulsion: one or more of the site's own options, by label or id (e.g. `sail`). Several values = any of them. [one of: sail, power, human]
- `rv_type` (array, optional) — RVs: type: one or more of the site's own options, by label or id (e.g. `class_a`). Several values = any of them. [one of: class_a, class_b, class_c, fifth_wheel_trailer, travel_trailer, hybrid_trailer, folding_popup_trailer, teardrop_compact_trailer, toy_hauler, truck_camper, other]
- `atv_type` (array, optional) — ATVs / 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. [one of: snowmobile, atv, side_by_side_utv, golf_cart, go_kart, dune_buggy, other]
- `delivery_available` (boolean, optional) — For sale: delivery available.
- `cryptocurrency_ok` (boolean, optional) — For sale: cryptocurrency accepted.
- `language` (array, optional) — Language of the posting: one or more of the site's own options, by label or id (e.g. `afrikaans`). Several values = any of them. [one of: afrikaans, català, dansk, deutsch, english, español, suomi, français, italiano, nederlands, norsk, português, svenska, filipino, türkçe, 中文, العربية, 日本語, 한국말, русский, tiếng_việt]

**Returns:** results[]{id (listing id for `listing`), post_id, title, url, price, price_text, currency, last_posted_at (last (re)post or renewal: what sort=newest orders by; the original posting time is listing.posted_at), category{id, code, name, section}, is_nearby (a row Craigslist appended from a nearby area because the searched place has few results), location{site, area_id, subarea, name, neighborhood, latitude, longitude, country, region}, distance_km, distance_mi, thumbnail, images[], image_count, bedrooms, area, area_unit, odometer, monthly_payment_text, job_title, company, compensation, start_date, end_date, open_house_dates[], sale_dates[], duplicate_group} + count + total (the site's own count for the searched place ONLY — appended nearby rows are not in it; meta.nearby_rows says how many rows on the page are nearby rows) + max_rows + page + page_size + has_more + sort + sort_requested + filters_applied{} + category{} + location{site, name, region, country, postal_code, latitude, longitude, radius, currency, distance_unit, area_unit}

**Example request body:**
```json
{
  "location": "sfbay",
  "min_year": 2015
}
```

### POST https://api.reefapi.com/craigslist/v1/housing — 3 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.

**Parameters:**
- `location` (string, required) — 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` (string, optional, default "apa") — Craigslist category code (a housing category; default `apa`). All codes: action `categories`. [one of: hhh, rea, reo, reb, apa, hou, roo, sha, sub, off, prk, sbw, swp, vac, rew]
- `query` (string, optional) — Search words, e.g. `honda civic`, `studio`, `react developer`.
- `subarea` (string, optional) — 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` (integer, optional, default 30) — Search radius around a postal code or coordinates, in the site's distance unit (miles in the US / GB, km elsewhere). Default 30.
- `sort` (enum, optional) — Order: 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`. [one of: newest, oldest, price_low, price_high, distance, relevance, upcoming]
- `page` (integer, optional, default 1) — 1-based page. Pages are `page_size` rows of one result list; the site serves at most 10 000 rows per search.
- `page_size` (integer, optional, default 120) — Rows per page: 60, 120 (default) or 360. [one of: 60, 120, 360]
- `include_nearby` (boolean, optional, default true) — 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_only` (boolean, optional) — Match the query in titles only.
- `has_image` (boolean, optional) — Only listings with a photo.
- `posted_today` (boolean, optional) — Only listings posted today.
- `min_price` (number, optional) — Minimum price (site currency).
- `max_price` (number, optional) — Maximum price (site currency).
- `seller_type` (enum, optional) — For sale / vehicles / real estate: owner or dealer (all by default). [one of: owner, dealer]
- `min_bedrooms` (number, optional) — Housing: minimum bedrooms.
- `max_bedrooms` (number, optional) — Housing: maximum bedrooms.
- `min_bathrooms` (number, optional) — Housing: minimum bathrooms.
- `max_bathrooms` (number, optional) — Housing: maximum bathrooms.
- `min_area` (number, optional) — Housing: minimum floor area (ft² in the US / CA, m² elsewhere: the site's unit).
- `max_area` (number, optional) — Housing: maximum floor area (the site's unit).
- `private_room` (boolean, optional) — Rooms / sublets: private room.
- `private_bath` (boolean, optional) — Rooms / sublets: private bath.
- `cats_ok` (boolean, optional) — Housing: cats OK.
- `dogs_ok` (boolean, optional) — Housing: dogs OK.
- `furnished` (boolean, optional) — Housing: furnished.
- `no_smoking` (boolean, optional) — Housing: no smoking.
- `wheelchair_accessible` (boolean, optional) — Housing: wheelchair accessible.
- `air_conditioning` (boolean, optional) — Housing: air conditioning.
- `ev_charging` (boolean, optional) — Housing: EV charging.
- `no_broker_fee` (boolean, optional) — Housing for rent: no broker fee.
- `no_application_fee` (boolean, optional) — Housing for rent: no application fee.
- `rent_period` (array, optional) — Housing: rent period: one or more of the site's own options, by label or id (e.g. `daily`). Several values = any of them. [one of: daily, weekly, monthly]
- `availability` (enum, optional) — Housing: available within 30 days or beyond 30 days. [one of: within_30_days, beyond_30_days]
- `housing_type` (array, optional) — Housing: housing type: one or more of the site's own options, by label or id (e.g. `apartment`). Several values = any of them. [one of: apartment, condo, cottage_cabin, duplex, flat, house, in_law, loft, townhouse, manufactured, assisted_living, land]
- `laundry` (array, optional) — Housing: 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. [one of: w_d_in_unit, w_d_hookups, laundry_in_bldg, laundry_on_site, no_laundry_on_site]
- `parking` (array, optional) — Housing: parking: one or more of the site's own options, by label or id (e.g. `carport`). Several values = any of them. [one of: carport, attached_garage, detached_garage, off_street_parking, street_parking, valet_parking, no_parking]
- `show_duplicates` (boolean, optional) — Housing only: also show listings the site marks as duplicates (hidden by default there).
- `date` (string, optional) — 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.

**Returns:** results[]{id (listing id for `listing`), post_id, title, url, price, price_text, currency, last_posted_at (last (re)post or renewal: what sort=newest orders by; the original posting time is listing.posted_at), category{id, code, name, section}, is_nearby (a row Craigslist appended from a nearby area because the searched place has few results), location{site, area_id, subarea, name, neighborhood, latitude, longitude, country, region}, distance_km, distance_mi, thumbnail, images[], image_count, bedrooms, area, area_unit, odometer, monthly_payment_text, job_title, company, compensation, start_date, end_date, open_house_dates[], sale_dates[], duplicate_group} + count + total (the site's own count for the searched place ONLY — appended nearby rows are not in it; meta.nearby_rows says how many rows on the page are nearby rows) + max_rows + page + page_size + has_more + sort + sort_requested + filters_applied{} + category{} + location{site, name, region, country, postal_code, latitude, longitude, radius, currency, distance_unit, area_unit}

**Example request body:**
```json
{
  "location": "newyork",
  "min_bedrooms": 2
}
```

### POST https://api.reefapi.com/craigslist/v1/jobs — 2 credits
Job listings (31 job categories) with title, company and pay where the poster gives them; employment type, remote, internship and non-profit filters.

**Parameters:**
- `location` (string, required) — 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` (string, optional, default "jjj") — Craigslist category code (a jobs category; default `jjj`). All codes: action `categories`. [one of: jjj, 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, sec]
- `query` (string, optional) — Search words, e.g. `honda civic`, `studio`, `react developer`.
- `subarea` (string, optional) — 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` (integer, optional, default 30) — Search radius around a postal code or coordinates, in the site's distance unit (miles in the US / GB, km elsewhere). Default 30.
- `sort` (enum, optional) — Order: 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`. [one of: newest, oldest, price_low, price_high, distance, relevance, upcoming]
- `page` (integer, optional, default 1) — 1-based page. Pages are `page_size` rows of one result list; the site serves at most 10 000 rows per search.
- `page_size` (integer, optional, default 120) — Rows per page: 60, 120 (default) or 360. [one of: 60, 120, 360]
- `include_nearby` (boolean, optional, default true) — 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_only` (boolean, optional) — Match the query in titles only.
- `has_image` (boolean, optional) — Only listings with a photo.
- `posted_today` (boolean, optional) — Only listings posted today.
- `hide_duplicates` (boolean, optional) — Collapse the site's duplicate clusters (not offered in housing; use show_duplicates there).
- `employment_type` (array, optional) — Jobs: employment type: one or more of the site's own options, by label or id (e.g. `full_time`). Several values = any of them. [one of: full_time, part_time, contract, employees_choice]
- `is_remote` (boolean, optional) — Jobs: telecommuting OK.
- `is_internship` (boolean, optional) — Jobs: internship.
- `is_nonprofit` (boolean, optional) — Jobs: non-profit organisation.

**Returns:** results[]{id (listing id for `listing`), post_id, title, url, price, price_text, currency, last_posted_at (last (re)post or renewal: what sort=newest orders by; the original posting time is listing.posted_at), category{id, code, name, section}, is_nearby (a row Craigslist appended from a nearby area because the searched place has few results), location{site, area_id, subarea, name, neighborhood, latitude, longitude, country, region}, distance_km, distance_mi, thumbnail, images[], image_count, bedrooms, area, area_unit, odometer, monthly_payment_text, job_title, company, compensation, start_date, end_date, open_house_dates[], sale_dates[], duplicate_group} + count + total (the site's own count for the searched place ONLY — appended nearby rows are not in it; meta.nearby_rows says how many rows on the page are nearby rows) + max_rows + page + page_size + has_more + sort + sort_requested + filters_applied{} + category{} + location{site, name, region, country, postal_code, latitude, longitude, radius, currency, distance_unit, area_unit}

**Example request body:**
```json
{
  "location": "sfbay"
}
```

### POST https://api.reefapi.com/craigslist/v1/listing — 1 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.

**Parameters:**
- `listing` (string, required) — 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`).

**Returns:** id, post_id, title, url, description, price, price_text, currency, posted_at (the page's "posted"), last_posted_at (last (re)post), updated_at (the page's "updated", null when never edited), updated_at, is_repost, repost_of_post_id, category{id, code, name, section}, section, company_name, attributes[]{key, label, value}, specs{key: typed value}, location{site, area_id, area_name, area_abbreviation, subarea, subarea_name, name, neighborhood, address, street_address, latitude, longitude, location_type (pin|area), country, region}, images[], image_count, thumbnail, has_contact_info, has_other_listings_by_poster, notices[]

**Example request body:**
```json
{
  "listing": "jnZ87DKWyQzjpZjXu8iL1f"
}
```

### POST https://api.reefapi.com/craigslist/v1/counts — 1 credit
How many listings match a query in every section and category of one site (or subarea): where to search before searching.

**Parameters:**
- `location` (string, required) — 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`.
- `query` (string, required) — Search words, e.g. `honda`, `iphone`, `nurse` (Craigslist counts need a query).
- `subarea` (string, optional) — 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` (integer, optional, default 30) — Search radius around a postal code or coordinates, in the site's distance unit (miles in the US / GB, km elsewhere). Default 30.

**Returns:** total + sections[]{section, code, name, count, categories[]{code, name, count}} + site

**Example request body:**
```json
{
  "location": "sfbay",
  "query": "honda"
}
```

### POST https://api.reefapi.com/craigslist/v1/suggestions — 1 credit
Search-box autocomplete: Craigslist-wide, or one site's (narrowed to a category); type make_model completes vehicle makes and models.

**Parameters:**
- `query` (string, required) — The start of a search, e.g. `hond`.
- `location` (string, optional) — Optional Craigslist site for that site's own suggestions.
- `category` (string, optional) — Optional category code with `location` (default sss; cta for make_model).
- `type` (enum, optional, default "search") — search (default) or make_model. [one of: search, make_model]

**Returns:** suggestions[] + count + query + type + site

**Example request body:**
```json
{
  "query": "bike"
}
```

### POST https://api.reefapi.com/craigslist/v1/filters — 1 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.

**Parameters:**
- `category` (string, required) — Category code, e.g. `cta`, `apa`, `jjj`, `bia`.
- `location` (string, optional) — Optional site (default sfbay); the form also lists that site's subareas.

**Returns:** category{} + filters[]{param, upstream, label, type (boolean|number|choice|multi_choice|text), options[]{value, label}} + sort_options[] + subareas[] + unmapped[]

**Example request body:**
```json
{
  "category": "sss"
}
```

### POST https://api.reefapi.com/craigslist/v1/locations — 1 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.

**Parameters:**
- `query` (string, optional) — Site name / hostname / code to look up, e.g. `san francisco`, `nyc`.
- `country` (string, optional) — 2-letter country code, e.g. US, CA, GB, DE.
- `region` (string, optional) — State / province code, e.g. CA, NY, ON.

**Returns:** count + locations[]{id, site, abbreviation, name, short_name, country, region, latitude, longitude, timezone, url, subareas[]{id, code, name, short_name}}

**Example request body:**
```json
{
  "country": "CA"
}
```

### POST https://api.reefapi.com/craigslist/v1/nearby_locations — 1 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).

**Parameters:**
- `location` (string, required) — `latitude,longitude` or a Craigslist site.
- `limit` (integer, optional, default 10) — How many sites (default 10).

**Returns:** place{city, region, country, postal_code, latitude, longitude, site, subarea, suggested_radius} + count + locations[]{…site fields, distance_km, distance_mi}

**Example request body:**
```json
{
  "location": "sfbay"
}
```

### POST https://api.reefapi.com/craigslist/v1/categories — 0 credits
Every Craigslist category code in its 8 sections (134 categories), with the by-owner / by-dealer codes of each for-sale category.

**Parameters:**
- `section` (enum, optional) — Optional section: for_sale, housing, jobs, gigs, services, community, events, resumes. [one of: for_sale, housing, jobs, gigs, services, community, events, resumes]

**Returns:** section_count + category_count + sections[]{section, code, name, category_count, categories[]{id, code, name, description, by_owner{id, code, name}, by_dealer}}

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=craigslist
- Human docs page: https://reefapi.com/docs/craigslist
- Overview page: https://reefapi.com/craigslist-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
