facebook-marketplace-item
One Facebook Marketplace listing as one row: title, price and the price before a reduction, currency, condition, category, description, location, the seller's id, when it was listed, whether it has sold, and photos. item is the listing's URL or its id (the number after /marketplace/item/). About 5 s from the public page (no seller id there); about 20 s from the second source when Facebook refuses the page.
Recipes are not open yet.
What this recipe returned on its last run. No key needed to look.
Fields
14 columns on every row. null means the site does not state it.| field | type | meaning |
|---|---|---|
| item_id | string | Facebook's id of the listing (digits, as a string). |
| url | string | The listing's page, https://www.facebook.com/marketplace/item/<id>/. |
| title | string | The listing's title. |
| price | number | The price now, a number in currency. |
| price_before | The price before the seller lowered it; null when it was not lowered. | |
| currency | string | Three-letter currency code (ZAR, USD). |
| condition | string | The condition the seller states ("New", "Used - Good"); null when not stated. |
| categories | string[] | The category path from the top, a list of names. |
| description | string | The seller's description. |
| location | string | Where the item is, as Facebook writes it ("Cape Town, South Africa"). |
| seller_id | string | The seller's Facebook profile id. |
| listed_at | string | When it was listed, ISO 8601 UTC. |
| is_sold | boolean | true when the listing is marked sold. |
| photos | string[] | Every photo URL; signed by Facebook, they stop working after some days. |
null means the site does not state it.
currency.How it behaves
Cost. 1 page; 1 record if refused. A failed run costs 0.
Freshness 30 min. The same input within 30 min is served from cache at 0 units.
How it answers. Answers at once for one input; a large run goes as a job you poll.
Questions about this recipeQuestions
Short answers. The API reference has the long ones.
Call POST /recipes/facebook-marketplace-item with your key and item. You get rows with the 14 fields above. The recipe is tested against the live site every 6 hours.
1 page; 1 record if refused. A failed run costs 0. The same input within 30 min costs 0.
Yes. Sign up with Google, GitHub or email for a free key with 1,000 credits every month. No credit card.
The health check runs every 6 hours against the live site. A failing recipe shows as failing on this page until we fix it.
Extra fields, higher volume, or a private copy with a freshness SLA. We build it on Enterprise.
Request a changeMore for e-commerce and catalogs
All 12 recipes →One Amazon product page: ASIN, title, price, star rating, review count, brand, availability, the feature bullets, the main image and the…
The products on an Amazon search results page: ASIN, title, price, star rating, review count, the product's link, image, and whether the…
One game on Steam: name, price and discount in the chosen store region, developers, publishers, release date, genres, feature tags…
For developers
Get a free API key and run your first crawl.
1,000 credits every month. No credit card. Your self-hosted setup keeps working.
For teams
Talk to us about volume, regions and an SLA.
A 30-minute call with the team that writes the crawler. DPA on request, invoice billing, your choice of US, EU or Singapore.