Facebook Marketplace Item Scraper — Listing Lookup

The Actor looks up individual public Facebook Marketplace listings by ID or URL exactly as a logged-out visitor sees them, and returns each listing's full detail record. No Facebook account, login, or session cookie is used at any point.

Accepted input

itemId is required and accepts a list of Marketplace listing IDs, or full facebook.com/marketplace/item/<id>/ URLs, one per line; a URL is reduced to its numeric ID before the request is made. includeRelated (default false) adds the related listings Facebook shows alongside the requested one, under related.

{
  "itemId": ["1234567890123456"],
  "includeRelated": true
}

Result fields

Each row carries id, title, price, location, url, related, and raw. Unlike a browse result, a lookup row does not carry imageUrl as its own field; a listing's images live inside raw. related is null when includeRelated is off, and otherwise the list of listings Facebook renders alongside the requested one, each carrying id, title, price, location, url and imageUrl.

That list is about twenty entries — whatever Facebook puts in the tray on the item page. Measured at 19 and 20 across four live listings. There is no way to ask for more: the tray has no paginator, and maxItems counts the listings you supply, not the related ones each brings back. They are attached to the requested listing's own row rather than saved as rows of their own, and they add no charge — they arrive in the same single request as the listing itself.

{
  "id": "1234567890123456",
  "title": "iPhone 13 Pro, 256GB, unlocked",
  "price": "$450",
  "location": "Austin, TX",
  "url": "https://www.facebook.com/marketplace/item/1234567890123456/",
  "related": null
}

price is the formatted string Facebook displays, currency symbol included, rather than a parsed number and currency code. maxItems (default 50) trims how many of the supplied listings are saved once resolved; 0 collects every listing supplied.

Behaviour on partial results

A listing ID or URL that does not resolve to a valid numeric ID is logged as a warning and skipped without a request being made for it. A listing that resolves but has been removed, or otherwise returns no data, is logged and skipped the same way. The run continues with the rest of the list in both cases.

Public, logged-out data only

Everything returned here — the listing page and its related listings alike — is visible to a Marketplace visitor who is not signed in. There is no logged-out Marketplace search: this Actor covers direct listing lookups by ID or URL, not a keyword search across listings.

Frequently asked questions

Why is there no imageUrl field here? A lookup already returns the listing's full detail record, and its images live inside raw rather than being lifted into a separate field the way a lighter browse row's imageUrl is. A browse result and a lookup result are not the same shape.

Does this need an add-on to get the full detail record? No. A full detail record is what this Actor returns by default for every listing it resolves; there is nothing extra to turn on. The equivalent add-on on the Facebook Marketplace Scraper exists to bring that same depth to a browse run, not to this one.

Can a listing ID found while browsing be looked up here directly? Yes. The id on a Facebook Marketplace Scraper browse row is exactly what itemId here accepts, so listings worth going deeper on can be fed straight into this Actor without any conversion.

Is a Facebook account or login required? No. Only the Marketplace listing pages that Facebook already shows to a logged-out visitor are read.

What this is useful for

Tracking specific listings — availability, price changes — over the life of a scheduled run; pulling full detail, including related listings, for a known shortlist of listing IDs; and following up on listings surfaced elsewhere with a single, targeted request per listing.

Related Actors

Actor	Purpose
Facebook Marketplace Scraper	Browse listings by category
Facebook Page Scraper	Profile, About and Transparency details for a Page
Facebook Posts Scraper	Timeline posts for a Page