A link as people share it (mobile, short or with tracking), a handle, an ID, or words to search. Each endpoint accepts every common form of its input.

Yes. Every request reads the platform when you send it, unless you allow a cached answer.

What does null mean in a response?

Unknown. A field the platform doesn't show is null, never zero or an empty string, so a real zero always means zero.

Are the fields the same on every platform?

Yes. 27 kinds of data have one schema each. Fields only one platform has sit under platform_specific.

What happens when a platform changes its pages?

We update our parsers. Your fields stay the same, and every endpoint's live status is public.

Do you read private or logged-in content?

No. Only public data that anyone can see without an account: no logins, no private profiles, no paywalled content.

Can my AI agent use it?

Yes. Add the MCP server and sign in with your browser, and your agent can call every endpoint. Or paste our prompt into your coding agent. The docs are also published as Markdown and llms.txt.

Facebook Marketplace Scraper API: Listings and Places

What Facebook Marketplace data can you get?

Public Facebook Marketplace listings with price, condition, description, photos, seller and delivery options. Search listings by keyword around a location with Marketplace's own filters, and find the places (cities, neighborhoods, postal codes) to search around. Part of the Facebook API.

Listing 1
Search 2

Listing

Product
Facebook Marketplace Listing API

Item for sale with price, photos and seller
1 creditGET /v1/facebook/listing

Search

Product
Facebook Marketplace Search API

Listings by keyword and location, with prices
1 credit / pageGET /v1/facebook/search_listings
Place
Facebook Marketplace Location Search API

Location IDs for a city or postal code
1 credit / pageGET /v1/facebook/search_places

Why not the official Facebook Marketplace API?

Meta's Graph API has no endpoint for reading Marketplace listings, and its Marketplace partner program is for selling a partner's own items, not reading others'.

No approval to wait for
One API key works on every endpoint. There's no app to get reviewed and no account to connect.
Anything public
Read what anyone can see without logging in, not only the accounts you manage or that authorized your app.
No daily quota
You pay per request. Plans have no rate limit, only a ceiling that stops a runaway loop.

Call the Facebook Marketplace API from your code.

Copy the request for your language, or hand it to your agent.

Facebook Marketplace Listing Try in

const params = new URLSearchParams({
  url: "https://www.facebook.com/marketplace/item/1456476040872340/",
});
const res = await fetch(`https://socialtap.dev/v1/facebook/listing?${params}`, {
  headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, meta } = body;
console.log(data, meta.credits_charged);

import os

import requests

res = requests.get(
    "https://socialtap.dev/v1/facebook/listing",
    params={"url": "https://www.facebook.com/marketplace/item/1456476040872340/"},
    headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]},
)
body = res.json()
if not res.ok:
    raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
data, meta = body["data"], body["meta"]
print(data, meta["credits_charged"])

require "json"
require "net/http"

uri = URI("https://socialtap.dev/v1/facebook/listing")
uri.query = URI.encode_www_form('url' => 'https://www.facebook.com/marketplace/item/1456476040872340/')
req = Net::HTTP::Get.new(uri)
req["x-api-key"] = ENV.fetch("SOCIALTAP_API_KEY")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(req) }
body = JSON.parse(res.body)
raise "#{body["error"]["code"]}: #{body["error"]["message"]}" unless res.is_a?(Net::HTTPSuccess)
pp body["data"]
puts body["meta"]["credits_charged"]

<?php

$query = http_build_query([
    'url' => 'https://www.facebook.com/marketplace/item/1456476040872340/',
]);
$ch = curl_init('https://socialtap.dev/v1/facebook/listing?' . $query);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-api-key: ' . getenv('SOCIALTAP_API_KEY')],
]);
$body = json_decode(curl_exec($ch), true);
if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) >= 400) {
    throw new RuntimeException($body['error']['code'] . ': ' . $body['error']['message']);
}
print_r($body['data']);
echo $body['meta']['credits_charged'], PHP_EOL;

package main

import (
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"net/url"
	"os"
)

