# Facebook Marketplace Location Search API. Places matching your search. Location IDs for a city or postal code. We handle the proxies, blocks and platform changes. [Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dfacebook.search_places) ## Facebook Marketplace Location Search API at a glance Returns the places Facebook Marketplace's location picker offers for a city, neighborhood or postal code, with the ID a Marketplace search takes. Each place has its name, coordinates, the city and postal code Facebook gives it, the area line the picker shows, whether Facebook calls it a city, and its check-in count. Filter to one country, or rank around coordinates to tell places of the same name apart. GET `/v1/facebook/search_places` [Read the API reference](https://socialtap.dev/docs/reference/facebook/search_places/index.md) - **1 credit** per page, $0.75–$1.97 per 1,000 pages - **21 typed fields** null when unknown - **10** places per page, most relevant first, as Marketplace's location picker ranks them - **`query`** is all it needs, e.g. `Austin` ## Send one request. Get up to 10 places 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` `query = Austin` [Open in playground](https://socialtap.dev/playground/?endpoint=facebook.search_places) cURL: ```shell curl 'https://socialtap.dev/v1/facebook/search_places?query=Austin' \ -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.searchPlaces.list({ query: "Austin" }); console.log(res.data); console.log(res.credits.charged, res.meta.request_id); ``` Node.js (fetch): ```javascript 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); ``` Python (requests): ```python 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"]) ``` Go (net/http): ```go 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"]) } ``` 200 OK: ```json { "data": [ { "account": null, "address": "Austin, IL", "approximate_fields": [ "platform_specific.facebook.checkin_count" ], "category": null, "city": "Chicago", "country_code": null, "description": null, "id": "108120015875983", "images": [], "latitude": 41.894086, "longitude": -87.763202, "metrics": { "image_count": null, "post_count": null, "review_count": null }, "name": "Austin", "phone": null, "platform": "facebook", "platform_specific": { "facebook": { "checkin_count": 25676 } }, "postal_code": "60644-1112", "price_range": null, "type": "area", "unknown_fields": [ "images" ], "url": "https://www.facebook.com/marketplace/108120015875983/", "website_url": null }, { "account": null, "address": "Austin, GA", "approximate_fields": [ "platform_specific.facebook.checkin_count" ], "category": null, "city": "Marietta", "country_code": null, "description": null, "id": "312180006098697", "images": [], "latitude": 33.955058, "longitude": -84.529634, "metrics": { "image_count": null, "post_count": null, "review_count": null }, "name": "Austin", "phone": null, "platform": "facebook", "platform_specific": { "facebook": { "checkin_count": 162 } }, "postal_code": "30060-1862", "price_range": null, "type": "area", "unknown_fields": [ "images" ], "url": "https://www.facebook.com/marketplace/312180006098697/", "website_url": null }, { "account": null, "address": null, "approximate_fields": [], "category": "City", "city": "Austin", "country_code": null, "description": null, "id": "106224666074625", "images": [], "latitude": 30.2677, "longitude": -97.7475, "metrics": { "image_count": null, "post_count": null, "review_count": null }, "name": "Austin, Texas", "phone": null, "platform": "facebook", "platform_specific": { "facebook": { "checkin_count": null } }, "postal_code": "78701", "price_range": null, "type": "area", "unknown_fields": [ "images" ], "url": "https://www.facebook.com/marketplace/106224666074625/", "website_url": null } ], "page": { "has_more": false, "next_cursor": null, "next_cursor_expires_at": null, "end_reason": "platform_limit" }, "meta": { "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f", "platform": "facebook", "source": "api", "is_cached": false, "credits_charged": 1, "latency_ms": 297, "fetched_at": "2026-10-25T12:00:00Z", "input": null, "credits_remaining": 9999, "client_request_id": null, "warnings": [] } } ``` Long arrays and strings are shortened here. Real responses are complete. ## One schema on 2 platforms. The [response reference](https://socialtap.dev/docs/reference/facebook/search_places/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/place/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 What to look for, as typed into Marketplace's location picker: a city, neighborhood or postal code. Matched by name, case-insensitive; a place ID matches nothing. - ### Write one parser Facebook Marketplace and Instagram answer in these fields, so the code that reads one reads them all. - **`platform`string**: Platform ID (tiktok, instagram, …). - **`id`string**: Platform-native place ID (TikTok POI ID, Instagram location ID, Facebook Page ID). - **`name`string**: Place name as the platform shows it. - **`url`string**: Canonical place page URL. - **`type`string**: Coarse kind: venue for one spot (a business, landmark or address), area for a region (a neighborhood, city, state or country); unknown when the platform does not say. New values may be added; treat unknown values as unknown. - **`category`string**: The platform's category label (Cafe, City, Pizza Fast Food), as shown; not normalized across platforms. - **`description`string**: The place's description or about text; null when none is shown. - **`address`string**: Address as the platform shows it: a street line on some platforms, the whole postal address or only the enclosing region on others; not normalized. 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 Location Search API. - ### Turn a city name into a Marketplace location - ### Build a location picker on Facebook's places - ### Geocode a postal code to Facebook's coordinates - ### Compare check-ins across a city's neighborhoods ## Good to know before you build. - id is the Facebook Page behind the place: the Facebook Marketplace Search API takes it as location, and the Facebook City Events API takes a city's. - Facebook doesn't put the biggest place first (Austin, Illinois comes before Austin, Texas): send country, or lat and lng, to get one specific place. - The picker returns one page per query and no more, so a full page ends at platform_limit: make the query more specific or filter by country to see others. - city is the enclosing city Facebook gives the place's coordinates, in the local script: the Austin neighborhood of Chicago has city Chicago, and Tokyo's wards have 千代田区 and 新宿区. - Facebook files a few streets among its neighborhoods, and they come back with type area, as the picker offers them. ## 1 credit per page. 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/search_places/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md) | Source | Price per successful page | Per 1,000 pages | | --- | --- | --- | | Platform API `api` | 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 Location Search API. More in the [API reference](https://socialtap.dev/docs/reference/facebook/search_places/index.md). **How much does the Facebook Marketplace Location Search API cost?** A page of up to 10 places costs 1 credit. Every successful page is charged, empty pages included. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack. **How do I get the next page?** Repeat the same request with cursor set to page.next_cursor from the previous response, keeping the other parameters. When page.has_more is false there are no more pages. Cursors expire after 24 hours. Other platforms ## Places on 1 more platform. - [Instagram Location API](https://socialtap.dev/apis/instagram/place/index.md) (1 credit · `GET /v1/instagram/place`) More Facebook Marketplace ## Facebook Marketplace API. 3 endpoints, one key. - [Facebook Marketplace Listing API](https://socialtap.dev/apis/facebook/listing/index.md) (1 credit · `GET /v1/facebook/listing`) - [Facebook Marketplace Search API](https://socialtap.dev/apis/facebook/search_listings/index.md) (1 credit / page · `GET /v1/facebook/search_listings`) ## Try it with your own search. Type 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/search_places/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)