> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Facebook Marketplace API

> Extract Facebook Marketplace listings (title, price, condition, location, attributes, and photos) from any category or search URL.

`POST /v1/data/facebook/marketplace/run`

**Pricing:** $0.01 per listing ($10.00 per 1,000).

Paste a Facebook Marketplace category or search URL to pull its listings.

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**url** `string` *required*

A Facebook Marketplace category or search URL. Examples: [https://www.facebook.com/marketplace/nyc/electronics](https://www.facebook.com/marketplace/nyc/electronics) or [https://www.facebook.com/marketplace/london/search/?query=bicycle](https://www.facebook.com/marketplace/london/search/?query=bicycle)

Format e.g. `https://www.facebook.com/marketplace/nyc/electronics`.

**maxResults** `integer`

Number of listings to return in total. Use 0 for all.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/facebook/marketplace/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "url": "https://www.facebook.com/marketplace/nyc/electronics",
    "maxResults": 15
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/facebook/marketplace/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "url": "https://www.facebook.com/marketplace/nyc/electronics",
    "maxResults": 15
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/facebook/marketplace/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "url": "https://www.facebook.com/marketplace/nyc/electronics",
  "maxResults": 15
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one listing, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `listingTitle` | Listing Title | text |
| `listingUrl` | Listing URL | text |
| `description` | Description | text |
| `price` | Price | number |
| `currency` | Currency | text |
| `originalPrice` | Original Price | number |
| `condition` | Condition | text |
| `attributes` | Attributes | object\_array |
| `mileage` | Mileage | text |
| `location` | Location | text |
| `city` | City | text |
| `state` | State | text |
| `postalCode` | Postal Code | text |
| `country` | Country | text |
| `latitude` | Latitude | number |
| `longitude` | Longitude | number |
| `deliveryOptions` | Delivery Options | array |
| `listedAt` | Listed At | text |
| `primaryPhoto` | Primary Photo | text |
| `photos` | Photos | object\_array |
| `videoUrl` | Video URL | text |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "facebook/marketplace",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "videoUrl": null,
      "deliveryOptions": [
        "IN_PERSON"
      ],
      "city": null,
      "photos": [
        {
          "url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.84726-6/773583106_1036075355890321_4953481547455292138_n.jpg?stp=dst-jpg_p720x720_tt6&_nc_cat=101&ccb=1-7&_nc_sid=...",
          "caption": "No photo description available."
        },
        {
          "url": "https://scontent-ord5-1.xx.fbcdn.net/v/t45.5328-4/774905858_1053250397110138_5972487655668437575_n.jpg?stp=dst-jpg_p720x720_tt6&_nc_cat=111&ccb=1-7&_nc_sid=2...",
          "caption": "No photo description available."
        }
      ],
      "attributes": [
        {
          "name": "Condition",
          "value": "Used - like new"
        }
      ],
      "listedAt": "2026-08-14T18:53:11.000Z",
      "condition": "Used - like new",
      "price": "125.00",
      "country": null,
      "description": null,
      "longitude": -73.547973632812,
      "mileage": null,
      "state": null,
      "primaryPhoto": "https://scontent-det1-1.xx.fbcdn.net/v/t39.84726-6/773583106_1036075355890321_4953481547455292138_n.jpg?stp=c43.0.260.260a_dst-jpg_p261x260_tt6&_nc_cat=101&c...",
      "location": "Stamford, CT",
      "listingTitle": "Excellent Vizio smart TV. This unit has two stand legs and a power cord.\n42”\nOnly 2 months of use.",
      "postalCode": null,
      "latitude": 41.058654785156,
      "listingUrl": "https://www.facebook.com/marketplace/item/1035857442407674/",
      "originalPrice": null,
      "currency": "USD"
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.