# Facebook Marketplace Listing API. Send a listing link or ID. Item for sale with price, photos and seller. We handle the proxies, blocks and platform changes. [Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dfacebook.listing) ## Facebook Marketplace Listing API at a glance Returns a public Facebook Marketplace listing from its link or ID: title, price, condition, description, photos and the seller with their rating. It also has the struck-through earlier price, currency, category, whether it's available, pending or sold, videos, the seller's join date, the area it's in with coordinates, and pickup, shipping or Buy now. Vehicles add make, model, trim, mileage, transmission and colors, and homes their details. GET `/v1/facebook/listing` [Read the API reference](https://socialtap.dev/docs/reference/facebook/listing/index.md) - **1 credit** per request, $0.75–$1.97 per 1,000 requests - **23 typed fields** null when unknown - **`url`** is all it needs, e.g. `https://www.facebook.com/marketplace/item/1456476040872340/` - **100 credits** free when you sign up, no card, so you can build before you spend ## Send one request. Get 23 fields back. Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free. `$ npm install socialtap` `url = https://www.facebook.com/marketplace/item/1456476040872340/` [Open in playground](https://socialtap.dev/playground/?endpoint=facebook.listing) cURL: ```shell 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" ``` TypeScript SDK: ```typescript import { SocialTap } from "socialtap"; const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY const res = await client.facebook.listing.get({ url: "https://www.facebook.com/marketplace/item/1456476040872340/" }); console.log(res.data); console.log(res.credits.charged, res.meta.request_id); ``` Node.js (fetch): ```javascript 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); ``` Python (requests): ```python 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"]) ``` Go (net/http): ```go 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"]) } ``` 200 OK: ```json { "data": { "approximate_fields": [ "platform_specific.facebook.latitude", "platform_specific.facebook.longitude" ], "attributes": [ { "name": "Condition", "value": "Used - like new" }, { "name": "Material", "value": "Steel" }, { "name": "Bicycle Type", "value": "Cruiser Bike" } ], "availability": "in_stock", "category": "Bicycles", "category_id": "1658310421102081", "condition": "used", "condition_label": "Used - like new", "country_code": null, "currency": "USD", "description": "Barely used, 24\" steel Huffy Bike perfect for outdoor terrain and everyday rides \n\n-Fully functional brakestyle with progressive sizing and clean seat cover \n\n-If needed, I am willing to deliver the bike to your home or flexible for an at-home pick-up", "id": "1456476040872340", "max_price": 45, "media": [ { "alt_text": null, "duration_ms": null, "expires_at": "2026-10-25T18:00:00Z", "height": 720, "thumbnail_url": null, "type": "image", "url": "https://scontent-atl3-2.xx.fbcdn.net/v/t39.84726-6/796968328_2328210001329072_7831806606744114668_n.jpg?stp=dst-jpg_p720x720_tt6&_nc_cat=101&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=14&_nc_ht=scontent-atl3-2.xx&_nc_gid=SCRUBBED&_nc_ss=7b289&oh=SCRUBBE…", "width": 960 }, { "alt_text": null, "duration_ms": null, "expires_at": "2026-10-25T18:00:00Z", "height": 960, "thumbnail_url": null, "type": "image", "url": "https://scontent-atl3-1.xx.fbcdn.net/v/t45.5328-4/800796705_2129037657962264_2251174291161391522_n.jpg?stp=dst-jpg_p720x720_tt6&_nc_cat=109&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=23&_nc_ht=scontent-atl3-1.xx&_nc_gid=SCRUBBED&_nc_ss=7b289&oh=SCRUBBED…", "width": 720 } ], "original_price": null, "platform": "facebook", "platform_specific": { "facebook": { "delivery_types": [ "in_person", "door_pickup", "door_dropoff" ], "is_buy_now_enabled": false, "is_local_pickup": true, "latitude": 40.663146972656, "location": "Rockville Centre, NY", "location_id": null, "longitude": -73.635864257812, "postal_code": null, "price_period": null, "published_at": "2026-09-09T13:45:37Z", "seller_joined_at": "2026-09-09T13:20:08Z", "seller_rating": null, "seller_rating_count": null } }, "price": 45, "seller": { "avatar_url": "https://scontent-atl3-1.xx.fbcdn.net/v/t39.30808-1/795438461_122093964159482116_3880964857956452102_n.jpg?stp=c334.0.1380.1380a_cp6_dst-jpg_tt6&cstp=mx1380x1380&ctp=s100x100&_nc_cat=110&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=24&_nc_ht=scontent-atl3-…", "display_name": "Meredith Hall", "id": "pfbid0bhJ8iBQwR4XVDCyEgQU4hKBvHyZPUVgJuBYVSa4henf9QvFwHycKvjgyYX3imnYCl", "is_verified": false, "url": null, "username": null }, "shipping": { "fee": null, "is_offered": false }, "thumbnail_url": "https://scontent-atl3-2.xx.fbcdn.net/v/t39.84726-6/796968328_2328210001329072_7831806606744114668_n.jpg?stp=dst-jpg_p720x720_tt6&_nc_cat=101&ccb=SCRUBBED&_nc_sid=SCRUBBED&_nc_ohc=SCRUBBED&_nc_oc=SCRUBBED&_nc_zt=14&_nc_ht=scontent-atl3-2.xx&_nc_gid=SCRUBBED&_nc_ss=7b289&oh=SCRUBBE…", "title": "Barely Used, \"26 Turquoise Huffy Bike", "type": "listing", "unknown_fields": [], "url": "https://www.facebook.com/marketplace/item/1456476040872340/" }, "meta": { "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f", "platform": "facebook", "source": "api", "is_cached": false, "credits_charged": 1, "latency_ms": 2624, "fetched_at": "2026-10-25T12:00:00Z", "input": { "kind": "product", "id": "1456476040872340", "url": "https://www.facebook.com/marketplace/item/1456476040872340/" }, "credits_remaining": 9999, "client_request_id": null, "warnings": [] } } ``` Long arrays and strings are shortened here. Real responses are complete. ## One schema on 3 platforms. The [response reference](https://socialtap.dev/docs/reference/facebook/listing/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/product/index.md). - ### Null means unknown A field Facebook Marketplace doesn't show is null, never zero or an empty string, so a real zero always means zero. - ### What it accepts Facebook Marketplace listing URL (/marketplace/item/\, also under a city's or category's path, or the older /commerce/listing/\; www., m. and web. hosts, any query string), or the listing's numeric ID. - ### Write one parser Facebook Marketplace, Amazon and TikTok Shop answer in these fields, so the code that reads one reads them all. - **`platform`string**: Platform ID (tiktokshop, facebook, …). - **`id`string**: Platform-native product or listing ID (string). - **`url`string**: Canonical product page URL. - **`type`string**: product: a catalog product a shop sells in many units, often in variants (TikTok Shop, Instagram and YouTube shopping); listing: a single item a person or business lists for sale (Facebook Marketplace). New values may be added; treat unknown values as product. - **`title`string**: Product name or listing title, as the seller wrote it. - **`description`string**: Description as plain text (paragraphs separated by blank lines); null when it has none or the source does not show it (lists and search results). - **`category`string**: The platform's most specific category label (Bicycles, Vitamins & Supplements), as shown; not normalized across platforms. - **`category_id`string**: The platform's ID of that category (what its category browsing and filters take). Live data from 33 platforms. [TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/index.md) · [Linkme](https://socialtap.dev/apis/linkme/index.md) · [Linktree](https://socialtap.dev/apis/linktree/index.md) · [Pillar](https://socialtap.dev/apis/pillar/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md) ## What teams build with the Facebook Marketplace Listing API. - ### Track resale prices and availability - ### Monitor listings of your brand's products - ### Vet a listing and its seller before buying - ### Enrich search results with full listing details ## Good to know before you build. - Coordinates are the area Facebook shows on its map, never the seller's address, so approximate_fields always lists them. - A deleted, removed or never-existing listing returns not_found. A sold or pending one comes back with its availability. - Photo and video links are Facebook CDN links that expire at media\[\].expires_at: download what you need before then. - A property rental's price is its monthly rent, and platform_specific.facebook.price_period is month. - The seller's rating is null unless their Marketplace ratings are public. ## 1 credit per request. Failed requests are free. Buy credits once and spend them on any endpoint, on any platform. [Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/facebook/listing/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md) | Source | Price per successful request | Per 1,000 requests | | --- | --- | --- | | Platform API `api` | 1 credit | $0.75–$1.97 | | Public page `page` | 1 credit | $0.75–$1.97 | - Cache hits are free. - Credits from packs and top-ups never expire. - A monthly plan's credits are spent first, and what is left of them ends at each renewal. - Prices exclude tax: sales tax is added at checkout where it applies. - Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID. ## Questions about the Facebook Marketplace Listing API. More in the [API reference](https://socialtap.dev/docs/reference/facebook/listing/index.md). **How much does the Facebook Marketplace Listing API cost?** A request costs 1 credit. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack. Other platforms ## Products on 2 more platforms. - [Amazon Product API](https://socialtap.dev/apis/amazon/product/index.md) (1 credit · `GET /v1/amazon/product`) - [TikTok Shop Product API](https://socialtap.dev/apis/tiktokshop/product/index.md) (1 credit · `GET /v1/tiktokshop/product`) More Facebook Marketplace ## Facebook Marketplace API. 3 endpoints, one key. - [Facebook Marketplace Search API](https://socialtap.dev/apis/facebook/search_listings/index.md) (1 credit / page · `GET /v1/facebook/search_listings`) - [Facebook Marketplace Location Search API](https://socialtap.dev/apis/facebook/search_places/index.md) (1 credit / page · `GET /v1/facebook/search_places`) ## Try it on a link you already have. Paste it in the playground, or copy the request into your code. 100free credits - No credit card - Failed requests are free - Works on all 218 endpoints [Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md) --- [HTML version](https://socialtap.dev/apis/facebook/listing/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)