Skip to main content
GET
Get Results
Retrieve scraped listings from your Facebook Marketplace Scraper runs.

Headers

string
required
Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

string
required
Hash of the squid to get results from
string
Hash of a specific run (optional)
integer
Page number (default: 1). Example: 1

Result Fields

Each result object contains the following fields:
string
Direct URL to the Marketplace listing. Example: https://www.facebook.com/marketplace/item/123456789/
string
Facebook’s internal listing ID. Example: 123456789
string
Listing title as shown on Marketplace. Example: Yamaha upright piano — excellent condition
string
Price amount as a string (no currency symbol). Example: 450
string
ISO currency code. Example: EUR
string
Price with currency symbol as displayed on Marketplace. Example: €450
string
City where the item is located. Example: Paris
array
Array of listing image URLs.
datetime
Listing creation date and time (UTC). Example: 2026-07-10T14:23:00
boolean
Whether the item has been marked as sold.
boolean
Whether the listing is currently active.
string
Available delivery methods, comma-separated. Example: LOCAL_PICKUP, SHIPPING
string
Marketplace category the listing belongs to. Example: Musical Instruments

Detail Fields

The following fields are only populated when listing_details is set to true in your squid settings.
string
Full listing description text from the detail page.
string
Item condition as listed by the seller. Example: Used - Good
string
Precise location text from the listing detail page. Example: 11th arrondissement, Paris
float
Latitude coordinate of the listing location. Example: 48.8534
float
Longitude coordinate of the listing location. Example: 2.3488
string
Display name of the seller. Example: Marie L.
string
Facebook ID of the seller.
boolean
Whether the listing is marked as pending (sale in progress).
boolean
Whether the listing is hidden from public search.
boolean
Whether the authenticated scraping account is the seller of this listing.
string
Original price before discount, as a numeric string. Example: 600
string
Original price before discount, formatted with currency symbol. Example: €600
array
Structured listing attributes provided by the seller (condition, brand, size, etc.).