> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ScrapeCreators: Facebook Marketplace Search

> Search Facebook Marketplace by keyword or browse a supported category without query. Includes inputs, outputs, SDK V2 examples, and Deepline cost.

Search Facebook Marketplace by keyword or browse a supported category without query.

> [!NOTE]
>
> Tool ID: `scrapecreators_facebook_marketplace_search`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'scrapecreators_facebook_marketplace_search',
  {
    "lat": 123,
    "lng": 123
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute scrapecreators_facebook_marketplace_search --input '{
  "lat": 123,
  "lng": 123
}' --json
```

## Example response

The static output schema lacks the details for a reliable example. Use `deepline describe scrapecreators_facebook_marketplace_search --json` for the complete live contract.

## Input reference

Search Facebook Marketplace by keyword or browse a supported category without query. lat and lng are required. See category\_id for allowed IDs. Follow cursor as-is while has\_next\_page is true, keep inputs unchanged, and dedupe by listing id. keyword and category-only cursors cannot be mixed. Category-only date\_listed, availability, and delivery\_method filters apply to listing cards. condition requires a keyword. creation\_time\_descend is not strictly newest-first, and last\_24\_hours uses calendar days, not a rolling cutoff. creation\_time (ISO 8601 UTC) and listing\_date\_text can be null.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.query` | `string` | No | — | Search keyword. Required unless category\_id is provided. |
| `payload.lat` | `number` | Yes | — | Latitude for the search location |
| `payload.lng` | `number` | Yes | — | Longitude for the search location |
| `payload.category_id` | `string` | No | — | Category ID from listing results. Omit query to browse a category below. Allowed IDs for keyword-free browsing: - Antiques: 393860164117441 - Appliances: 678754142233400 - Bicycles: 1658310421102081 - Boats: 712638205822882 - Electronics: 1792291877663080 - Furniture: 1583634935226685 - Garden: 800089866739547 - Household: 1569171756675761 - Tools: 1670493229902393 - Trailers: 655837954899686 - Vehicles: 807311116002614 - Vehicles (alternate ID): 546583916084032 Other category IDs, including See the live schema for the complete constraint. |
| `payload.radius_km` | `number` | No | — | Search radius in kilometers |
| `payload.min_price` | `number` | No | — | Minimum listing price |
| `payload.max_price` | `number` | No | — | Maximum listing price |
| `payload.sort_by` | `"suggested" \| "distance_ascend" \| "creation_time_descend" \| "price_ascend" \| "price_descend"` | No | — | Facebook Marketplace sort option. creation\_time\_descend usually orders the first pages newest first, but Facebook can insert newer listings on later cursor pages. Allowed: `suggested`, `distance_ascend`, `creation_time_descend`, `price_ascend`, `price_descend`. |
| `payload.delivery_method` | `"all" \| "local_pickup" \| "shipping"` | No | — | Delivery filter Allowed: `all`, `local_pickup`, `shipping`. |
| `payload.condition` | `"new" \| "used_like_new" \| "used_good" \| "used_fair"` | No | — | Condition filter Allowed: `new`, `used_like_new`, `used_good`, `used_fair`. |
| `payload.date_listed` | `"all" \| "1" \| "7" \| "30" \| "last_24_hours" \| "last_7_days" \| "last_30_days"` | No | — | Facebook Marketplace date filter. Uses the same calendar-day buckets as the UI, so last\_24\_hours can include listings from the prior calendar day. Allowed: `all`, `1`, `7`, `30`, `last_24_hours`, `last_7_days`, `last_30_days`. |
| `payload.availability` | `"available" \| "sold" \| "all"` | No | — | Availability filter Allowed: `available`, `sold`, `all`. |
| `payload.cursor` | `string` | No | — | Opaque pagination cursor returned from the previous response. Pass it back as-is. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Search Facebook Marketplace by keyword or browse a supported category without query. lat and lng are required. See category_id for allowed IDs. Follow cursor as-is while has_next_page is true, keep inputs unchanged, and dedupe by listing id; keyword and category-only cursors cannot be mixed. Category-only date_listed, availability, and delivery_method filters apply to listing cards; condition requires a keyword. creation_time_descend is not strictly newest-first, and last_24_hours uses calendar days, not a rolling cutoff. creation_time (ISO 8601 UTC) and listing_date_text can be null.",
    "properties": {
      "query": {
        "type": "string",
        "description": "Search keyword. Required unless category_id is provided."
      },
      "lat": {
        "type": "number",
        "description": "Latitude for the search location"
      },
      "lng": {
        "type": "number",
        "description": "Longitude for the search location"
      },
      "category_id": {
        "type": "string",
        "description": "Category ID from listing results. Omit query to browse a category below. Allowed IDs for keyword-free browsing: - Antiques: 393860164117441 - Appliances: 678754142233400 - Bicycles: 1658310421102081 - Boats: 712638205822882 - Electronics: 1792291877663080 - Furniture: 1583634935226685 - Garden: 800089866739547 - Household: 1569171756675761 - Tools: 1670493229902393 - Trailers: 655837954899686 - Vehicles: 807311116002614 - Vehicles (alternate ID): 546583916084032 Other category IDs, including Housing, Food, and Services, require a keyword."
      },
      "radius_km": {
        "type": "number",
        "description": "Search radius in kilometers"
      },
      "min_price": {
        "type": "number",
        "description": "Minimum listing price"
      },
      "max_price": {
        "type": "number",
        "description": "Maximum listing price"
      },
      "sort_by": {
        "type": "string",
        "description": "Facebook Marketplace sort option. creation_time_descend usually orders the first pages newest first, but Facebook can insert newer listings on later cursor pages.",
        "enum": [
          "suggested",
          "distance_ascend",
          "creation_time_descend",
          "price_ascend",
          "price_descend"
        ]
      },
      "delivery_method": {
        "type": "string",
        "description": "Delivery filter",
        "enum": [
          "all",
          "local_pickup",
          "shipping"
        ]
      },
      "condition": {
        "type": "string",
        "description": "Condition filter",
        "enum": [
          "new",
          "used_like_new",
          "used_good",
          "used_fair"
        ]
      },
      "date_listed": {
        "type": "string",
        "description": "Facebook Marketplace date filter. Uses the same calendar-day buckets as the UI, so last_24_hours can include listings from the prior calendar day.",
        "enum": [
          "all",
          "1",
          "7",
          "30",
          "last_24_hours",
          "last_7_days",
          "last_30_days"
        ]
      },
      "availability": {
        "type": "string",
        "description": "Availability filter",
        "enum": [
          "available",
          "sold",
          "all"
        ]
      },
      "cursor": {
        "type": "string",
        "description": "Opaque pagination cursor returned from the previous response. Pass it back as-is."
      }
    },
    "required": [
      "lat",
      "lng"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `unknown` | Yes | — | Provider response payload. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "description": "Provider response payload."
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0.02` per pricing unit.

## Related documentation

* [ScrapeCreators provider guide](https://deepline.com/docs/providers/scrapecreators/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.