Skip to main content
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>'
{
  "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
  },
  "creditsUsed": 1
}
💳 1 credit per request
Pass either the listing id or its full Marketplace url — you only need one.

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

​
id
string

Facebook Marketplace item id (use id or url)

Example:

"1656586118821988"

​
url
string

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 identifier
  • data.url / share_uri: Direct link to the listing on Facebook
  • data.title: Listing title
  • data.description: Full listing description text
  • data.creation_time: ISO 8601 timestamp of when the listing was posted
  • data.location_text: Human-readable location (e.g. "London, United Kingdom")
  • data.location.latitude / longitude: Precise coordinates of the listing
  • data.price.amount: Numeric price value
  • data.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, or null
  • data.attributes[0].attribute_name / value / label: Item attributes such as condition
  • data.photos[0].url / width / height: Listing photos array
  • data.is_sold / is_live / is_pending: Listing status flags
  • data.delivery_types: Available delivery methods (e.g. IN_PERSON)
  • data.seller: Seller profile info, or null if not available