# Get Results

Retrieve scraped listings from Facebook Marketplace Scraper

Retrieve scraped listings from your **Facebook Marketplace Scraper** runs.

## Headers
<ParamField header="Authorization" type="string" required>
  Your API authentication token. Value: `Token YOUR_API_KEY`
</ParamField>

## Query Parameters
<ParamField query="squid" type="string" required>
  Hash of the squid to get results from
</ParamField>

<ParamField query="run" type="string">
  Hash of a specific run (optional)
</ParamField>

<ParamField query="page" type="integer">
  Page number (default: 1). Example: `1`
</ParamField>

## Result Fields

Each result object contains the following fields:

<ResponseField name="url" type="string">
  Direct URL to the Marketplace listing. Example: `https://www.facebook.com/marketplace/item/123456789/`
</ResponseField>

<ResponseField name="internal_id" type="string">
  Facebook's internal listing ID. Example: `123456789`
</ResponseField>

<ResponseField name="title" type="string">
  Listing title as shown on Marketplace. Example: `Yamaha upright piano — excellent condition`
</ResponseField>

<ResponseField name="price" type="string">
  Price amount as a string (no currency symbol). Example: `450`
</ResponseField>

<ResponseField name="currency" type="string">
  ISO currency code. Example: `EUR`
</ResponseField>

<ResponseField name="formatted_price" type="string">
  Price with currency symbol as displayed on Marketplace. Example: `€450`
</ResponseField>

<ResponseField name="city" type="string">
  City where the item is located. Example: `Paris`
</ResponseField>

<ResponseField name="image_urls" type="array">
  Array of listing image URLs.
</ResponseField>

<ResponseField name="creation_time" type="datetime">
  Listing creation date and time (UTC). Example: `2026-07-10T14:23:00`
</ResponseField>

<ResponseField name="is_sold" type="boolean">
  Whether the item has been marked as sold.
</ResponseField>

<ResponseField name="is_live" type="boolean">
  Whether the listing is currently active.
</ResponseField>

<ResponseField name="delivery_types" type="string">
  Available delivery methods, comma-separated. Example: `LOCAL_PICKUP, SHIPPING`
</ResponseField>

<ResponseField name="category" type="string">
  Marketplace category the listing belongs to. Example: `Musical Instruments`
</ResponseField>

<ResponseField name="is_outside_search" type="boolean">
  `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.
</ResponseField>

## Detail Fields

The following fields are only populated when `listing_details` is set to `true` in your squid settings.

<ResponseField name="description" type="string">
  Full listing description text from the detail page.
</ResponseField>

<ResponseField name="condition" type="string">
  Item condition as listed by the seller. Example: `Used - Good`
</ResponseField>

<ResponseField name="location_text" type="string">
  Precise location text from the listing detail page. Example: `11th arrondissement, Paris`
</ResponseField>

<ResponseField name="latitude" type="float">
  Latitude coordinate of the listing location. Example: `48.8534`
</ResponseField>

<ResponseField name="longitude" type="float">
  Longitude coordinate of the listing location. Example: `2.3488`
</ResponseField>

<ResponseField name="seller_name" type="string">
  Display name of the seller. Example: `Marie L.`
</ResponseField>

<ResponseField name="seller_id" type="string">
  Facebook ID of the seller.
</ResponseField>

<ResponseField name="is_pending" type="boolean">
  Whether the listing is marked as pending (sale in progress).
</ResponseField>

<ResponseField name="is_hidden" type="boolean">
  Whether the listing is hidden from public search.
</ResponseField>

<ResponseField name="is_viewer_seller" type="boolean">
  Whether the authenticated scraping account is the seller of this listing.
</ResponseField>

<ResponseField name="strikethrough_price" type="string">
  Original price before discount, as a numeric string. Example: `600`
</ResponseField>

<ResponseField name="strikethrough_price_formatted" type="string">
  Original price before discount, formatted with currency symbol. Example: `€600`
</ResponseField>

<ResponseField name="listing_attributes" type="array">
  Structured listing attributes provided by the seller (condition, brand, size, etc.).
</ResponseField>

## Response

```json 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
}
```
