Skip to main content
Reads a Craigslist search page with a five-digit US ZIP code in postal, like sfbay.craigslist.org/search/sss?query=bike&postal=94103, and returns a list of listings as JSON.

Make a request

Send the page’s URL to scrape with a json format that names the parser. Get an API key in the Quickstart.

Read the response

The parser’s data is in data.json. Its fields include results, cursor, page and total. This sample is cut to the first items.

Options

Send options in the options object of the json format.

Price

$0.001 per 10 listings. See Pricing.

Limits and errors

  • The URL must be a Craigslist search page with a five-digit US ZIP code in postal, like sfbay.craigslist.org/search/sss?query=bike&postal=94103. Any other URL fails with invalidRequest.
  • The answer comes back in data.json. If the page cannot be read, the call fails with an error code from Errors.