How do I get a Facebook Marketplace listing's details and seller rating via API?
Call GET /facebook/marketplace/listing with the listing's ID as listing_id for its full details (description, photos, price, location, delivery options), and GET /facebook/marketplace/seller with a seller_id for the seller's profile, ratings, reviews and badges. Both IDs come from a search: each result of GET /facebook/marketplace/search has the listing's id and the seller in marketplace_listing_seller.
Meta's official option
Meta has no API to read other people's Marketplace listings or seller ratings. Its commerce tools (catalogs, Commerce Manager) are for selling your own products.
How to do it with SocialAPIs
The listing ID is the number in a listing's URL (facebook.com/marketplace/item/<id>), the same as id in search results.
Prices: listing 1 credit; seller 1 credit. Fetch details only for the listings you shortlist: the search already has each listing's title, price, location, photo and status.
Endpoints
GET /facebook/marketplace/listing1 credit
Get detailed info about a single Marketplace listing.
Params:
listing_id(required)Marketplace Listing Details: docs and playgroundMCP:
facebook_marketplace→listingGET /facebook/marketplace/seller1 credit
Get seller profile, ratings, reviews, and badges.
Params:
seller_id(required)Marketplace Seller Details: docs and playgroundMCP:
facebook_marketplace→sellerGET /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→search
curl -G "https://api.socialapis.io/facebook/marketplace/listing" \
--max-time 100 \
--fail-with-body \
-H "x-api-token: $SOCIALAPIS_API_KEY" \
--data-urlencode "listing_id=1647394070433636"import os
import requests
response = requests.get(
"https://api.socialapis.io/facebook/marketplace/listing",
headers={"x-api-token": os.environ["SOCIALAPIS_API_KEY"]},
params={
"listing_id": "1647394070433636",
},
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/listing", {
listing_id: "1647394070433636",
});
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/listing", Map.of(
"listing_id", "1647394070433636"));
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/listing", url.Values{
"listing_id": {"1647394070433636"},
})
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_listing_details(1647394070433636)
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.getListingDetails(1647394070433636);
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
- Check
is_sold/is_pendingin the search result first: no need to fetch the details of a sold item. - A seller's ratings and reviews help you skip risky listings; contacting sellers stays manual (the API doesn't send messages).
- Seller profiles are personal data: fetch them only when you need them, and don't keep them longer than you need (GDPR applies in the EU and UK).