Social Fetch
Get API key
Facebook hub

Facebook Marketplace Location Search API

Turn a city or place name into Marketplace location rows with coordinates — the geo step before listing search.

GET /v1/facebook/marketplace/locations/search

1 credit per successful request.

Try in playgroundFull API docs

About this endpoint

Marketplace listing search needs a point on the map. Most product flows start with a city string a user typed ("Austin", "Brooklyn", "Toronto"), not a latitude you already stored. Guessing coordinates from a free geocoder can put the search pin in the wrong suburb; Marketplace's own location picker is what sellers and buyers actually use.

`GET /v1/facebook/marketplace/locations/search` takes a required `query` (city or place name) and returns matches under `data.locations`. Each row can include name, subtitle, multiLineAddress, pageId, latitude, longitude, city, and postalCode when Facebook exposes them. The response also echoes `data.query` and `data.totalLocations`. Bill from `meta.creditsCharged`; the flat amount for this operation is on this page and in the OpenAPI note.

This route only resolves places. Pass a chosen latitude and longitude into `GET /v1/facebook/marketplace/search` for keyword listing search, or use `GET /v1/facebook/marketplace/items` when you already have a listing URL or id. All three share one Social Fetch API key.

Facebook Marketplace Location Search API FAQ

What does the Facebook Marketplace Location Search API return?

Matching places under data.locations, the echoed query under data.query, and totalLocations for this response. Each location can include name, subtitle, multiLineAddress, pageId, latitude, longitude, city, and postalCode. Responses use the shared Social Fetch envelope with meta.requestId and meta.creditsCharged.

How do I resolve a Marketplace city or place name via API?

Send GET /v1/facebook/marketplace/locations/search with x-api-key and a required query parameter (city or place name, up to 512 characters). Pick a match's latitude and longitude for listing search. Full parameters and examples are in the API docs.

How much does Facebook Marketplace location search cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth.

Is location search the same as Marketplace listing search?

No. GET /v1/facebook/marketplace/locations/search resolves place names to coordinates. GET /v1/facebook/marketplace/search finds listings by keyword near lat/lng. Resolve the place first, then search listings with those coordinates.

Do I still need lat/lng after I search locations?

Yes, for listing search. This route returns candidate places with latitude and longitude. Pass the coordinates you choose into GET /v1/facebook/marketplace/search as lat and lng. Location search alone does not return Marketplace listings.

Do I need a Facebook account or Graph API token for location search?

No. You authenticate to Social Fetch with an API key. The route reads public Marketplace location suggestions; it does not act on behalf of a Facebook account you manage.

Other Facebook endpoints