# CrowdPull Facebook Marketplace Scraper

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

Scrapes Facebook Marketplace listings by search query, location, price range, and URL filters, returning structured product listing datasets.

## Facts

- Endpoint: POST https://crowdpull.click/api/actors/facebook-marketplace-scraper/call
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/crowdpull-facebook-marketplace-scraper-31499eec
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VIo4TVKqsFAvQmUhV5GPM

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-facebook-marketplace-scraper-31499eec -d '<json body>'
```

Example prompt: Search Facebook Marketplace for used road bikes in Seattle under $800, within 50km, listed after 2025-01-01, and return up to 40 results with details included.

## When to prefer this

Use this endpoint when you need structured Facebook Marketplace listing data — prices, titles, locations, images — for a specific keyword, category, or city. Prefer this over generic web scrapers when Facebook Marketplace is specifically the target source and you need marketplace-native filters like price range, radius, and recency.

## Known failure modes

- Invalid or private Facebook Marketplace URL returns empty results or error
- Location string not recognized by source returns zero results
- Rate limiting or bot detection by Facebook causes job failure
- Job times out before results are ready (waitForFinishSeconds exceeded)
- maxItems or maxResults outside allowed range returns validation error
- Malformed date in untilDate field causes filtering failure

## 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 containing a job ID, status string, and resultSetId. The agent must poll for completion using the resultSetId to retrieve the actual scraped Facebook Marketplace listings dataset.

## 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."
    },
    "urls": {
     "type": "array",
     "items": {
      "type": "string"
     },
     "description": "Public URLs accepted by the selected source."
    },
    "query": {
     "type": "string",
     "description": "Search query or keyword."
    },
    "location": {
     "type": "string",
     "description": "City, ZIP, state, neighborhood, or source-supported location."
    },
    "maxItems": {
     "type": "integer",
     "default": 25,
     "maximum": 250,
     "minimum": 1
    },
    "maxPrice": {
     "type": "integer",
     "minimum": 0,
     "description": "Maximum price in local currency cents."
    },
    "minPrice": {
     "type": "integer",
     "minimum": 0,
     "description": "Minimum price in local currency cents."
    },
    "radiusKm": {
     "type": "integer",
     "default": 65,
     "maximum": 500,
     "minimum": 1
    },
    "startUrls": {
     "type": "array",
     "items": {
      "type": "string"
     },
     "description": "Public source URLs to collect from."
    },
    "untilDate": {
     "type": "string",
     "description": "Only keep listings on or after this YYYY-MM-DD date."
    },
    "maxResults": {
     "type": "integer",
     "default": 25,
     "maximum": 250,
     "minimum": 1
    },
    "maxListings": {
     "type": "integer",
     "default": 25,
     "maximum": 250,
     "minimum": 1
    },
    "searchQuery": {
     "type": "string",
     "description": "Search query or keyword."
    },
    "includeDetails": {
     "type": "boolean",
     "default": false
    },
    "marketplaceUrls": {
     "type": "array",
     "items": {
      "type": "string"
     },
     "description": "Facebook Marketplace city, category, or search URLs."
    },
    "strictFiltering": {
     "type": "boolean",
     "default": false
    }
   },
   "description": "Facebook Marketplace 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
    },
    "wai
… (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-facebook-marketplace-scraper-31499eec/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)