Search Facebook Marketplace locations

Search Facebook Marketplace locations to obtain coordinates for listing search.

GET/v1/facebook/marketplace/locations/search
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
querystringrequiredquery

City or place name to search for Facebook Marketplace locations.

min 1 chars · max 512 chars

Response fields
19

Endpoint-specific response payload.

dataquery
string

Search query that was evaluated for this response.

Locations returned for the search query.

datalocations[]name
string

Display name for the Marketplace location match.

min 1 chars

datalocations[]subtitle
stringnullable

Additional location context shown by Facebook when available.

Address lines for the location when available.

datalocations[]multiLineAddress[]
stringoptional

min 1 chars

datalocations[]pageId
stringnullable

Facebook page identifier for the location when available.

datalocations[]latitude
number

Latitude coordinate for Marketplace listing search.

datalocations[]longitude
number

Longitude coordinate for Marketplace listing search.

datalocations[]city
stringnullable

City associated with the location when available.

datalocations[]postalCode
stringnullable

Postal or ZIP code associated with the location when available.

datatotalLocations
integer

Number of locations returned in this response.

≥ 0

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/facebook/marketplace/locations/search?query=Austin" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Marketplace locations for the requested query.