Facebook Scraper
Get Facebook Marketplace Search
Search Facebook Marketplace listings by keyword and location, filterable by category, date and sort order.
1 creditNo API key neededEndpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| querystring · required | string | required | Search keyword |
| latnumber · required | number | required | Latitude for the search location |
| lngnumber · required | number | required | Longitude for the search location |
| limitnumber · optional | number | optional | Maximum number of results to return from this request. Leave empty for everything this request returns. This trims the response — it does not fetch more; use the returned cursor for the next batch. The price is the same either way. |
| cursorstring · optional | string | optional | Opaque pagination cursor returned from the previous response. Pass it back as-is. |
| sort_bystring · optional | string | optional | Facebook Marketplace sort option. creation_time_descend usually orders the first pages newest first, but Facebook can insert newer listings on later cursor pages. One of: |
| conditionstring · optional | string | optional | Condition filter One of: |
| max_pricenumber · optional | number | optional | max_price |
| min_pricenumber · optional | number | optional | min_price |
| radius_kmnumber · optional | number | optional | Search radius in kilometers |
| category_idstring · optional | string | optional | Numeric Facebook Marketplace category ID. Listing results include this value as category_id. |
| date_listedstring · optional | string | optional | 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. One of: |
| availabilitystring · optional | string | optional | Availability filter One of: |
| delivery_methodstring · optional | string | optional | Delivery filter One of: |
Response schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"cursor": {
"type": "string"
},
"listings": {
"type": "array"
},
"limitApplied": {
"type": "boolean",
"description": "True when a Limit trimmed the results; there were more in this response."
},
"has_next_page": {
"type": "boolean"
}
},
"additionalProperties": true
}
