What you get
| Field | Type | Sample value |
|---|---|---|
title |
string | 1998 Toyota Tacoma Limited |
price |
number | 12400 |
currency |
string | USD |
description |
string | Limited 2dr Extended Cab 4WD SB (3.4L 6cyl naturally aspired 5M) |
fuel |
string | gas |
transmission |
string | automatic |
location |
string | city of san francisco |
condition |
string | like new |
All 27 fields
Key fields
titlepricecurrencydescriptionfueltransmissionlocationconditionurlcategoryodometertitle_statusvehicle_yearvehicle_typeimagesaddress_localityaddress_regionaddress_countryvehicle_name
Technical fields
category_pathtypecylindersdrivepost_idregioncountrytyped_price
Every field with its type, and the schemas, are in contract.json.
Sample records
2 saved records. This is a saved sample, not a live run.
title |
price |
currency |
description |
fuel |
transmission |
|---|---|---|---|---|---|
| 1998 Toyota Tacoma Limited | 12400 | USD | Limited 2dr Extended Cab 4WD SB (3.4L 6cyl naturally aspired 5M) | gas | automatic |
| 2006 Mercedes C230 sport | 4000 | USD | 2006 Mercedes C230 sport, 2.5 liter V6 with sport mode, automatic transmission,… | gas | automatic |
Scroll sideways to see more columns.
Inputs
-
searchstring | array of stringOptional. Text for the site's search box. Leave it out to read everything.
-
auto_make_modeltextOptional. Free text: any auto make model the site serves, up to 100 characters. A name the site does not serve is refused with input_value_unverified. Leave it out for the default listing.
-
categorychoiceOptional. Filters by the site's category control. Default: cta.
-
hubchoiceOptional. Filters by the site's hub control.
-
auto_drivetrainchoiceOptional. Filters by the site's auto drivetrain control.
-
auto_transmissionchoiceOptional. Filters by the site's auto transmission control.
-
auto_fuel_typechoiceOptional. Filters by the site's auto fuel type control.
-
auto_cylinderschoiceOptional. Filters by the site's auto cylinders control.
-
conditionchoiceOptional. Filters by the site's condition control.
-
auto_bodytypechoiceOptional. Filters by the site's auto bodytype control.
-
auto_paintchoiceOptional. Filters by the site's auto paint control.
-
auto_title_statuschoiceOptional. Filters by the site's auto title status control.
-
crypto_currency_okbooleanFilters by the site's crypto currency ok control.
-
delivery_availablebooleanFilters by the site's delivery available control.
-
languagechoiceOptional. Filters by the site's language control.
-
min_pricestring | integerOptional. Omit it to leave this side open.
-
max_pricestring | integerOptional. Omit it to leave this side open.
-
min_monthly_paymentstring | integerOptional. Omit it to leave this side open.
-
max_monthly_paymentstring | integerOptional. Omit it to leave this side open.
-
min_auto_milesstring | integerOptional. Omit it to leave this side open.
-
max_auto_milesstring | integerOptional. Omit it to leave this side open.
-
min_auto_yearstring | integerOptional. Omit it to leave this side open.
-
max_auto_yearstring | integerOptional. Omit it to leave this side open.
enrich_records is on by default and adds the fields that only appear on each record's detail page. Send false to read list fields only. See Run an API.
Request
POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_6003a8cf27962b04abcf6b66/endpoints/generated_6003a8cf27962b04abcf6b66_search/run
curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_6003a8cf27962b04abcf6b66/endpoints/generated_6003a8cf27962b04abcf6b66_search/run \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Idempotency-Key: UNIQUE_REQUEST_ID" \
-H "Content-Type: application/json" \
-d '{
"input": {
"auto_make_model": "toyota"
},
"version": 1,
"max_items": 25
}'
Save the Idempotency-Key before you send, and reuse it only to retry the same request. The key needs the run scope. See Run a catalog API.
version pins major v1, whose newest minor (1.1) answers. Leave it out and the call runs on the latest major.
Changelog
-
v1.1 ·
-
v1.0 (major) ·
Use it from an AI agent
Open in your coding agent
Add CleanedWeb to your agent as an MCP server, such as a custom connector in Claude or ChatGPT, then sign in with your CleanedWeb account. The agent can then find this API, run it and read the records. An API key with the read and run scopes works too.
https://api.cleanedweb.com/mcp?profile=catalog
Then ask, for example: Use CleanedWeb to get 25 records from the Craigslist Cars & Trucks (SF Bay Area) API.
The agent calls get_api with generated_6003a8cf27962b04abcf6b66, then run_api. Runs are charged like any other run. See Connect an MCP client.
Coverage
- Category
- Commerce
Reach. A run reads until the source ends or your max_items, timeout_seconds or budget stops it.
CleanedWeb is not affiliated with www.craigslist.org.