{"name":"Craigslist For Sale Post Details API","description":"One Craigslist for-sale post per URL, with item title, price, coordinates, posted date, full description and photos.","api_id":"generated_5a6ac3f12c9f1054beb88449","slug":"craigslist-for-sale-post-details-api","source":{"name":"www.craigslist.org","domain":"craigslist.org","url":"https://www.craigslist.org/"},"category":"commerce","countries":[],"languages":[],"record_types":[],"tags":[],"limitations":[],"updated":"2026-11-22","note":"Sample records are saved samples, not a live run. CleanedWeb is not affiliated with the source.","version":"1.0","versions":[{"major":1,"latest_minor":"1.0","status":"current","sunset_at":null}],"changelog":[{"version":"1.0","date":"2026-11-21T09:07:18.000Z","kind":"major","changes":[]}],"version_note":"Pin a major with \"version\": N in the run body (an integer). Leave it out and the call runs on the latest major. A sunset major runs on the latest major and the response says rerouted. An unknown major answers 404 catalog_version_not_found and lists the available majors.","endpoints":[{"endpoint_id":"generated_5a6ac3f12c9f1054beb88449_search","name":"Get Craigslist For Sale Post Details by URL","description":"Return the one record of a page of this kind, given the page's URL on the site.","definition_version":"cd023e19c36c009549cf15347840228fcc3df7e484d8a5247d9a0efac9d331ce","method":"POST","path":"/v1/catalog/public/apis/generated_5a6ac3f12c9f1054beb88449/endpoints/generated_5a6ac3f12c9f1054beb88449_search/run","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_5a6ac3f12c9f1054beb88449/endpoints/generated_5a6ac3f12c9f1054beb88449_search/run","authentication":{"type":"bearer","scheme":"Authorization: Bearer <API key>","scope":"run","note":"Reading this file and the live catalog needs no credential. A run needs a CleanedWeb account and uses the credits of its workspace.","docs":"https://cleanedweb.com/docs/run-catalog-api/"},"required_headers":[{"name":"Authorization","value":"Bearer YOUR_API_KEY","description":"An API key with the run scope."},{"name":"Idempotency-Key","value":"UNIQUE_REQUEST_ID","description":"Required. Save it before you send; reuse it only to retry the same request and to read the result. 1-200 characters: letters, numbers, . _ : -"},{"name":"Content-Type","value":"application/json","description":"The body is JSON."}],"request_body":{"input":"An object that follows input_schema.","max_items":"Optional. Stop after this many records.","timeout_seconds":"Optional, 60-86400, default 10800.","wait_seconds":"Optional, 0-86400, default 90. How long the request waits before answering 202.","version":"Optional integer major. Leave it out for the latest major."},"input_schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","minLength":1,"description":"A page of the same kind as the build page, on craigslist.org: its path matches /view/d/{slug}/{code}. It need not be the build page.","examples":["https://www.craigslist.org/view/d/portage-epiphone-inspired-by-gibson/j8ZspnBTNzHhQCpzv578sX"]}},"required":["url"],"additionalProperties":false},"output_schema":{"type":"object","properties":{"title":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"images":{"type":"array","items":{"type":["null","string"]}},"description":{"type":"string"},"price":{"type":"string"},"currency":{"type":"string"},"image":{"type":"string"},"region":{"type":"string"},"country":{"type":"string"},"locality":{"type":"string"},"category":{"type":"string"},"category_path":{"type":"array","items":{"type":["null","string"]}},"condition":{"type":"string"},"make_manufacturer":{"type":"string"},"model_name_number":{"type":"string"},"post_id":{"type":"string"},"posted":{"type":"string"},"updated":{"type":"string"},"condition_url":{"type":"string"},"media":{"type":"array","items":{"properties":{"alt":{"type":["null","string"]},"type":{"type":["null","string"]},"url":{"type":["null","string"]}},"type":["null","object"]}},"posted_at":{"type":"string"}},"additionalProperties":true,"required":["title","url"]},"output_schema_note":"Some fields the source returns are not published here (identifiers, personal details and page-building noise). A record can carry fields this schema does not list, so additionalProperties is true. Do not reject a record for an extra field. The live contract, linked as live_contract, lists every field the saved definition declares.","examples":[{"kind":"saved_validation_records","saved_at":"2026-11-21T09:07:18.027Z","live_verified":false,"request":{"input":{"url":"https://www.craigslist.org/view/d/portage-epiphone-inspired-by-gibson/j8ZspnBTNzHhQCpzv578sX"}},"records_shown":1,"records_saved":1,"records":[{"category":"musical instruments - by owner","category_path":["craigslist: chicago","northwest indiana","for sale","musical instruments - by owner"],"condition":"like new","condition_url":"https://www.craigslist.org/search/area/chicago?cat=msa&condition=20","country":"US","currency":"USD","description":"On sale!!! Beautiful condition no wear. Been sitting on the stand. These are great guitars. No case","image":"https://images.craigslist.org/00l0l_fDcBuiid7cw_0jz0CI_600x450.jpg","images":["https://images.craigslist.org/00l0l_fDcBuiid7cw_0jz0CI_600x450.jpg","https://images.craigslist.org/00w0w_jzbUVqjtizV_0CI0k5_600x450.jpg","https://images.craigslist.org/01616_6dFD8OdTeNk_09G0cU_600x450.jpg","https://images.craigslist.org/00101_eZqx2TsFebP_09G0cU_600x450.jpg","https://images.craigslist.org/00505_7tmVgH6mTTw_09G0cU_600x450.jpg"],"locality":"Portage","make_manufacturer":"Epiphone","model_name_number":"ES335","post_id":"7979166234","posted":"2026-10-06T16:43:18-0500","posted_at":"2026-10-06T16:43:18-0500","price":"450.00","region":"IN","title":"Epiphone inspired by Gibson ES335 - $450 (Portage)","updated":"2026-11-19T23:51:46-0600","url":"https://www.craigslist.org/view/d/portage-epiphone-inspired-by-gibson/j8ZspnBTNzHhQCpzv578sX"}]}],"request_example":{"body":{"input":{"url":"https://www.craigslist.org/view/d/portage-epiphone-inspired-by-gibson/j8ZspnBTNzHhQCpzv578sX"},"version":1,"max_items":25},"curl":"curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_5a6ac3f12c9f1054beb88449/endpoints/generated_5a6ac3f12c9f1054beb88449_search/run \\\n  -H \"Authorization: Bearer YOUR_API_KEY\" \\\n  -H \"Idempotency-Key: UNIQUE_REQUEST_ID\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"input\": {\n    \"url\": \"https://www.craigslist.org/view/d/portage-epiphone-inspired-by-gibson/j8ZspnBTNzHhQCpzv578sX\"\n  },\n  \"version\": 1,\n  \"max_items\": 25\n}'"},"result":{"method":"GET","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_5a6ac3f12c9f1054beb88449/endpoints/generated_5a6ac3f12c9f1054beb88449_search/result","note":"A run that does not end within wait_seconds answers 202. Read the result with the same API key and the same Idempotency-Key."},"links":{"page":"https://cleanedweb.com/catalog/craigslist-for-sale-post-details-api/","markdown":"https://cleanedweb.com/catalog/craigslist-for-sale-post-details-api/index.md","live_contract":"https://app.cleanedweb.com/api/catalog/apis/generated_5a6ac3f12c9f1054beb88449/endpoints/generated_5a6ac3f12c9f1054beb88449_search/contract","run_docs":"https://cleanedweb.com/docs/run-catalog-api/"}}],"links":{"page":"https://cleanedweb.com/catalog/craigslist-for-sale-post-details-api/","markdown":"https://cleanedweb.com/catalog/craigslist-for-sale-post-details-api/index.md","contract":"https://cleanedweb.com/catalog/craigslist-for-sale-post-details-api/contract.json","catalog":"https://cleanedweb.com/catalog/","index":"https://cleanedweb.com/catalog/index.json","openapi":"https://cleanedweb.com/catalog/openapi.json"}}
