Skip to content
Examples

Get Results

Retrieve scraped listings from Facebook Marketplace Scraper

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
GEThttps://api.lobstr.io/v1/results

Retrieve scraped listings from your Facebook Marketplace Scraper runs.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from

runstringquery

Hash of a specific run (optional)

pageintegerquery

Page number (default: 1). Example: 1

Result Fields

Each result object contains the following fields:

urlstring

Direct URL to the Marketplace listing. Example: https://www.facebook.com/marketplace/item/123456789/

internal_idstring

Facebook's internal listing ID. Example: 123456789

titlestring

Listing title as shown on Marketplace. Example: Yamaha upright piano — excellent condition

pricestring

Price amount as a string (no currency symbol). Example: 450

currencystring

ISO currency code. Example: EUR

formatted_pricestring

Price with currency symbol as displayed on Marketplace. Example: €450

citystring

City where the item is located. Example: Paris

image_urlsarray

Array of listing image URLs.

creation_timedatetime

Listing creation date and time (UTC). Example: 2026-07-10T14:23:00

is_soldboolean

Whether the item has been marked as sold.

is_liveboolean

Whether the listing is currently active.

delivery_typesstring

Available delivery methods, comma-separated. Example: LOCAL_PICKUP, SHIPPING

categorystring

Marketplace category the listing belongs to. Example: Musical Instruments

is_outside_searchboolean

true 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.

descriptionstring

Full listing description text from the detail page.

conditionstring

Item condition as listed by the seller. Example: Used - Good

location_textstring

Precise location text from the listing detail page. Example: 11th arrondissement, Paris

latitudefloat

Latitude coordinate of the listing location. Example: 48.8534

longitudefloat

Longitude coordinate of the listing location. Example: 2.3488

seller_namestring

Display name of the seller. Example: Marie L.

seller_idstring

Facebook ID of the seller.

is_pendingboolean

Whether the listing is marked as pending (sale in progress).

is_hiddenboolean

Whether the listing is hidden from public search.

is_viewer_sellerboolean

Whether the authenticated scraping account is the seller of this listing.

strikethrough_pricestring

Original price before discount, as a numeric string. Example: 600

strikethrough_price_formattedstring

Original price before discount, formatted with currency symbol. Example: €600

listing_attributesarray

Structured listing attributes provided by the seller (condition, brand, size, etc.).

Response

200
{
  "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
}