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.
Combine Facebook Marketplace data with public data from other supported social platforms.