Craigslist

get/craigslist/search

Request

  • Base URL: https://scrappa.co/api
  • URL: https://scrappa.co/api/craigslist/search
  • Auth: API key in header X-API-KEY

Query parameters

sitestring nullable

Craigslist city site hostname from the sites endpoint, e.g. portland or sfbay. Required unless subarea is set. Example: portland.

subareastring nullable

Subarea abbreviation from the sites endpoint, e.g. sfc for the city of San Francisco. Use instead of site.

categorystring

Category code from the categories endpoint, e.g. bik (bicycles by owner). Aggregate codes also work: sss (all for sale), bia (all bicycles), hhh (all housing). Defaults to sss.

querystring nullable

Search keywords, up to 200 characters. Example: bike.

min_priceinteger nullable

Minimum price in whole units of the site currency. Example: 50.

max_priceinteger nullable

Maximum price in whole units of the site currency. Must be at least min_price. Example: 300.

sort'date' | 'dateoldest' | 'rel' | 'priceasc' | 'pricedsc'

date, dateoldest, rel, priceasc or pricedsc. Craigslist defaults to relevance with a query and to newest first without.

pageinteger

1-based page number, 1 to 28. Each page has up to 360 results. Defaults to 1.

Response

string required

Changes

No recorded changes to this operation across all 3 revisions of this API.