Facebook Marketplace Location Search
Facebook Marketplace locations are place candidates identified by names, subtitles, address details, city and postal context, and geographic coordinates. These fields support location disambiguation, search-center selection, and reusable place pickers for local listing research.
Features
- Place-name location resolutionSubmit a city, region, neighborhood, or place name and receive every Marketplace location candidate returned for that lookup.
- Location disambiguation fieldsCompare candidate names, subtitles, address lines, cities, postal codes, latitude, and longitude to distinguish places that share a name.
- Traceable normalized candidatesKeep the Facebook location ID, original search query, and collection time with each candidate so a selected place can be reviewed and reused.
Parameters
| Parameters | Required | Description |
|---|---|---|
query | Required | Required non-empty city, region, neighborhood, or place name, such as Austin. |
How to Use
Submit one place-name query, follow the asynchronous task, and read the normalized location candidates returned for that lookup.
- Prepare a non-empty city, region, neighborhood, or place-name query.
- Submit query to /v1/facebook-marketplace/location-search and store the returned task_id.
- Poll /v1/tasks/{task_id} until the task succeeds or returns a failure.
- Read data.results.items and follow next_cursor while has_more is true.
curl -X POST "https://api.socq.ai/v1/facebook-marketplace/location-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"Austin"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueBest Use Cases
- Listing search center resolution: Select a candidate latitude and longitude to provide the geographic center required by Facebook Marketplace Search.
- Same-name place disambiguation: Compare subtitles, city, postal code, address, and coordinates before choosing among candidates with similar names.
- Reusable location picker data: Store the location ID, display name, place type, and coordinates behind a picker for later local listing queries.
Pro Tips
- Include region or neighborhood context when a short place name could match multiple locations.
- Compare the subtitle, city, postal code, address, and coordinates before accepting a same-name candidate.
- Do not send results_limit because the location lookup saves every candidate returned for the query.
- Continue with next_cursor whenever has_more is true so task-result pagination does not hide a saved candidate.
- Treat an empty item list as an unresolved query, not as proof that Marketplace is unavailable in that region.
Related APIs
Use these APIs when you need a different type of public Facebook Marketplace data.
- Facebook Marketplace Search API — Search public Marketplace listings by keyword and coordinates with price, location, media, category, delivery, and availability context.
- Facebook Marketplace Item API — Collect detailed public Marketplace listings from known item URLs with seller, price, location, media, attributes, delivery, and availability fields.