# CrowdPull Craigslist Scraper API

> CrowdPull Craigslist Scraper API is a paid API for AI agents from crowdpull.click, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-14).

Scrapes Craigslist classifieds listings by city, category, search query, or URL and returns structured listing data as a dataset job.

## Facts

- Endpoint: POST https://crowdpull.click/api/actors/craigslist-scraper/call
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/crowdpull-craigslist-scraper-api-2e65aee5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PXUuNEvgyk2u3Ygpkq72h

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability crowdpull-craigslist-scraper-api-2e65aee5 -d '<json body>'
```

Example prompt: Search Craigslist in the detroit region for used motorcycles under the 'mca' category and pull up to 50 listings with full details included.

## When to prefer this

Use this endpoint when you need structured data from Craigslist classifieds — apartments, jobs, for-sale items, gigs, services — filtered by city, category, keyword, or location. Prefer it over general web scrapers when the target is specifically Craigslist and you want a managed, rate-limited job with a result set ID for downstream retrieval.

## Known failure modes

- Invalid city slug returns no results or error
- Unsupported category slug causes the job to fail or return empty data
- maxItems exceeding 250 is rejected by schema validation
- URL not accessible on Craigslist returns an empty result set
- Job timeout if waitForFinishSeconds is too low for large result sets
- Payment failure (402) if USDC balance is insufficient

## How this service works

CrowdPull turns public web pages into useful datasets for marketplaces, housing, reviews, jobs, social posts, drug prices, video, and public records.

## Output

Returns a job token and job object with an ID, status, and optional resultSetId that can be used to retrieve the scraped Craigslist listings once the job completes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "required": [],
   "properties": {
    "url": {
     "type": "string",
     "description": "Single public URL accepted by the selected source."
    },
    "city": {
     "type": "string",
     "description": "Craigslist city or region slug, for example detroit."
    },
    "urls": {
     "type": "array",
     "items": {
      "type": "string"
     },
     "description": "Public URLs accepted by the selected source."
    },
    "query": {
     "type": "string",
     "description": "Search query or keyword."
    },
    "category": {
     "type": "string",
     "description": "Craigslist category slug such as sss, apa, cta, or jjg."
    },
    "location": {
     "type": "string",
     "description": "City, ZIP, state, neighborhood, or source-supported location."
    },
    "maxItems": {
     "type": "integer",
     "default": 25,
     "maximum": 250,
     "minimum": 1
    },
    "startUrls": {
     "type": "array",
     "items": {
      "type": "string"
     },
     "description": "Public source URLs to collect from."
    },
    "maxResults": {
     "type": "integer",
     "default": 25,
     "maximum": 250,
     "minimum": 1
    },
    "postalCode": {
     "type": "string"
    },
    "maxListings": {
     "type": "integer",
     "default": 25,
     "maximum": 250,
     "minimum": 1
    },
    "searchQuery": {
     "type": "string",
     "description": "Search query or keyword."
    },
    "includeDetails": {
     "type": "boolean",
     "default": false
    },
    "searchDistance": {
     "type": "integer",
     "maximum": 500,
     "minimum": 1
    },
    "maxResultsPerSearch": {
     "type": "integer",
     "maximum": 250,
     "minimum": 1
    }
   },
   "description": "Craigslist Classifieds Scraper input. Pass the same public URLs, search terms, filters, and limits you would use on the source page. Extra source-specific fields are forwarded to the runner.",
   "additionalProperties": true
  },
  "options": {
   "type": "object",
   "properties": {
    "build": {
     "type": "string",
     "maxLength": 100,
     "minLength": 1
    },
    "memory": {
     "type": "integer",
     "maximum": 8192,
     "minimum": 128
    },
    "waitForFinishSeconds": {
     "type": "integer",
     "default": 10,
     "maximum": 60,
     "minimum": 0
    }
   },
   "description": "Optional CrowdPull job options. CrowdPull caps each paid job so low-cost agent calls cannot accidentally start a large c
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "type": "object",
  "required": [
   "token",
   "job"
  ],
  "properties": {
   "job": {
    "type": "object",
    "required": [
     "id",
     "status"
    ],
    "properties": {
     "id": {
      "type": "string"
     },
     "status": {
      "type": "string"
     },
     "resultSetId": {
      "type": "string"
     }
    },
    "additionalProperties": true
   },
   "token": {
    "type": "string"
   }
  },
  "additionalProperties": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/crowdpull-craigslist-scraper-api-2e65aee5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from crowdpull.click](https://www.zero.xyz/host/crowdpull.click/llms.txt)
