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

# Facebook Marketplace

> Scrape listings from Facebook Marketplace — title, price, location, and photos — by city or category URL.

`$2.5 / 1k listings`

Scrape listings from Facebook Marketplace — title, price, location, and photos — by city or category URL.

## Endpoint

`POST /api/v1/agents/facebook/marketplace/run`

## Parameters

<ParamField body="urls" type="array" required>
  **List** · Facebook Marketplace URLs. Examples: facebook.com/marketplace/sanfrancisco/clothing, /category/electronics.
</ParamField>

<ParamField body="maxResults" type="integer" default={50}>
  **Number** · Listings per URL. Use 0 for all.
</ParamField>

<ParamField body="includeListingDetails" type="boolean" default={true}>
  **Toggle** · Pull extra details per listing (description, seller info). Adds cost.
</ParamField>

## Response columns

| Field        | Display name | Type    |
| ------------ | ------------ | ------- |
| `listingUrl` | Listing URL  | url     |
| `title`      | Title        | text    |
| `price`      | Price        | text    |
| `city`       | City         | text    |
| `state`      | State        | text    |
| `live`       | Live         | boolean |
| `sold`       | Sold         | boolean |
| `hidden`     | Hidden       | boolean |
| `photo`      | Photo        | url     |

## Example

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://api.mindcase.co/api/v1/agents/facebook/marketplace/run \
    -H "Authorization: Bearer mk_live_abc123def456" \
    -H "Content-Type: application/json" \
    -d '{
    "params": {
      "urls": [
        "https://www.facebook.com/marketplace/sanfrancisco/clothing"
      ],
      "maxResults": 50
    }
  }'
  ```

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

  resp = requests.post(
      "https://api.mindcase.co/api/v1/agents/facebook/marketplace/run",
      headers={"Authorization": "Bearer mk_live_abc123def456"},
      json={"params": {
      "urls": [
          "https://www.facebook.com/marketplace/sanfrancisco/clothing"
      ],
      "maxResults": 50
  }},
  )
  data = resp.json()
  ```
</CodeGroup>

### Example response

```json Response theme={null}
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "listingUrl": "https://www.facebook.com/marketplace/item/2696877814029054",
      "title": "Free Table",
      "price": "FREE",
      "city": "San Mateo",
      "state": "CA",
      "live": true,
      "sold": false,
      "hidden": false,
      "photo": "https://scontent-phx1-1.xx.fbcdn.net/v/t39.84726-6/684303815_1699856987842736_2441509458333266175_n.jpg?stp=c0.87.526.526a_dst-jpg_p526x395_tt6&_nc_cat=1&ccb=1-7&_nc_sid=92e707&_nc_ohc=iZflkw48e20Q7kNvwEGFRD5&_nc_oc=AdrfjF9iukEwqIwQzgXfjNW8sh7Jf8M3HrjzpPimYdw1pPEzVsHMUGLu_BCZozQpBKM&_nc_zt=14&_nc_ht=scontent-phx1-1.xx&_nc_gid=8uq9KQvjyRVXfX_X0ycbfQ&_nc_ss=72289&oh=00_Af51qtr1YI5FUMXl9TM18nNmFGJY1QqE1Mt0eYOqizKw9g&oe=69FEAADD"
    }
  ]
}
```