Get Results
Retrieve scraped listings from Facebook Marketplace Scraper
https://api.lobstr.io/v1/resultsRetrieve scraped listings from your Facebook Marketplace Scraper runs.
Headers
AuthorizationstringheaderrequiredYour API authentication token. Value: Token YOUR_API_KEY
Query Parameters
squidstringqueryrequiredHash of the squid to get results from
runstringqueryHash of a specific run (optional)
pageintegerqueryPage number (default: 1). Example: 1
Result Fields
Each result object contains the following fields:
urlstringDirect URL to the Marketplace listing. Example: https://www.facebook.com/marketplace/item/123456789/
internal_idstringFacebook's internal listing ID. Example: 123456789
titlestringListing title as shown on Marketplace. Example: Yamaha upright piano — excellent condition
pricestringPrice amount as a string (no currency symbol). Example: 450
currencystringISO currency code. Example: EUR
formatted_pricestringPrice with currency symbol as displayed on Marketplace. Example: €450
citystringCity where the item is located. Example: Paris
image_urlsarrayArray of listing image URLs.
creation_timedatetimeListing creation date and time (UTC). Example: 2026-07-10T14:23:00
is_soldbooleanWhether the item has been marked as sold.
is_livebooleanWhether the listing is currently active.
delivery_typesstringAvailable delivery methods, comma-separated. Example: LOCAL_PICKUP, SHIPPING
categorystringMarketplace category the listing belongs to. Example: Musical Instruments
is_outside_searchbooleantrue when Facebook lists the listing under "Results from outside your search" (outside your search area, or only loosely related to your query), false before that section. Empty on browse and category URLs. To skip these listings, set exclude_outside_search in your squid settings.
Detail Fields
The following fields are only populated when listing_details is set to true in your squid settings.
descriptionstringFull listing description text from the detail page.
conditionstringItem condition as listed by the seller. Example: Used - Good
location_textstringPrecise location text from the listing detail page. Example: 11th arrondissement, Paris
latitudefloatLatitude coordinate of the listing location. Example: 48.8534
longitudefloatLongitude coordinate of the listing location. Example: 2.3488
seller_namestringDisplay name of the seller. Example: Marie L.
seller_idstringFacebook ID of the seller.
is_pendingbooleanWhether the listing is marked as pending (sale in progress).
is_hiddenbooleanWhether the listing is hidden from public search.
is_viewer_sellerbooleanWhether the authenticated scraping account is the seller of this listing.
strikethrough_pricestringOriginal price before discount, as a numeric string. Example: 600
strikethrough_price_formattedstringOriginal price before discount, formatted with currency symbol. Example: €600
listing_attributesarrayStructured listing attributes provided by the seller (condition, brand, size, etc.).
Response
{ "total_results": 1, "limit": 50, "page": 1, "total_pages": 1, "result_from": 1, "result_to": 1, "data": [ { "id": 89438, "object": "result", "squid": "9f9d8c985d467622ba04fd2a54932402", "run": "0efdbe4671e8df2cc1265ddb7324bf8f", "url": "https://www.facebook.com/marketplace/item/1323925843091629/", "internal_id": "1323925843091629", "title": "Télévision très bon état", "price": "55.00", "currency": "EUR", "formatted_price": "€55", "city": "Lyon", "image_urls": [ "https://scontent.fbcdn.net/img1.jpg", "https://scontent.fbcdn.net/img2.jpg" ], "creation_time": "2025-01-15 14:30:00+00:00", "is_sold": false, "is_live": true, "delivery_types": "IN_PERSON", "category": "TVs", "is_outside_search": false, "description": "Piano rock jam rj661.\nPour les enfants, en bon état.", "condition": "Usado — em boas condições", "location_text": "Lapeyrouse-Mornay, ARA", "latitude": 45.326843, "longitude": 4.993286, "seller_name": "Angelique Przybylski", "seller_id": "1057237320", "is_pending": false, "is_hidden": false, "is_viewer_seller": false, "strikethrough_price": "300", "strikethrough_price_formatted": "£300", "listing_attributes": [ { "attribute_name": "item_condition", "value": "USED_GOOD", "label": "Used - Good" } ], "functions": null, "native_id": 89438 } ], "next": null, "previous": null }