search_listings
Search for items on Facebook Marketplace using keywords, location, and filters like price, condition, and category.
Instructions
Search Facebook Marketplace listings by query, location, and filters
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max number of results (default: 20) | |
| query | Yes | Search query (e.g. 'bmw e30', 'macbook pro') | |
| cursor | No | Pagination cursor from a previous search's 'next cursor' to fetch the following page | |
| sort_by | No | Order the returned results: best_match (default), price_asc, price_desc, date_desc (newest first) | |
| category | No | Category ID to filter by | |
| latitude | Yes | Latitude of search center | |
| condition | No | Filter by item condition (server-side) | |
| longitude | Yes | Longitude of search center | |
| max_price | No | Maximum price filter, in the listing's currency units (e.g. CLP pesos, USD dollars) | |
| min_price | No | Minimum price filter, in the listing's currency units (e.g. CLP pesos, USD dollars) | |
| radius_km | No | Search radius in kilometers (default: 50) | |
| price_scale | No | Advanced: multiplier applied to min_price/max_price before sending to Facebook. Facebook uses a 2-decimal minor unit for ALL currencies (including CLP/JPY), so the default 100 is almost always correct. Only override if price filtering behaves oddly in a specific market. Default: 100 | |
| days_since_listed | No | Only show items listed within the last N days |