Skip to main content

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.

$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

​
urls
array
required
List · Facebook Marketplace URLs. Examples: facebook.com/marketplace/sanfrancisco/clothing, /category/electronics.
​
maxResults
integer
default:50
Number · Listings per URL. Use 0 for all.
​
includeListingDetails
boolean
default:true
Toggle · Pull extra details per listing (description, seller info). Adds cost.

​
Response columns

FieldDisplay nameType
listingUrlListing URLurl
titleTitletext
pricePricetext
cityCitytext
stateStatetext
liveLiveboolean
soldSoldboolean
hiddenHiddenboolean
photoPhotourl

​
Example

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
  }
}'

​
Example response

Response
{
  "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"
    }
  ]
}