Facebook Marketplace
3 endpoints.
- GET /v1/facebook/marketplace_item
- GET /v1/facebook/marketplace_location_search
- GET /v1/facebook/marketplace_search
GET /v1/facebook/marketplace_item
Marketplace Item
Fetches details for a Facebook Marketplace item by item id or Marketplace item URL, including title, description, price, location, condition, photos, seller, and availability flags. Rental listings can include listing_date_text and availability_text from Facebook's Marketplace GraphQL response, for example 'Listed over a week ago' and 'Available now'. creation_time can still be null when Facebook does not expose an exact timestamp.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
id | query | string | Facebook Marketplace item id |
url | query | string | Facebook Marketplace item URL |
Request
curl "https://api.scrapall.bipsport.com/scapi/v1/facebook/marketplace_item" \
-H "X-Scapi-Key: YOUR_API_KEY"const res = await fetch("https://api.scrapall.bipsport.com/scapi/v1/facebook/marketplace_item", {
headers: { "X-Scapi-Key": "YOUR_API_KEY" }
});
const data = await res.json();import requests
r = requests.get(
"https://api.scrapall.bipsport.com/scapi/v1/facebook/marketplace_item",
headers={"X-Scapi-Key": "YOUR_API_KEY"},
)
print(r.json())Response 200 (sample)
{
"id": "1656586118821988",
"url": "https://www.facebook.com/marketplace/item/1656586118821988/",
"title": "Specialized Hardrock GSX - Super Clean Vintage Restomod - INCLUDES FREE TUNE UP",
"description": "Was going to hang on to this one bc I absolutely love how it looks, but the 20” frame is just bit too large for me. Riders over 6’ would be comfy on this one...",
"creation_time": "2026-05-15T16:57:39.000Z",
"listing_date_text": null,
"availability_text": null,
"location_text": "Austin, TX",
"location": {
"latitude": 30.401916503906,
"longitude": -97.761840820312
},
"price": {
"formatted_amount_zeros_stripped": "$380",
"amount_with_offset_in_currency": 38000,
"amount": 380,
"currency": "USD"
},
"strikethrough_price": null,
"category_id": "1658310421102081",
"attributes": [
{
"attribute_name": "Condition",
"value": "used_good",
"label": "Used - Good"
}
],
"photos": [
{
"id": "2810586442651711",
"url": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.84726-6/701290950_2810586459318376_3780262866029042186_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=111&ccb=1-7&_nc_sid=...",
"width": 960,
"height": 720,
"accessibility_caption": "No photo description available."
}
],
"is_hidden": false,
"is_live": true,
"is_pending": false,
"is_sold": false,
"is_viewer_seller": false,
"is_shipping_offered": false,
"is_buy_now_enabled": false,
"messaging_enabled": true,
"delivery_types": [
"IN_PERSON"
],
"share_uri": "https://www.facebook.com/marketplace/item/1656586118821988/",
"seller": null
}GET /v1/facebook/marketplace_location_search
Marketplace Location Search
Searches Facebook Marketplace locations/cities and returns coordinates you can use with the Marketplace Search endpoint.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
query required | query | string | Location search query |
Request
curl "https://api.scrapall.bipsport.com/scapi/v1/facebook/marketplace_location_search?query=Austin" \
-H "X-Scapi-Key: YOUR_API_KEY"const res = await fetch("https://api.scrapall.bipsport.com/scapi/v1/facebook/marketplace_location_search?query=Austin", {
headers: { "X-Scapi-Key": "YOUR_API_KEY" }
});
const data = await res.json();import requests
r = requests.get(
"https://api.scrapall.bipsport.com/scapi/v1/facebook/marketplace_location_search?query=Austin",
headers={"X-Scapi-Key": "YOUR_API_KEY"},
)
print(r.json())Response 200 (sample)
{
"locations": [
{
"name": "Austin",
"subtitle": "Austin, IL · 22,116 people checked in here",
"multi_line_address": [],
"page_id": "108120015875983",
"latitude": 41.894086,
"longitude": -87.763202,
"city": "Chicago",
"postal_code": "60644-1112"
}
]
}GET /v1/facebook/marketplace_search
Marketplace Search
Searches Facebook Marketplace listings by keyword and lat/lng. Each page contains up to 24 listings. Each listing includes creation_time as an ISO 8601 UTC timestamp when Facebook exposes an exact listing timestamp, plus listing_date_text when available; either field can be null. Pass category_id to restrict results to the numeric Facebook Marketplace category ID returned on listing results. Supports pagination with the returned cursor. Pass the cursor value back as-is. The sort and date filters use the same values as Facebook's Marketplace UI. creation_time_descend usually orders the first pages newest first, but Facebook can insert newer listings on later cursor pages. date_listed uses Facebook's calendar-day buckets, so last_24_hours can include listings from the prior calendar day rather than enforcing an exact rolling 24-hour cutoff. For alerting/new-item workflows, continue paging while has_next_page is true and dedupe by listing id.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
query required | query | string | Search keyword |
lat required | query | number | Latitude for the search location |
lng required | query | number | Longitude for the search location |
category_id | query | string | Numeric Facebook Marketplace category ID. Listing results include this value as category_id. |
radius_km | query | number | Search radius in kilometers |
min_price | query | number | Minimum listing price |
max_price | query | number | Maximum listing price |
sort_by | query | string | Facebook Marketplace sort option. creation_time_descend usually orders the first pages newest first, but Facebook can insert newer listings on later cursor pages. one of: suggested, distance_ascend, creation_time_descend, price_ascend, price_descend |
delivery_method | query | string | Delivery filter one of: all, local_pickup, shipping |
condition | query | string | Condition filter one of: new, used_like_new, used_good, used_fair |
date_listed | query | string | Facebook Marketplace date filter. Uses the same calendar-day buckets as the UI, so last_24_hours can include listings from the prior calendar day. one of: all, 1, 7, 30, last_24_hours, last_7_days, last_30_days |
availability | query | string | Availability filter one of: available, sold, all |
next_cursor | query | string | Opaque pagination cursor returned from the previous response. Pass it back as-is. |
Request
curl "https://api.scrapall.bipsport.com/scapi/v1/facebook/marketplace_search?query=bike&lat=30.2677&lng=-97.7475" \
-H "X-Scapi-Key: YOUR_API_KEY"const res = await fetch("https://api.scrapall.bipsport.com/scapi/v1/facebook/marketplace_search?query=bike&lat=30.2677&lng=-97.7475", {
headers: { "X-Scapi-Key": "YOUR_API_KEY" }
});
const data = await res.json();import requests
r = requests.get(
"https://api.scrapall.bipsport.com/scapi/v1/facebook/marketplace_search?query=bike&lat=30.2677&lng=-97.7475",
headers={"X-Scapi-Key": "YOUR_API_KEY"},
)
print(r.json())Response 200 (sample)
{
"listings": [
{
"id": "1880804689276480",
"url": "https://www.facebook.com/marketplace/item/1880804689276480/",
"title": "ANCHEER E Bike",
"creation_time": null,
"listing_date_text": null,
"price": {
"formatted_amount": "$300",
"amount_with_offset_in_currency": 30000,
"amount": 300
},
"strikethrough_price": null,
"location": {
"city": "Austin",
"state": "TX",
"display_name": "Austin, Texas",
"city_page_id": "106224666074625"
},
"primary_photo": {
"id": "742022888999863",
"url": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.84726-6/696326464_742022902333195_6718077421452400338_n.jpg?stp=c43.0.260.260a_dst-jpg_p261x260_tt6&_nc_cat=106&cc..."
},
"category_id": "1658310421102081",
"is_hidden": false,
"is_live": true,
"is_pending": false,
"is_sold": false,
"is_viewer_seller": false,
"delivery_types": [
"IN_PERSON"
],
"story_type": "POST",
"story_key": "26881002338175809"
}
],
"next_cursor": "eyJwZyI6MCwiYjJj....",
"has_next_page": true
}