Marketplace Item

GET/v1/facebook/marketplace/item1 credit

Returns a Facebook Marketplace listing: title, description, price, location, attributes, photos, delivery options and seller.

01Query parameters

Name	Type	Description
idoptional	string	The numeric listing id. One of `id` or `url` is required.
urloptional	string	A listing URL, e.g. `https://www.facebook.com/marketplace/item/123456789/`. One of `id` or `url` is required.

02Request

curl "https://api.scrapesocial.ai/v1/facebook/marketplace/item?id=4498962133715634" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/facebook/marketplace/item?id=29417982991140871

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": "29417982991140871",
  "url": "https://www.facebook.com/marketplace/item/29417982991140871/",
  "title": "Meghna 20 Inch Bike Wheelset 5 Spokes Lightweight Aluminium 20 Inch, Black",
  "description": "MEGHNA 20 inch Bike Wheelset, 5 Spokes, Lightweight Aluminium, 20 inch, Black. Suitable for 20 x 1.75-2.125 inch tires. Designed for kids bike, folding bike, BMX, mountain bike, freestyle. Aluminum alloy material reduces weight and improves riding efficiency. Unique five spokes wheel shape with shimmer coating. Integrated wheel design for stability. Multi-speed compatible with 6-bolt disc brake an…",
  "creation_time": null,
  "listing_date_text": null,
  "availability_text": null,
  "location_text": null,
  "location": {},
  "price": {
    "formatted_amount_zeros_stripped": "$106.52",
    "amount_with_offset_in_currency": null,
    "amount": null,
    "currency": null
  },
  "mileage": null,
  "strikethrough_price": null,
  "category_id": "1658310421102081",
  "attributes": [],
  "photos": [
    {
      "id": "1656626408981580",
      "url": "https://scontent.fsaw1-15.fna.fbcdn.net/v/t39.84726-6/846648850_1786199799357573_2377085385450853894_n.jpg?stp=dst-jpg_p960x960_tt6&_nc_cat=100&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=92e707&_nc_ohc=_2WRqk9dLoQQ7kNvwFepwPS&_nc_oc=AdpAjrD-Hiq_KEFc3Nv6JrpI8z8e5RJAdBeIRWp1f97YoAHan_ugkXe8Iq46AG4n_L0&_nc_zt=14&_nc_ht=scontent.fsaw1-15.fna&_nc_gid=oye4uJIRBBc2vxWbH3rMDw&_nc_ss=7b289&oh=00_AQMyaxyT4Ss…",
      "width": 960,
      "height": 960,
      "accessibility_caption": "No photo description available."
    },
    {
      "id": "820675117411937",
      "url": "https://scontent.fsaw1-15.fna.fbcdn.net/v/t45.5328-4/697107537_820675120745270_5798306075228766514_n.jpg?stp=dst-jpg_p960x960_tt6&_nc_cat=109&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=247b10&_nc_ohc=BruBJGkvV1YQ7kNvwF_vrY7&_nc_oc=Adr95ZOv9HlN8GNUadmADvz7_9f3g484FC5FmCsSsuOi14EP4qU9CbXKMJ08P866BPA&_nc_zt=23&_nc_ht=scontent.fsaw1-15.fna&_nc_gid=oye4uJIRBBc2vxWbH3rMDw&_nc_ss=7b289&oh=00_AQOpT_oALhqzd…",
      "width": 960,
      "height": 960,
      "accessibility_caption": "No photo description available."
    }
  ],
  "is_hidden": false,
  "is_live": false,
  "is_pending": false,
  "is_sold": false,
  "is_viewer_seller": false,
  "is_shipping_offered": false,
  "is_buy_now_enabled": false,
  "messaging_enabled": false,
  "delivery_types": [],
  "share_uri": "https://www.facebook.com/marketplace/item/29417982991140871/",
  "seller": {
    "__typename": "Page",
    "id": "323025340883974"
  }
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

An unknown listing returns a free 404. `listing_date_text` and `availability_text` are filled only for rental listings.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.