Spiral gives your agent every tool with one account. Browse the tools →

AlexandriaListingsAvailable now

Craigslist · Search

craigslist-org/housing/search

Search property, job and marketplace listings with Craigslist · Search from Alexandria through one Spiral API key. Search rentals in a region; narrow large regions with subarea (abbreviations come from regions, e.g. sfbay: sfc san francisco, eby east bay) or with lat/lon/radius around a neighborhood; then call posting with a card's url or posting_id for the full text and attributes. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

Pricing

$0.00873 per call.

Limits

Runs
In the background
Returns
json
Longest queue wait
1 hour
Run deadline
5 minutes
Longest run, end to end
225 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
region requiredtext—

Craigslist subdomain or area abbreviation from regions. Pattern: ^[A-Za-z0-9-]+$.

category requiredone of
apa, roo, sub, swp, hhh
—

apa apartments/housing for rent, roo rooms & shares, sub sublets & temporary, swp housing swap, hhh all housing.

latnumber
-90 to 90
—

Latitude of the search centre; requires lon and radius. Postings from outside the circle that Craigslist appends when local results run out are marked nearby=true.

lonnumber
-180 to 180
—

Longitude of the search centre; requires lat and radius.

petslist—

Require cats OK and/or dogs OK.

sortone of
newest, rent_low, rent_high, relevance
—

Default newest.

querytext—

Keyword search over title and body.

cursortext—

next_cursor from the previous page. Pattern: ^o:[0-9]{1,5}$.

radiusnumber
… to 500
—

Search radius around lat/lon in miles (Craigslist's search distance unit); requires lat and lon.

subareatext—

Restrict to one Craigslist sub-area of the region: its abbreviation or name from regions (subareas), e.g. sfc / san francisco, eby / east bay, brk / brooklyn. Only regions with sub-areas accept it. Not combinable with lat/lon/radius.

beds_minnumber
0 to 8
—

Minimum bedrooms (0 = studio allowed).

max_rentnumber
0 to 100000000
—

Maximum rent in whole units of the region currency.

min_rentnumber
0 to 100000000
—

Minimum rent in whole units of the region currency.

baths_minnumber
0 to 8
—

baths_min

furnishedtrue or false—

True to require furnished.

housing_typelist—

Any of these types; omit for all.

no_broker_feetrue or false—

True to require no broker fee.

posted_since_hoursnumber
1 to 1080
—

Only postings posted within this many hours; enforced on the source posted timestamps (Craigslist's own switch is 'posted today' for <= 24).

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "craigslist-org/housing/search",
    "input": {
      "region": "<region>",
      "category": "apa"
    }
  }'

Frequently asked questions

How much does Craigslist · Search cost?

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use Craigslist · Search through an API?

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "craigslist-org/housing/search"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with Alexandria to use Craigslist · Search?

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

Can my AI agent use Craigslist · Search?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.