Craigslist craigslist Search API

Scrape the newest Craigslist listings near a US ZIP code

curl --request POST \
  --url https://api.stophy.dev/v1/craigslist/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "zipCode": "94103",
  "query": "road bike",
  "maxPrice": 800,
  "limit": 10
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({zipCode: '94103', query: 'road bike', maxPrice: 800, limit: 10})
};

fetch('https://api.stophy.dev/v1/craigslist/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.stophy.dev/v1/craigslist/search"

payload = {
    "zipCode": "94103",
    "query": "road bike",
    "maxPrice": 800,
    "limit": 10
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "success": true,
  "data": {
    "totalResults": 0,
    "results": [
      {
        "listingUrl": "<string>",
        "publishedAt": "2023-11-07T05:31:56Z",
        "listingId": "<string>",
        "title": "<string>",
        "price": 123,
        "location": "<string>",
        "latitude": 123,
        "longitude": 123,
        "bedrooms": 0,
        "sqft": 0,
        "imageUrl": "<string>"
      }
    ]
  },
  "creditsUsed": 123,
  "requestId": "<string>"
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

POST

craigslist

Scrape the newest Craigslist listings near a US ZIP code

curl --request POST \
  --url https://api.stophy.dev/v1/craigslist/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "zipCode": "94103",
  "query": "road bike",
  "maxPrice": 800,
  "limit": 10
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({zipCode: '94103', query: 'road bike', maxPrice: 800, limit: 10})
};

fetch('https://api.stophy.dev/v1/craigslist/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.stophy.dev/v1/craigslist/search"

payload = {
    "zipCode": "94103",
    "query": "road bike",
    "maxPrice": 800,
    "limit": 10
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "success": true,
  "data": {
    "totalResults": 0,
    "results": [
      {
        "listingUrl": "<string>",
        "publishedAt": "2023-11-07T05:31:56Z",
        "listingId": "<string>",
        "title": "<string>",
        "price": 123,
        "location": "<string>",
        "latitude": 123,
        "longitude": 123,
        "bedrooms": 0,
        "sqft": 0,
        "imageUrl": "<string>"
      }
    ]
  },
  "creditsUsed": 123,
  "requestId": "<string>"
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

Scrape the newest Craigslist listings near a US ZIP code.

Request

zipCode is required.

import { Stophy } from "stophy";

const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
const result = await stophy.craigslist.search({ zipCode: "94103", query: "road bike", maxPrice: 800, limit: 10 });
console.log(result.data.results);

from stophy import Stophy

stophy = Stophy()  # reads STOPHY_API_KEY
result = stophy.craigslist.search(zip_code="94103", query="road bike", max_price=800, limit=10)
print(result["data"]["results"])

curl -X POST https://api.stophy.dev/v1/craigslist/search \
  -H "Authorization: Bearer $STOPHY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"zipCode":"94103","query":"road bike","maxPrice":800,"limit":10}'

stophy craigslist search 94103 --query "road bike" --maxPrice 800 --limit 10

Response

If successful, the response body contains the standard envelope. data.results[] contains the listings, newest first, each with its title, price, location and link. The following example is a real response, truncated: each list shows one item and long strings are cut.

{
  "success": true,
  "data": {
    "totalResults": 719,
    "results": [
      {
        "listingId": "7951123997",
        "listingUrl": "https://www.craigslist.org/view/d/san-mateo-got-gary-fisher-klunker/2qNKE1a54sBSCGGXEBiaaj",
        "title": "Got A Gary Fisher Klunker Panther Diamondback LAWWILL Pro Cruiser !?🤔",
        "price": 123,
        "location": "san mateo",
        "latitude": 37.5395,
        "longitude": -122.2998,
        "imageUrl": "https://images.craigslist.org/00l0l_dkFwe5RfJb5_05a03S_600x450.jpg",
        "publishedAt": "2026-10-31T00:17:06.000Z"
      }
    ]
  },
  "creditsUsed": 1,
  "requestId": "2fe9dbad-fc48-4890-9751-0b24b596035b"
}

Field	Type	Description
`publishedAt`	string (ISO 8601)	The publication time, in UTC.

For every field, see the response schema on this page.

Listings come newest first, at most 360 per search, so narrow with filters when totalResults is higher.

Optional parameters

Parameter	Type	Description
`query`	string	Search words (e.g., “road bike”). Leave out to list the newest in the category.
`radius`	integer	Miles around the ZIP code, 25 by default. Must be between 1 and 250. If unset, defaults to `25`.
`category`	string	Specifies which listings to search, `forSale` by default. Acceptable values are `forSale`, `carsAndTrucks`, `apartments`, `housing`, `jobs`, `gigs`, `services` and `free`. If unset, defaults to `forSale`.
`minPrice`	integer	The minimum price in US dollars (e.g., 50). Must be between 0 and 100000000.
`maxPrice`	integer	The maximum price in US dollars (e.g., 500). Must be between 0 and 100000000.
`limit`	integer	The maximum number of listings to return. Billed at 1 credit per 10 returned. Must be between 1 and 360. If unset, defaults to `20`.

Billing

A successful request consumes 1 credit per 10 listings, up to 36 credits. Requests that fail, or that return no items, are not billed. Set limit to cap the number of items returned and billed.

Pagination

This method is not paginated. A single request returns the complete result.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

maxTextLength

integer

Cut every text value in the response to this many characters. A value that was cut ends with …, and a page whose text was cut has isTruncated set to true. A screenshot is never cut. Leave it out to get the full text.

Required range: x >= 1

Body

application/json

zipCode

string

required

US ZIP code to search around (e.g., "94103")

Pattern: ^\d{5}$

query

string

Search words (e.g., "road bike"). Leave out to list the newest in the category

Required string length: 1 - 200

radius

integer

default:25

Miles around the ZIP code, 25 by default

Required range: 1 <= x <= 250

Response

The data, and the credits this call used.

success

any

required

data

object

required

Show child attributes

creditsUsed

integer

required

requestId

string

required

Using the API

Catalog

Account

Search and AI answers

Video

Social

Places and travel

Jobs

Shopping

Apps

Real estate

Ads

Craigslist craigslist Search API

Request

Response

Optional parameters

Billing

Authorizations

Query Parameters

Body

Response

​Request

​Response

​Optional parameters

​Billing

​Pagination

Authorizations

Query Parameters

Body

Response

Request

Response

Optional parameters

Billing

Pagination