# Craigslist Search API (craigslist.search)

- Canonical page: [https://everyinfra.com/en/craigslist-api/search](https://everyinfra.com/en/craigslist-api/search?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "craigslist", "action": "search", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 20, max 200 per call
- Mode: sync; add "mode": "async" for slow tasks

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=craigslist&action=search

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | Specifies the search term for Craigslist classifieds, such as bicycle. The resulting listings depend on the selected category, allowing the same term to query sales, housing, or jobs. |
| category | enum: cars_trucks / community / electronics / events / for_sale / furniture / gigs / housing_apartments_houses / housing_rooms_shares / housing_sublets_temporary / jobs / resumes / services | no | not declared | Specifies the listing category slug: for_sale (default), cars_trucks, electronics, furniture, housing_apartments_houses, housing_rooms_shares, housing_sublets_temporary, jobs, gigs, resumes, services, community, or events. |
| country | enum: anchorage / atlanta / austin / baltimore / boston / calgary / charlotte / chicago / cincinnati / cleveland / columbus / dallas / denver / detroit / edmonton / hartford / honolulu / houston / indianapolis / kansascity / lasvegas / losangeles / miami / milwaukee / minneapolis / montreal / nashville / newhaven / newyork / orlando / ottawa / philadelphia / phoenix / pittsburgh / portland / providence / raleigh / richmond / sacramento / salem / saltlakecity / sanantonio / sandiego / seattle / sfbay / stlouis / tampa / toronto / vancouver / washingtondc | no | not declared | Selects the target city subdomain rather than a country code. Accepts values listed in the schema, such as newyork, sfbay, or toronto. When provided, overrides subdomain selections made by region or location. |
| location | not declared | no | not declared | Acts as a fallback input for region, evaluated only when region is omitted. Maps to a Craigslist city subdomain, not street addresses, zip codes, or geographic coordinates. |
| max_price | not declared | no | not declared | Sets the maximum listing price for the selected city subdomain and category. Used alongside min_price, with currency and billing cycles determined by individual listings. Filtering uses whole numbers: decimals round up (145.98 becomes 146). |
| min_price | not declared | no | not declared | Sets the minimum listing price for the selected city subdomain and category. Does not represent API request costs, and price meanings vary across categories (such as resale items versus housing rent). Filtering uses whole numbers: decimals round down (39.81 becomes 39). |
| region | not declared | no | not declared | Specifies the city subdomain slug, such as newyork, sfbay, or toronto. Accepts exact list values or common aliases like nyc, la, dc, and sanfrancisco. Unrecognized inputs fall back to newyork; check the returned location rather than assuming the input was used. |
| sort | enum: newest / price_asc / relevance | no | not declared | Sorts results by post date (newest), ascending price (price_asc), or relevance (relevance), defaulting to post date if omitted. Does not sort by seller reputation or transaction volume. |
| limit | integer (1–200) | no | 20 | The most rows to return in this call, an integer from 1 to 200. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| url | Link to the record on the platform. |
| title | Title. null when the platform has no titles (for example text-only posts). |
| text | Body text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so). |
| price | Price as a number without a currency symbol; see currency. |
| currency | Currency code of the price (for example CNY, USD). If price is present but currency is null, do not assume a currency. |
| category | Category name in the platform's own taxonomy, not normalized across platforms. |
| location | Location description passed through as is; the format varies by platform. |
| posted_at | Publish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it. |
| lat | platform-native meaning |
| lng | platform-native meaning |
| emails | Contact email addresses (a record can have several), passed through as is with duplicates removed. |
| phones | platform-native meaning |
| images | Array of image links in the platform's display order; absent when there are no images. |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "craigslist",
  "action": "search",
  "params": {
    "keyword": "bicycle"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "craigslist",
        "action": "search",
        "params": {
            "keyword": "bicycle",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 20. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "craigslist",
  "action": "search",
  "results": [
    {
      "id": "•••",
      "url": "https://www.craigslist.org/view/d/commack-24-speed-bike-hard-lady-cruz/h4HVcd5nzs8KyR3HVN9TZG",
      "title": "24 Speed BIKE HARD LADY CRUZ Ultra Light StepThru Hybrid Disc 14”frame",
      "text": "Selling 24 Speed BIKE HARD LADY CRUZ Ultra Light StepThru Hybrid Bicycle\n700 x 35C tires, 14 inch frame, trigger shifters, Suspension seat, Front Suspension with lockouts, Mechanical DISC Brakes, water bottle holder, Adjustable handle bars for a more comfort fit, under seat compa…",
      "price": 230,
      "currency": "USD",
      "category": "For Sale",
      "location": "Commack/Western Suffolk",
      "posted_at": "2026-09-13T04:19:38-04:00",
      "lat": 40.843,
      "lng": -73.2799,
      "images": [
        "https://images.craigslist.org/00N0N_9Zg27TVO3x4_0jm0ew_600x450.jpg",
        "https://images.craigslist.org/00707_hLl3WR8t1Kp_0jm0ew_600x450.jpg",
        "https://images.craigslist.org/00l0l_9fmzO7RF18k_0jm0ew_600x450.jpg"
      ],
      "platform": "craigslist"
    },
    {
      "id": "•••",
      "url": "https://www.craigslist.org/view/d/commack-24-speed-bike-hard-lady-cruz/hZcuH7RbcmTr6Q1VoiiEYd",
      "title": "24 Speed BIKE HARD LADY CRUZ Ultra Light StepThru Hybrid Disc 14”frame",
      "text": "Selling 24 Speed BIKE HARD LADY CRUZ Ultra Light StepThru Hybrid Bicycle\n700 x 35C tires, 14 inch frame, trigger shifters, Suspension seat, Front Suspension with lockouts, Mechanical DISC Brakes, water bottle holder, Adjustable handle bars for a more comfort fit, under seat compa…",
      "price": 230,
      "currency": "USD",
      "category": "For Sale",
      "location": "Commack/Western Suffolk",
      "posted_at": "2026-09-13T03:44:18-04:00",
      "lat": 40.843,
      "lng": -73.2799,
      "images": [
        "https://images.craigslist.org/00Q0Q_1L0TRDLmTUr_0CI0t2_600x450.jpg",
        "https://images.craigslist.org/00o0o_jzfT4Xvtn1Q_0CI0t2_600x450.jpg",
        "https://images.craigslist.org/00V0V_ehTbYzbjHWi_0CI0t2_600x450.jpg"
      ],
      "platform": "craigslist"
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=craigslist
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
