Search APIs
Loading…
← API Store
Social

Facebook

Facebook

Facebook Marketplace listing

GET /facebook/v1/marketplace/item
Test this endpoint

Every response includes credits_used: the credits this call cost.

Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.

Parameters

NameTypeDescription
urlrequiredstring Example: https://www.facebook.com/marketplace/item/919704987847781/

Every endpoint also takes: raw、fields、fresh、output、records

{
  "attributes": [
    {
      "name": "Condition",
      "value": "Used - Good"
    },
    {
      "name": "Bicycle Type",
      "value": "Mountain Bike"
    }
  ],
  "cached": false,
  "can_buy_now": null,
  "category": null,
  "category_id": "1658310421102081",
  "condition": "Used - Good",
  "created_at": "2026-08-15T21:24:40.000Z",
  "credits_used": 1,
  "custom_title": null,
  "delivery": [
    "IN_PERSON"
  ],
  "delivery_types": [
    "IN_PERSON"
  ],
  "description": "Very reliable bike. Had for over 5 years no problem. Brakes work but need to be tuned.",
  "id": "919704987847781",
  "image": null,
  "images": [],
  "is_hidden": false,
  "is_live": true,
  "is_pending": false,
  "is_shipping": false,
  "is_shipping_offered": false,
  "is_sold": false,
  "latitude": 40.652160644531,
  "location": null,
  "location_details": {
    "latitude": 40.652160644531,
    "longitude": -74.349975585938
  },
  "location_text": "Westfield, NJ",
  "longitude": -74.349975585938,
  "origin_group": null,
  "photo_details": [
    {
      "alt": "No photo description available.",
      "height": 960,
      "id": "1593437412450434",
      "url": "https://scontent.forn3-6.fna.fbcdn.net/v/t39.84726-6/773603569_1593437419117100_2175795937918370770_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=1…",
      "width": 720
    },
    {
      "alt": "No photo description available.",
      "height": 960,
      "id": "1066642689200270",
      "url": "https://scontent.forn3-1.fna.fbcdn.net/v/t45.5328-4/775233742_1066642692533603_8039672293105195599_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=10…",
      "width": 720
    },
    "… 1 more"
  ],
  "photos": [
    "https://scontent.forn3-6.fna.fbcdn.net/v/t39.84726-6/773603569_1593437419117100_2175795937918370770_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=1…",
    "https://scontent.forn3-1.fna.fbcdn.net/v/t45.5328-4/775233742_1066642692533603_8039672293105195599_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=10…",
    "… 1 more"
  ],
  "price": {
    "amount": 50,
    "currency": "USD",
    "formatted": "$50"
  },
  "primary_category": null,
  "seller": null,
  "seller_details": null,
  "share_url": "https://www.facebook.com/marketplace/item/919704987847781/",
  "status": "AVAILABLE",
  "story_id": null,
  "strikethrough_price": null,
  "sub_titles": [],
  "title": "Trek Bike",
  "url": "https://www.facebook.com/marketplace/item/919704987847781/",
  "video": null,
  "…": "4 more fields"
}
Response fields (60)

Field paths and types observed in the sample response; the live response is authoritative.

$object
$.attributesarray
$.attributes[]object
$.attributes[].namestring
$.attributes[].valuestring
$.cachedboolean
$.can_buy_nownull
$.categorynull
$.category_idstring
$.conditionstring
$.created_atstring
$.credits_usedinteger
$.custom_titlenull
$.deliveryarray
$.delivery[]string
$.delivery_typesarray
$.delivery_types[]string
$.descriptionstring
$.idstring
$.imagenull
$.imagesarray
$.is_hiddenboolean
$.is_liveboolean
$.is_pendingboolean
$.is_shippingboolean
$.is_shipping_offeredboolean
$.is_soldboolean
$.latitudenumber
$.locationnull
$.location_detailsobject
$.location_details.latitudenumber
$.location_details.longitudenumber
$.location_textstring
$.longitudenumber
$.origin_groupnull
$.photo_detailsarray
$.photo_details[]object | string
$.photo_details[].altstring
$.photo_details[].heightinteger
$.photo_details[].idstring
$.photo_details[].urlstring
$.photo_details[].widthinteger
$.photosarray
$.photos[]string
$.priceobject
$.price.amountinteger
$.price.currencystring
$.price.formattedstring
$.primary_categorynull
$.sellernull
$.seller_detailsnull
$.share_urlstring
$.statusstring
$.story_idnull
$.strikethrough_pricenull
$.sub_titlesarray
$.titlestring
$.urlstring
$.videonull
$.…string