Is Facebook Marketplace data available via API in my country?
Updated on · Sources
If Marketplace runs in your country, GET /facebook/marketplace/search searches around any point you give it (filter_location_latitude, filter_location_longitude, filter_radius_km) and returns the public listings Marketplace shows for that area. Marketplace itself isn't available everywhere: Meta's Marketplace directory lists the countries and territories where it runs. Try your city on the free plan (200 calls a month, no card) before you build on it.
Meta's official option
Meta has no Marketplace API in any country. Marketplace launched on October 3, 2016, started rolling out to 17 European countries in August 2017, and Meta's directory lists where it's available today.
How to do it with SocialAPIs
Turn a city into coordinates with /facebook/marketplace/city-coordinates (city, optional country), then search with those coordinates and a radius. Price filters are whole numbers in the local currency.
/facebook/marketplace/categories lists the categories with the URL slugs that category_url takes. Each search costs 1 credit.
The size of it: Meta says 430 million items are listed on Marketplace each month worldwide (July 2026), and more than 3.5 million listings are posted every day in the US and Canada alone (March 2026).
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/city-coordinates1 credit
Get GPS coordinates for a city to use as Marketplace location filters.
Params:
city(required),country,exactly_oneMarketplace City Coordinates: docs and playgroundMCP:
facebook_marketplace→city_coordinatesGET /facebook/marketplace/categories1 credit
Get all Marketplace categories with seo_url and category ID values.
Marketplace Categories: docs and playgroundMCP:
facebook_marketplace→categories
curl -G "https://api.socialapis.io/facebook/marketplace/city-coordinates" \
--max-time 100 \
--fail-with-body \
-H "x-api-token: $SOCIALAPIS_API_KEY" \
--data-urlencode "city=Toronto" \
--data-urlencode "country=Canada"import os
import requests
response = requests.get(
"https://api.socialapis.io/facebook/marketplace/city-coordinates",
headers={"x-api-token": os.environ["SOCIALAPIS_API_KEY"]},
params={
"city": "Toronto",
"country": "Canada",
},
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/city-coordinates", {
city: "Toronto",
country: "Canada",
});
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/city-coordinates", Map.of(
"city", "Toronto",
"country", "Canada"));
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/city-coordinates", url.Values{
"city": {"Toronto"},
"country": {"Canada"},
})
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.get_city_coordinates(
"Toronto",
country="Canada",
)
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.getCityCoordinates("Toronto", {
country: "Canada",
});
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
- A search that finds no listings still returns data and is charged; errors (4xx/5xx) are not charged.
- Public listings only: no logins, no messages to sellers.
- Seller names come with listings and are personal data: keep them only if you need them (GDPR applies in the EU and UK).
Sources
- Facebook Marketplace directory (the countries and territories where Marketplace is available) (2026-11-16)
- Meta Newsroom: Introducing Marketplace: Buy and Sell With Your Local Community (2016-10-03)
- Meta Newsroom: Marketplace Expanding to Europe (17 countries) (2017-08-14)
- Meta Newsroom: Introducing Seller, an App for Facebook Marketplace Sellers (430 million items listed each month globally) (2026-07-24)
- Meta Newsroom: Facebook Marketplace's New Meta AI Tools (more than 3.5 million listings posted every day in the US and Canada) (2026-03-12)
Checked on 2026-11-16.