Social Fetch
Start for freeStart free
Facebook hub

Facebook Marketplace Item API

Resolve a known Marketplace listing URL or item id to structured JSON — title, price, photos, seller, and availability — in the same envelope as the rest of the Facebook tag.

GET /v1/facebook/marketplace/items

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/facebook/marketplace/items takes itemId, url, or both. At least one is required. Branch on data.lookupStatus before you write a row — found or not_found. On found, read data.item (itemId, url, title, description, createdAt, categoryId, shareUrl), plus price, location, attributes, photos, seller, availability, and deliveryTypes when Facebook exposes them. Bill from meta.creditsCharged; the flat amount for this operation is on this page and in the OpenAPI note.

This is a single-listing get. To discover listings by keyword near lat/lng, use GET /v1/facebook/marketplace/search. To turn a city name into coordinates first, use GET /v1/facebook/marketplace/locations/search. All three share one Social Fetch API key.

Facebook Marketplace Item API FAQ

What does the Facebook Marketplace Item API return?

A typed lookupStatus (found or not_found). When found, the payload can include item identity (itemId, url, title, description, createdAt, categoryId, shareUrl), price (formatted and numeric amounts, currency, strikethrough when present), location (text, latitude, longitude), attributes, photos, seller (name, profileUrl, avatarUrl, rating), availability flags (live, sold, pending, shippingOffered, and related), and deliveryTypes. Responses use the shared Social Fetch envelope with meta.requestId and meta.creditsCharged.

How do I fetch one Facebook Marketplace listing via API?

Send GET /v1/facebook/marketplace/items with x-api-key and either itemId, url, or both. Prefer the public Marketplace item URL when that is what you have; use itemId when the id is already known. See the API docs for parameters and examples.

How much does a Facebook Marketplace item lookup cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth.

Is Marketplace item lookup the same as Marketplace search?

No. GET /v1/facebook/marketplace/items returns one listing when you already have an item URL or id. GET /v1/facebook/marketplace/search finds listings by keyword near a latitude and longitude. Use search to discover candidates, then items to enrich a specific row.

What happens for removed or unknown Marketplace listings?

The call still returns a typed lookupStatus. Unknown, expired, or unavailable listings resolve as not_found with null item fields. Do not invent titles, prices, or seller data. Keep meta.requestId if you need support on a failed enrichment row.

Do I need a Facebook account or Graph API token for Marketplace items?

No. You authenticate to Social Fetch with an API key. The route reads publicly visible Marketplace listing details; it does not act on behalf of a Facebook account you manage.

Other Facebook endpoints