func main() {
	q := url.Values{}
	q.Set("url", "https://www.facebook.com/marketplace/item/1456476040872340/")
	req, err := http.NewRequest("GET", "https://socialtap.dev/v1/facebook/listing?"+q.Encode(), nil)
	if err != nil {
		log.Fatal(err)
	}
	req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer res.Body.Close()
	var body struct {
		Data  json.RawMessage `json:"data"`
		Meta  map[string]any  `json:"meta"`
		Error *struct {
			Code    string `json:"code"`
			Message string `json:"message"`
		} `json:"error"`
	}
	if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
		log.Fatal(err)
	}
	if body.Error != nil {
		log.Fatalf("%s: %s", body.Error.Code, body.Error.Message)
	}
	fmt.Println(string(body.Data), body.Meta["credits_charged"])
}

curl -G 'https://socialtap.dev/v1/facebook/listing' \
  --data-urlencode 'url=https://www.facebook.com/marketplace/item/1456476040872340/' \
  -H "x-api-key: $SOCIALTAP_API_KEY"

GET https://socialtap.dev/v1/facebook/listingDocs

Facebook Marketplace Location Search Try in

const params = new URLSearchParams({
  query: "Austin",
});
const res = await fetch(`https://socialtap.dev/v1/facebook/search_places?${params}`, {
  headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, page, meta } = body;
console.log(data, meta.credits_charged);

import os

import requests

res = requests.get(
    "https://socialtap.dev/v1/facebook/search_places",
    params={"query": "Austin"},
    headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]},
)
body = res.json()
if not res.ok:
    raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
data, page, meta = body["data"], body["page"], body["meta"]
print(data, meta["credits_charged"])

require "json"
require "net/http"

uri = URI("https://socialtap.dev/v1/facebook/search_places")
uri.query = URI.encode_www_form('query' => 'Austin')
req = Net::HTTP::Get.new(uri)
req["x-api-key"] = ENV.fetch("SOCIALTAP_API_KEY")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(req) }
body = JSON.parse(res.body)
raise "#{body["error"]["code"]}: #{body["error"]["message"]}" unless res.is_a?(Net::HTTPSuccess)
pp body["data"]
puts body["meta"]["credits_charged"]

<?php

$query = http_build_query([
    'query' => 'Austin',
]);
$ch = curl_init('https://socialtap.dev/v1/facebook/search_places?' . $query);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-api-key: ' . getenv('SOCIALTAP_API_KEY')],
]);
$body = json_decode(curl_exec($ch), true);
if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) >= 400) {
    throw new RuntimeException($body['error']['code'] . ': ' . $body['error']['message']);
}
print_r($body['data']);
echo $body['meta']['credits_charged'], PHP_EOL;

package main

import (
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"net/url"
	"os"
)

func main() {
	q := url.Values{}
	q.Set("query", "Austin")
	req, err := http.NewRequest("GET", "https://socialtap.dev/v1/facebook/search_places?"+q.Encode(), nil)
	if err != nil {
		log.Fatal(err)
	}
	req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer res.Body.Close()
	var body struct {
		Data  json.RawMessage `json:"data"`
		Page  json.RawMessage `json:"page"`
		Meta  map[string]any  `json:"meta"`
		Error *struct {
			Code    string `json:"code"`
			Message string `json:"message"`
		} `json:"error"`
	}
	if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
		log.Fatal(err)
	}
	if body.Error != nil {
		log.Fatalf("%s: %s", body.Error.Code, body.Error.Message)
	}
	fmt.Println(string(body.Data), body.Meta["credits_charged"])
}

curl 'https://socialtap.dev/v1/facebook/search_places?query=Austin' \
  -H "x-api-key: $SOCIALTAP_API_KEY"

GET https://socialtap.dev/v1/facebook/search_placesDocs

Facebook Marketplace Search Try in

const params = new URLSearchParams({
  lat: "30.2677",
  lng: "-97.7475",
  query: "couch",
});
const res = await fetch(`https://socialtap.dev/v1/facebook/search_listings?${params}`, {
  headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, page, meta } = body;
console.log(data, meta.credits_charged);

import os

import requests

res = requests.get(
    "https://socialtap.dev/v1/facebook/search_listings",
    params={"lat": "30.2677", "lng": "-97.7475", "query": "couch"},
    headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]},
)
body = res.json()
if not res.ok:
    raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
