How do I monitor Facebook Marketplace for new listings?
Updated on · Sources
Run the same GET /facebook/marketplace/search on a schedule (every 15 to 30 minutes for popular items) with commerce_search_sort_by=CREATION_TIME_DESCEND, keep the listing ids you've already seen, and alert on each new one. The newest listings come first, so one call per check is usually enough.
Meta's official option
Meta has no Marketplace API and no feed or webhook for new listings.
How to do it with SocialAPIs
Add your filters: query, the location (filter_location_latitude, filter_location_longitude, filter_radius_km), filter_price_upper_bound, commerce_search_and_rp_condition, and posted_today=true to ignore older items. Each search returns about 24 listings and costs 1 credit.
The Marketplace tutorial has a Python script that alerts on new listings and price drops, and the n8n flow: Schedule Trigger → HTTP Request → Split Out data.items → Remove Duplicates on id → Slack.
Cost: one search every 30 minutes is about 1,440 calls a month, every 15 minutes about 2,880. Cars or homes? /facebook/marketplace/vehicles and /facebook/marketplace/rentals take sort_by=CREATION_TIME_DESCEND the same way.
Endpoints
GET /facebook/marketplace/search1 credit
Search Facebook Marketplace items with filters for location, price, category, condition, and more.
Params:
query,category_url,proxy_country,commerce_search_sort_by,commerce_search_and_rp_condition,filter_location_latitude,filter_location_longitude,filter_price_lower_bound,filter_price_upper_bound,filter_radius_km,posted_today,exact_match,end_cursor,fieldsMarketplace Search: docs and playgroundMCP:
facebook_marketplace→searchGET /facebook/marketplace/vehicles1 credit
Search Marketplace vehicle listings with filters for location, price, mileage, year, and more.
Params:
sort_by,filter_location_latitude,filter_location_longitude,filter_price_lower_bound,filter_price_upper_bound,filter_radius_km,is_c2c_listing_only,exact_match,end_cursorMarketplace Vehicles Search: docs and playgroundMCP:
facebook_marketplace→vehiclesGET /facebook/marketplace/rentals1 credit
Search Marketplace rental property listings with filters for bedrooms, bathrooms, location, and price.
Params:
sort_by,filter_location_latitude,filter_location_longitude,filter_price_lower_bound,filter_price_upper_bound,filter_radius_km,filter_bedrooms_min,filter_bedrooms_max,filter_bathrooms_min,filter_bathrooms_max,is_c2c_listing_only,end_cursorMarketplace Rentals Search: docs and playgroundMCP:
facebook_marketplace→rentals
curl -G "https://api.socialapis.io/facebook/marketplace/search" \
--max-time 100 \
--fail-with-body \
-H "x-api-token: $SOCIALAPIS_API_KEY" \
--data-urlencode "query=road bike" \
--data-urlencode "filter_location_latitude=30.2672" \
--data-urlencode "filter_location_longitude=-97.7431" \
--data-urlencode "filter_radius_km=30" \
--data-urlencode "commerce_search_sort_by=CREATION_TIME_DESCEND" \
--data-urlencode "posted_today=true"import os
import requests
response = requests.get(
"https://api.socialapis.io/facebook/marketplace/search",
headers={"x-api-token": os.environ["SOCIALAPIS_API_KEY"]},
params={
"query": "road bike",
"filter_location_latitude": "30.2672",
"filter_location_longitude": "-97.7431",
"filter_radius_km": "30",
"commerce_search_sort_by": "CREATION_TIME_DESCEND",
"posted_today": "true",
},
timeout=100,
)
response.raise_for_status()
print(response.json())// Node 18+, as an ES module (e.g. main.mjs)
async function get(url, params) {
const query = new URLSearchParams(params).toString();
const response = await fetch(query ? `${url}?${query}` : url, {
headers: { "x-api-token": process.env.SOCIALAPIS_API_KEY },
signal: AbortSignal.timeout(100000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
return response.json();
}
const data = await get("https://api.socialapis.io/facebook/marketplace/search", {
query: "road bike",
filter_location_latitude: "30.2672",
filter_location_longitude: "-97.7431",
filter_radius_km: "30",
commerce_search_sort_by: "CREATION_TIME_DESCEND",
posted_today: "true",
});
console.log(data);import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
import java.time.Duration;
import java.util.Map;
import java.util.stream.Collectors;
public class Main {
private static final HttpClient CLIENT = HttpClient.newBuilder()
.connectTimeout(Duration.ofSeconds(10))
.build();
public static void main(String[] args) throws Exception {
String body = get("https://api.socialapis.io/facebook/marketplace/search", Map.of(
"query", "road bike",
"filter_location_latitude", "30.2672",
"filter_location_longitude", "-97.7431",
"filter_radius_km", "30",
"commerce_search_sort_by", "CREATION_TIME_DESCEND",
"posted_today", "true"));
System.out.println(body);
}
static String get(String url, Map<String, String> params) throws Exception {
String query = params.entrySet().stream()
.map(e -> URLEncoder.encode(e.getKey(), StandardCharsets.UTF_8) + "="
+ URLEncoder.encode(e.getValue(), StandardCharsets.UTF_8))
.collect(Collectors.joining("&"));
HttpRequest request = HttpRequest.newBuilder(URI.create(query.isEmpty() ? url : url + "?" + query))
.header("x-api-token", System.getenv("SOCIALAPIS_API_KEY"))
.timeout(Duration.ofSeconds(100))
.GET()
.build();
HttpResponse<String> response = CLIENT.send(request, HttpResponse.BodyHandlers.ofString());
if (response.statusCode() / 100 != 2) {
throw new RuntimeException("HTTP " + response.statusCode() + ": " + response.body());
}
return response.body();
}
}package main
import (
"fmt"
"io"
"log"
"net/http"
"net/url"
"os"
"time"
)
func main() {
body, err := get("https://api.socialapis.io/facebook/marketplace/search", url.Values{
"query": {"road bike"},
"filter_location_latitude": {"30.2672"},
"filter_location_longitude": {"-97.7431"},
"filter_radius_km": {"30"},
"commerce_search_sort_by": {"CREATION_TIME_DESCEND"},
"posted_today": {"true"},
})
if err != nil {
log.Fatal(err)
}
fmt.Println(string(body))
}
func get(endpoint string, params url.Values) ([]byte, error) {
if len(params) > 0 {
endpoint += "?" + params.Encode()
}
req, err := http.NewRequest(http.MethodGet, endpoint, nil)
if err != nil {
return nil, err
}
req.Header.Set("x-api-token", os.Getenv("SOCIALAPIS_API_KEY"))
client := &http.Client{Timeout: 100 * time.Second}
resp, err := client.Do(req)
if err != nil {
return nil, err
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
return nil, err
}
if resp.StatusCode/100 != 2 {
return nil, fmt.Errorf("HTTP %d: %s", resp.StatusCode, body)
}
return body, nil
}# pip install socialapis-sdk
import os
from socialapis import Facebook
client = Facebook(api_token=os.environ["SOCIALAPIS_API_KEY"])
response = client.search_marketplace(
"road bike",
filter_location_latitude=30.2672,
filter_location_longitude=-97.7431,
filter_radius_km=30,
commerce_search_sort_by="CREATION_TIME_DESCEND",
posted_today=True,
)
print(response)// npm install socialapis-sdk
import { Facebook } from "socialapis-sdk";
const client = new Facebook({ apiToken: process.env.SOCIALAPIS_API_KEY });
const response = await client.searchMarketplace("road bike", {
filter_location_latitude: 30.2672,
filter_location_longitude: -97.7431,
filter_radius_km: 30,
commerce_search_sort_by: "CREATION_TIME_DESCEND",
posted_today: true,
});
console.log(response);Your API key goes in the x-api-token header (here from the SOCIALAPIS_API_KEY environment variable). Get a free key.
Tutorial: Get Facebook Marketplace listings with PythonUse it from Claude, ChatGPT or Cursor (MCP)
Good to know
- Run it once by hand first so the existing listings are recorded as seen; otherwise the first run alerts on all of them.
- Skip listings with
is_soldoris_pendingbefore alerting. - Keep the query and radius narrow: Meta says more than 3.5 million listings are posted on Marketplace every day in the US and Canada (March 2026).
Sources
Checked on 2026-11-16.