Item
curl --request GET \
--url https://api.sociavault.com/v1/scrape/facebook-marketplace/item \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.sociavault.com/v1/scrape/facebook-marketplace/item"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.sociavault.com/v1/scrape/facebook-marketplace/item', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sociavault.com/v1/scrape/facebook-marketplace/item",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sociavault.com/v1/scrape/facebook-marketplace/item"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sociavault.com/v1/scrape/facebook-marketplace/item")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sociavault.com/v1/scrape/facebook-marketplace/item")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"success": true,
"id": "1278061654412635",
"url": "https://www.facebook.com/marketplace/item/1278061654412635/",
"title": "Formal shoes",
"description": "Formal shoes used only once... size UK12.",
"creation_time": "2026-05-15T12:03:51.000Z",
"location_text": "London, United Kingdom",
"location": {
"latitude": 51.512145996094,
"longitude": -0.1043701171875
},
"price": {
"formatted_amount_zeros_stripped": "£5",
"amount_with_offset_in_currency": 664,
"amount": 5,
"currency": "GBP"
},
"strikethrough_price": null,
"category_id": "931157863635831",
"attributes": {
"0": {
"attribute_name": "Condition",
"value": "used_good",
"label": "Used - Good"
}
},
"photos": {
"0": {
"id": "1889521335087397",
"url": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.84726-6/699132406_1889521345087396_1900687902739816956_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=100&ccb=1-7&_nc_sid=92e707&_nc_ohc=NWY0ouwhkyQQ7kNvwGUburJ&_nc_oc=AdpP5K8nFbn_rxoPMSXKdTEVvU1yrohGJKsqNDAottRhGa-cPQ6wfuJe1lCckE0lr-U&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=FYxxqOqNnr7L-aCsjjIJSA&_nc_ss=7e289&oh=00_Af6NoRpfi6Xah2sym375Rc5xGJN_rizevUTsMxgfhuI2Tg&oe=6A0E0F17",
"width": 443,
"height": 960,
"accessibility_caption": "No photo description available."
},
"1": {
"id": "1741302177009337",
"url": "https://scontent-bos5-1.xx.fbcdn.net/v/t45.5328-4/696698524_1741302180342670_8753490698983285357_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=102&ccb=1-7&_nc_sid=247b10&_nc_ohc=jxxu6gpPe48Q7kNvwEl_RH6&_nc_oc=AdrbNL5_6KB9YhiGwae5FkjfSSXGSSo6ixBpvsdyCau6CsbdeeuOPMXkpAFBCbrLPho&_nc_zt=23&_nc_ht=scontent-bos5-1.xx&_nc_gid=FYxxqOqNnr7L-aCsjjIJSA&_nc_ss=7e289&oh=00_Af7MenQudv2cM5fkdLAcMNOEinrZudbev0-BhBQH0NVemA&oe=6A0E005B",
"width": 443,
"height": 960,
"accessibility_caption": "No photo description available."
},
"2": {
"id": "957534360394038",
"url": "https://scontent-bos5-1.xx.fbcdn.net/v/t45.5328-4/697158330_957534363727371_710797950200649114_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=106&ccb=1-7&_nc_sid=247b10&_nc_ohc=so2agAzsOFAQ7kNvwFeon1g&_nc_oc=AdrE4yXI0FK8NmWDN1Vuyb83xiejDRVe7saS2GOy8mamOxS3h4-Y-GntfunxB16ERjk&_nc_zt=23&_nc_ht=scontent-bos5-1.xx&_nc_gid=FYxxqOqNnr7L-aCsjjIJSA&_nc_ss=7e289&oh=00_Af7gJvnYvAF6a6IivkKXfZpqNE4jgLZys2N3Sw7xh0ThQQ&oe=6A0E12FC",
"width": 443,
"height": 960,
"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": {
"0": "IN_PERSON"
},
"share_uri": "https://www.facebook.com/marketplace/item/1278061654412635/",
"seller": null
},
"credits_used": 1
}{
"error": "Either Marketplace item id or url parameter is required",
"endpoint": "<string>",
"credits_required": 123
}{
"error": "Invalid API key",
"docs": "https://docs.sociavault.com/authentication"
}{
"error": "Insufficient credits",
"required": 1,
"available": 0
}{
"error": "Service configuration error"
}Facebook Marketplace
Item
Fetch full details for a single Facebook Marketplace listing by its ID or URL.
GET
/
v1
/
scrape
/
facebook-marketplace
/
item
Item
curl --request GET \
--url https://api.sociavault.com/v1/scrape/facebook-marketplace/item \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.sociavault.com/v1/scrape/facebook-marketplace/item"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.sociavault.com/v1/scrape/facebook-marketplace/item', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sociavault.com/v1/scrape/facebook-marketplace/item",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sociavault.com/v1/scrape/facebook-marketplace/item"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sociavault.com/v1/scrape/facebook-marketplace/item")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sociavault.com/v1/scrape/facebook-marketplace/item")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"success": true,
"id": "1278061654412635",
"url": "https://www.facebook.com/marketplace/item/1278061654412635/",
"title": "Formal shoes",
"description": "Formal shoes used only once... size UK12.",
"creation_time": "2026-05-15T12:03:51.000Z",
"location_text": "London, United Kingdom",
"location": {
"latitude": 51.512145996094,
"longitude": -0.1043701171875
},
"price": {
"formatted_amount_zeros_stripped": "£5",
"amount_with_offset_in_currency": 664,
"amount": 5,
"currency": "GBP"
},
"strikethrough_price": null,
"category_id": "931157863635831",
"attributes": {
"0": {
"attribute_name": "Condition",
"value": "used_good",
"label": "Used - Good"
}
},
"photos": {
"0": {
"id": "1889521335087397",
"url": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.84726-6/699132406_1889521345087396_1900687902739816956_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=100&ccb=1-7&_nc_sid=92e707&_nc_ohc=NWY0ouwhkyQQ7kNvwGUburJ&_nc_oc=AdpP5K8nFbn_rxoPMSXKdTEVvU1yrohGJKsqNDAottRhGa-cPQ6wfuJe1lCckE0lr-U&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=FYxxqOqNnr7L-aCsjjIJSA&_nc_ss=7e289&oh=00_Af6NoRpfi6Xah2sym375Rc5xGJN_rizevUTsMxgfhuI2Tg&oe=6A0E0F17",
"width": 443,
"height": 960,
"accessibility_caption": "No photo description available."
},
"1": {
"id": "1741302177009337",
"url": "https://scontent-bos5-1.xx.fbcdn.net/v/t45.5328-4/696698524_1741302180342670_8753490698983285357_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=102&ccb=1-7&_nc_sid=247b10&_nc_ohc=jxxu6gpPe48Q7kNvwEl_RH6&_nc_oc=AdrbNL5_6KB9YhiGwae5FkjfSSXGSSo6ixBpvsdyCau6CsbdeeuOPMXkpAFBCbrLPho&_nc_zt=23&_nc_ht=scontent-bos5-1.xx&_nc_gid=FYxxqOqNnr7L-aCsjjIJSA&_nc_ss=7e289&oh=00_Af7MenQudv2cM5fkdLAcMNOEinrZudbev0-BhBQH0NVemA&oe=6A0E005B",
"width": 443,
"height": 960,
"accessibility_caption": "No photo description available."
},
"2": {
"id": "957534360394038",
"url": "https://scontent-bos5-1.xx.fbcdn.net/v/t45.5328-4/697158330_957534363727371_710797950200649114_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=106&ccb=1-7&_nc_sid=247b10&_nc_ohc=so2agAzsOFAQ7kNvwFeon1g&_nc_oc=AdrE4yXI0FK8NmWDN1Vuyb83xiejDRVe7saS2GOy8mamOxS3h4-Y-GntfunxB16ERjk&_nc_zt=23&_nc_ht=scontent-bos5-1.xx&_nc_gid=FYxxqOqNnr7L-aCsjjIJSA&_nc_ss=7e289&oh=00_Af7gJvnYvAF6a6IivkKXfZpqNE4jgLZys2N3Sw7xh0ThQQ&oe=6A0E12FC",
"width": 443,
"height": 960,
"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": {
"0": "IN_PERSON"
},
"share_uri": "https://www.facebook.com/marketplace/item/1278061654412635/",
"seller": null
},
"credits_used": 1
}{
"error": "Either Marketplace item id or url parameter is required",
"endpoint": "<string>",
"credits_required": 123
}{
"error": "Invalid API key",
"docs": "https://docs.sociavault.com/authentication"
}{
"error": "Insufficient credits",
"required": 1,
"available": 0
}{
"error": "Service configuration error"
}💳 1 credit per request
Pass either the listing
id or its full Marketplace url — you only need
one.Authorizations
Query Parameters
Facebook Marketplace item id (use id or url)
Example:
"1656586118821988"
Facebook Marketplace item URL (use id or url)
Example:
"https://www.facebook.com/marketplace/item/1656586118821988/"
Response
Successful response
Key Response Fields:
data.id: Marketplace listing identifierdata.url/share_uri: Direct link to the listing on Facebookdata.title: Listing titledata.description: Full listing description textdata.creation_time: ISO 8601 timestamp of when the listing was posteddata.location_text: Human-readable location (e.g."London, United Kingdom")data.location.latitude/longitude: Precise coordinates of the listingdata.price.amount: Numeric price valuedata.price.formatted_amount_zeros_stripped: Display price string (e.g."£5")data.price.currency: ISO currency code (e.g."GBP")data.strikethrough_price: Original price before discount, ornulldata.attributes[0].attribute_name/value/label: Item attributes such as conditiondata.photos[0].url/width/height: Listing photos arraydata.is_sold/is_live/is_pending: Listing status flagsdata.delivery_types: Available delivery methods (e.g.IN_PERSON)data.seller: Seller profile info, ornullif not available
⌘I