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.

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

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

GET /v1/facebook/search_placesTry 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"

{
  "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": []
  }
}

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);

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;

public class Main {
    public static void main(String[] args) throws Exception {
        String query = "query=" + encode("Austin");
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://socialtap.dev/v1/facebook/search_places?" + query))
            .header("x-api-key", System.getenv("SOCIALTAP_API_KEY"))
            .GET()
            .build();
        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        // An error is {"error": {"code", "message", ...}}; success is {data, meta}, meta.credits_charged its price.
        if (response.statusCode() >= 400) throw new RuntimeException(response.body());
        System.out.println(response.body());
    }

    static String encode(String value) {
        return URLEncoder.encode(value, StandardCharsets.UTF_8);
    }
}

using System.Text.Json;

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", Environment.GetEnvironmentVariable("SOCIALTAP_API_KEY"));

var query = string.Join("&",
    "query=" + Uri.EscapeDataString("Austin"));
var res = await http.GetAsync("https://socialtap.dev/v1/facebook/search_places?" + query);
using var body = JsonDocument.Parse(await res.Content.ReadAsStringAsync());
if (!res.IsSuccessStatusCode)
{
    var error = body.RootElement.GetProperty("error");
    throw new Exception($"{error.GetProperty("code")}: {error.GetProperty("message")}");
}
Console.WriteLine(body.RootElement.GetProperty("data"));
Console.WriteLine(body.RootElement.GetProperty("meta").GetProperty("credits_charged"));

// Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] }, serde_json = "1"
use std::env;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = reqwest::blocking::Client::new()
        .get("https://socialtap.dev/v1/facebook/search_places")
        .query(&[("query", "Austin")])
        .header("x-api-key", env::var("SOCIALTAP_API_KEY")?)
        .send()?;
    let ok = res.status().is_success();
    let body: serde_json::Value = res.json()?;
    if !ok {
        return Err(format!("{}: {}", body["error"]["code"], body["error"]["message"]).into());
    }
    println!("{} {}", body["data"], body["meta"]["credits_charged"]);
    Ok(())
}

200 OK · GET https://socialtap.dev/v1/facebook/search_placesLong arrays and strings are shortened here. Real responses are complete.Docs

One schema on 2 platforms.

The response reference lists every field, its type and when it is null. See the full schema.

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.

platformstring: Platform ID (tiktok, instagram, …).
idstring: Platform-native place ID (TikTok POI ID, Instagram location ID, Facebook Page ID).
namestring: Place name as the platform shows it.
urlstring: Canonical place page URL.
typestring: 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.
categorystring: The platform's category label (Cafe, City, Pizza Fast Food), as shown; not normalized across platforms.
descriptionstring: The place's description or about text; null when none is shown.
addressstring: 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.

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 How this endpoint is priced How credits work

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.

Try it with your own search.

Type it in the playground, or copy the request into your code.

free credits

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

Start for free Read the docs

Facebook Marketplace Location Search API. Places matching your search.

Facebook Marketplace Location Search API at a glance

Send one request. Get up to 10 places back.

One schema on 2 platforms.

Null means unknown

What it accepts

Write one parser

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.

1 credit per page. Failed requests are free.

Questions about the Facebook Marketplace Location Search API.

Places on 1 more platform.

Facebook Marketplace API. 3 endpoints, one key.

Try it with your own search.