Facebook Scraper
Get Facebook Marketplace Marketplace Search
Searches Facebook Marketplace listings by keyword and lat/lng. Each page contains up to 24 listings. Each listing includes creation_time as an ISO 8601 UTC timestamp when Facebook exposes an exact listing timestamp, plus listing_date_text when available; either field can be null. Pass category_id to restrict results to the numeric Facebook Marketplace category ID returned on listing results. Supports pagination with the returned cursor. Pass the cursor value back as-is. The sort and date filters use the same values as Facebook's Marketplace UI. creation_time_descend usually orders the first pages newest first, but Facebook can insert newer listings on later cursor pages. date_listed uses Facebook's calendar-day buckets, so last_24_hours can include listings from the prior calendar day rather than enforcing an exact rolling 24-hour cutoff. For alerting/new-item workflows, continue paging while has_next_page is true and dedupe by listing id.
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
}
