Social Fetch
Facebook

Get Facebook Marketplace item

Get details for a Facebook Marketplace listing.

Operation

GET/v1/facebook/marketplace/items
Cost: 1 credit

Headers

x-api-keystringrequired(header)

API key (`sfk_...`)

Parameters

itemIdstring(query)

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

min 1 chars · max 256 chars

urlstring(query)

Public Facebook Marketplace item URL.

min 1 chars · max 4096 chars

Response fields

data
objectrequired

Endpoint-specific response payload.

datalookupStatus
stringrequired

Whether the listing could be resolved for this request.

one of: found, not_found

dataitem
objectrequirednullable

Listing details when found.

dataitemplatform
stringrequired

Social platform for this listing.

one of: facebook

dataitemitemId
stringrequired

Marketplace item identifier.

min 1 chars

dataitemurl
stringrequired

Canonical public URL for this Marketplace listing.

min 1 chars

dataitemtitle
stringrequired

Listing title.

min 1 chars

dataitemdescription
stringrequirednullable

Listing description when available.

dataitemcreatedAt
stringrequirednullable

Creation timestamp in ISO 8601 when available.

dataitemcategoryId
stringrequirednullable

Marketplace category identifier when available.

dataitemshareUrl
stringrequirednullable

Shareable listing URL when available.

dataprice
objectrequirednullable

Price details when found.

datapriceformatted
stringrequirednullable

Formatted price string when available.

datapriceamount
numberrequirednullable

Numeric price amount when available.

≥ 0

datapriceamountMinor
integerrequirednullable

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

≥ 0

datapricecurrency
stringrequirednullable

ISO currency code when available.

min 1 chars

datapricestrikethroughFormatted
stringrequirednullable

Formatted strikethrough price when available.

datapricestrikethroughAmount
numberrequirednullable

Strikethrough numeric amount when available.

≥ 0

datapricestrikethroughAmountMinor
integerrequirednullable

Strikethrough amount in minor currency units when available.

≥ 0

datapricestrikethroughCurrency
stringrequirednullable

Strikethrough currency code when available.

min 1 chars

datalocation
objectrequirednullable

Location details when found.

datalocationtext
stringrequirednullable

Human-readable location label when available.

datalocationlatitude
numberrequirednullable

Latitude when available.

datalocationlongitude
numberrequirednullable

Longitude when available.

dataattributes
arrayrequired

Listing attributes when found.

dataattributes[]name
stringrequired

Attribute name.

min 1 chars

dataattributes[]value
stringrequirednullable

Attribute value when available.

dataattributes[]label
stringrequirednullable

Display label when available.

dataphotos
arrayrequired

Listing photos when found.

dataphotos[]photoId
stringrequired

Photo identifier when available.

min 1 chars

dataphotos[]url
stringrequired

Photo image URL.

min 1 chars

dataphotos[]width
integerrequirednullable

Image width in pixels when available.

≥ 0

dataphotos[]height
integerrequirednullable

Image height in pixels when available.

≥ 0

dataphotos[]accessibilityCaption
stringrequirednullable

Accessibility caption when available.

dataseller
objectrequirednullable

Seller details when available.

datasellersellerId
string

Seller identifier when available.

datasellername
stringrequirednullable

Seller display name when available.

datasellerprofileUrl
stringrequirednullable

Seller profile URL when available.

dataselleravatarUrl
stringrequirednullable

Seller avatar image URL when available.

datasellerrating
numberrequirednullable

Seller rating when available.

≥ 0

dataavailability
objectrequirednullable

Availability flags when found.

dataavailabilityhidden
booleanrequired

Whether the listing is hidden.

dataavailabilitylive
booleanrequired

Whether the listing is live.

dataavailabilitypending
booleanrequired

Whether the listing is pending.

dataavailabilitysold
booleanrequired

Whether the listing is marked sold.

dataavailabilityviewerSeller
booleanrequired

Whether the authenticated viewer is the seller.

dataavailabilityshippingOffered
booleanrequired

Whether shipping is offered for this listing.

dataavailabilitybuyNowEnabled
booleanrequired

Whether buy-now checkout is enabled.

dataavailabilitymessagingEnabled
booleanrequired

Whether messaging is enabled for this listing.

datadeliveryTypes
arrayrequired

Delivery options such as in-person pickup.

datadeliveryTypes[]
string

min 1 chars

meta
objectrequired

Metadata describing the request and billing outcome.

metarequestId
stringrequired

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integerrequired

Credits charged for this request.

≥ 0

metaversion
stringrequired

Public API version that served the response.

one of: v1

Code example

Responses

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

Error codes

bad_requestinsufficient_creditsinternal_errorlookup_failedtemporarily_unavailableunauthorized

On this page