Social Fetch
Get API key
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 per successful request.

Try in playgroundFull API docs

About this endpoint

Reseller alerts, deal trackers, and enrichment pipelines often already have a Marketplace link: a saved listing, a webhook payload, a row from an earlier search. You need the full card for that one item — title, description, price, photos, seller, location, sold or shipping flags — not another keyword sweep of the map.

`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. Full parameters and examples are in the API docs.

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