Social Fetch
Facebook

Get Facebook Marketplace item

Get details for a Facebook Marketplace listing.

GET/v1/facebook/marketplace/items
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
2
itemIdstringquery

Facebook Marketplace item identifier. Provide this instead of url when you already know the item id.

min 1 chars · max 256 chars

urlstringquery

Public Facebook Marketplace item URL.

min 1 chars · max 4096 chars

Response fields
55

Endpoint-specific response payload.

datalookupStatus
string

Whether the listing could be resolved for this request.

one of: found, not_found

Listing details when found.

dataitemplatform
string

Social platform for this listing.

one of: facebook

dataitemitemId
string

Marketplace item identifier.

min 1 chars

dataitemurl
string

Canonical public URL for this Marketplace listing.

min 1 chars

dataitemtitle
string

Listing title.

min 1 chars

dataitemdescription
stringnullable

Listing description when available.

dataitemcreatedAt
stringnullable

Creation timestamp in ISO 8601 when available.

dataitemcategoryId
stringnullable

Marketplace category identifier when available.

dataitemshareUrl
stringnullable

Shareable listing URL when available.

Price details when found.

datapriceformatted
stringnullable

Formatted price string when available.

datapriceamount
numbernullable

Numeric price amount when available.

≥ 0

datapriceamountMinor
integernullable

Price amount in minor currency units (for example cents) when available.

≥ 0

datapricecurrency
stringnullable

ISO currency code when available.

min 1 chars

datapricestrikethroughFormatted
stringnullable

Formatted strikethrough price when available.

datapricestrikethroughAmount
numbernullable

Strikethrough numeric amount when available.

≥ 0

datapricestrikethroughAmountMinor
integernullable

Strikethrough amount in minor currency units when available.

≥ 0

datapricestrikethroughCurrency
stringnullable

Strikethrough currency code when available.

min 1 chars

Location details when found.

datalocationtext
stringnullable

Human-readable location label when available.

datalocationlatitude
numbernullable

Latitude when available.

datalocationlongitude
numbernullable

Longitude when available.

Listing attributes when found.

dataattributes[]name
string

Attribute name.

min 1 chars

dataattributes[]value
stringnullable

Attribute value when available.

dataattributes[]label
stringnullable

Display label when available.

Listing photos when found.

dataphotos[]photoId
string

Photo identifier when available.

min 1 chars

dataphotos[]url
string

Photo image URL.

min 1 chars

dataphotos[]width
integernullable

Image width in pixels when available.

≥ 0

dataphotos[]height
integernullable

Image height in pixels when available.

≥ 0

dataphotos[]accessibilityCaption
stringnullable

Accessibility caption when available.

Seller details when available.

datasellersellerId
stringoptional

Seller identifier when available.

datasellername
stringnullable

Seller display name when available.

datasellerprofileUrl
stringnullable

Seller profile URL when available.

dataselleravatarUrl
stringnullable

Seller avatar image URL when available.

datasellerrating
numbernullable

Seller rating when available.

≥ 0

Availability flags when found.

dataavailabilityhidden
boolean

Whether the listing is hidden.

dataavailabilitylive
boolean

Whether the listing is live.

dataavailabilitypending
boolean

Whether the listing is pending.

dataavailabilitysold
boolean

Whether the listing is marked sold.

dataavailabilityviewerSeller
boolean

Whether the authenticated viewer is the seller.

dataavailabilityshippingOffered
boolean

Whether shipping is offered for this listing.

dataavailabilitybuyNowEnabled
boolean

Whether buy-now checkout is enabled.

dataavailabilitymessagingEnabled
boolean

Whether messaging is enabled for this listing.

Delivery options such as in-person pickup.

datadeliveryTypes[]
stringoptional

min 1 chars

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/facebook/marketplace/items?itemId=abc123" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Marketplace item metadata (found or not found in body).

On this page

No Headings