data, page, meta = body["data"], body["page"], body["meta"]
print(data, meta["credits_charged"])

require "json"
require "net/http"

uri = URI("https://socialtap.dev/v1/facebook/search_listings")
uri.query = URI.encode_www_form('lat' => '30.2677', 'lng' => '-97.7475', 'query' => 'couch')
req = Net::HTTP::Get.new(uri)
req["x-api-key"] = ENV.fetch("SOCIALTAP_API_KEY")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(req) }
body = JSON.parse(res.body)
raise "#{body["error"]["code"]}: #{body["error"]["message"]}" unless res.is_a?(Net::HTTPSuccess)
pp body["data"]
puts body["meta"]["credits_charged"]

<?php

$query = http_build_query([
    'lat' => '30.2677',
    'lng' => '-97.7475',
    'query' => 'couch',
]);
$ch = curl_init('https://socialtap.dev/v1/facebook/search_listings?' . $query);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-api-key: ' . getenv('SOCIALTAP_API_KEY')],
]);
$body = json_decode(curl_exec($ch), true);
if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) >= 400) {
    throw new RuntimeException($body['error']['code'] . ': ' . $body['error']['message']);
}
print_r($body['data']);
echo $body['meta']['credits_charged'], PHP_EOL;

package main

import (
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"net/url"
	"os"
)

func main() {
	q := url.Values{}
	q.Set("lat", "30.2677")
	q.Set("lng", "-97.7475")
	q.Set("query", "couch")
	req, err := http.NewRequest("GET", "https://socialtap.dev/v1/facebook/search_listings?"+q.Encode(), nil)
	if err != nil {
		log.Fatal(err)
	}
	req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer res.Body.Close()
	var body struct {
		Data  json.RawMessage `json:"data"`
		Page  json.RawMessage `json:"page"`
		Meta  map[string]any  `json:"meta"`
		Error *struct {
			Code    string `json:"code"`
			Message string `json:"message"`
		} `json:"error"`
	}
	if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
		log.Fatal(err)
	}
	if body.Error != nil {
		log.Fatalf("%s: %s", body.Error.Code, body.Error.Message)
	}
	fmt.Println(string(body.Data), body.Meta["credits_charged"])
}

curl 'https://socialtap.dev/v1/facebook/search_listings?lat=30.2677&lng=-97.7475&query=couch' \
  -H "x-api-key: $SOCIALTAP_API_KEY"

GET https://socialtap.dev/v1/facebook/search_listingsDocs

Other platforms, same key.

Posts and profiles come back in the same fields wherever they're from.

Frequently asked questions

What you send, what comes back and how your agent uses it.

Contact us

How do I search around a city?

Send its name as Marketplace writes it in links (austin, nyc) as location, or a Marketplace link of the place, or the location_id of any listing there. The Facebook Marketplace Location Search API finds a place's ID by name, and any latitude and longitude works too.

Try it on a Facebook Marketplace link you have.

Get a key and send your first request in a minute. The same key works on every platform.

free credits

No credit card
Failed requests are free
Works on all 218 endpoints

Start for free Read the docs

Facebook Marketplace scraper API. Live data from any public link.

What Facebook Marketplace data can you get?

Listing

Facebook Marketplace Listing API

Search

Facebook Marketplace Search API

Facebook Marketplace Location Search API

Why not the official Facebook Marketplace API?

No approval to wait for

Anything public

No daily quota

Call the Facebook Marketplace API from your code.

Other platforms, same key.

TikTok

Instagram

Facebook

YouTube

Reddit

Threads

Spotify

Amazon

Apple Music

Pinterest

Rumble

X

Bluesky

Twitch

LinkedIn

Telegram

TikTok Shop

Kwai

Snapchat

SoundCloud

Truth Social

Kick

Komi

Lnk.Bio

Linkme

Linktree

Pillar

TikTok Ad Library

Facebook Ad Library

Facebook Events

Google Ads Transparency Center

LinkedIn Ad Library

Frequently asked questions

Try it on a Facebook Marketplace link you have.