{"ok":true,"site":"craigslist","host":"sfbay.craigslist.org","about":"San Francisco Bay Area Craigslist: search listings by keyword, category, area, price, distance and other filters through Craigslist's JSON search API, look up postings by id, and get category counts and search suggestions.","commands":[{"command":"search-listings","summary":"Search SF Bay Area Craigslist listings by keyword, category, area/subarea/city, price range, zip+distance, sort and category-specific filters. Returns the first batch of compact results plus decode ta","params":[{"name":"query","type":"string","description":"Keywords to search for"},{"name":"cat","type":"string","description":"Category abbreviation, e.g. sss (all for sale), bia (bicycles), apa (apartments), cta (cars+trucks), sof (software jobs). Use get-category-counts to discover more.","default":"sss"},{"name":"searchPath","type":"string","description":"Location scope: area/sfbay (whole Bay Area), subarea/<abbr> where abbr is sfc, eby, sby, pen, nby or scz, or city/<slug>, e.g. city/oakland-ca","default":"area/sfbay"},{"name":"min_price","type":"number","description":"Minimum price in USD"},{"name":"max_price","type":"number","description":"Maximum price in USD"},{"name":"postal","type":"string","description":"ZIP code to search around (use with radius)"},{"name":"radius","type":"number","description":"Distance in miles from the postal ZIP code"},{"name":"sort","type":"string","description":"Sort order: date (newest), rel (relevance), priceasc, pricedsc, dist (needs postal)"},{"name":"hasPic","type":"number","description":"1 = only listings that have photos"},{"name":"purveyor","type":"string","description":"Seller type for for-sale categories","oneOf":["owner","dealer"]},{"name":"min_bedrooms","type":"number","description":"Minimum bedrooms (housing categories such as apa)"},{"name":"no_smoking","type":"number","description":"1 = non-smoking only (housing)"},{"name":"auto_make_model","type":"string","description":"Car make/model filter for cta, e.g. 'toyota tacoma' (see suggest-make-model)"},{"name":"userpostingid","type":"string","description":"Posting id to find more ads by the same seller"}],"exampleUrl":"https://clify-dev.netlify.app/craigslist/search-listings?query=bicycle&cat=sss&searchPath=area%2Fsfbay&min_price=100&max_price=800&postal=94110&sort=priceasc"},{"command":"search-listings-more","summary":"Fetch the next batch of results for a search already run with search-listings (the site has no page 2; it loads more batches as you scroll).","params":[{"name":"batch","type":"string","required":true,"description":"Batch spec '0-<offset>-1080-6-0-<ts1>-<ts2>'. Raise the offset by 1080 for each batch and keep the other parts as the site sent them."},{"name":"cacheId","type":"string","required":true,"description":"cacheId returned by the search-listings response for this search"}],"exampleUrl":"https://clify-dev.netlify.app/craigslist/search-listings-more?batch=0-1080-1080-6-0-1792566210-1792566336&cacheId=MToBizevob6RIBxqY6JQ22iOs2AaYUg7mb8KBWJVniCnn6oTSgxpoO34H2aBNcMUXihn3uRwyrJ_zjH_NPwvgOrS25SME_clhB8CeFPy4Suo4t2FaOn3BlXjdOt_QRckIPX5XVbN4WqUnhH80U82LgHzjHKkv-qBbS_hCriBXP5bLPvM_sTCIoDPSC3y1G8"},{"command":"get-postings","summary":"Look up full posting records (title, price, location, neighborhood, images, seo slug, posted date) by posting id. This is how the site loads the favorites list.","params":[{"name":"ids","type":"string","required":true,"description":"Base64 of 'items:<postingId>', e.g. 'items:7986972918' becomes aXRlbXM6Nzk4Njk3MjkxOA=="}],"exampleUrl":"https://clify-dev.netlify.app/craigslist/get-postings?ids=aXRlbXM6Nzk4Njk3MjkxOA%3D%3D"},{"command":"get-category-counts","summary":"Count matching listings per category for a Craigslist search URL. Useful to pick a category abbreviation (cat) for a query.","params":[{"name":"searchUrl","type":"string","required":true,"description":"Craigslist search URL, e.g. https://www.craigslist.org/search/area/sfbay?cat=sss&query=bicycle"},{"name":"include_types","type":"number","description":"1 = also include category types"}],"exampleUrl":"https://clify-dev.netlify.app/craigslist/get-category-counts?searchUrl=https%3A%2F%2Fwww.craigslist.org%2Fsearch%2Farea%2Fsfbay%3Fcat%3Dsss%26query%3Dbicycle"},{"command":"suggest-search","summary":"Autocomplete search keywords for the SF Bay Area, optionally within one category.","params":[{"name":"query","type":"string","required":true,"description":"Partial search text"},{"name":"cat","type":"string","description":"Category abbreviation to scope suggestions, e.g. cta"}],"exampleUrl":"https://clify-dev.netlify.app/craigslist/suggest-search?query=bicycle"},{"command":"get-likely-categories","summary":"Guess which category abbreviations (cat) best match a keyword query in the SF Bay Area.","params":[{"name":"query","type":"string","required":true,"description":"Search keywords"}],"exampleUrl":"https://clify-dev.netlify.app/craigslist/get-likely-categories?query=bicycle"},{"command":"suggest-make-model","summary":"Autocomplete car make/model names for the auto_make_model filter of search-listings (cars+trucks).","params":[{"name":"query","type":"string","required":true,"description":"Partial make/model, e.g. 'toyota tacoma'"}],"exampleUrl":"https://clify-dev.netlify.app/craigslist/suggest-make-model?query=toyota+tacoma"}]}