Skip to main content
POST
Facebook Marketplace Search API

Marketplace Search

Search public listings around a geographic coordinate. Use Marketplace Location Search to find coordinates when needed.

Request Example

Use with MCP

Use the JSON request body above as the nested input object for socq_execute, or pass the same fields directly to the typed tool. Typed tools also accept _wait_seconds, _result_limit, and _idempotency_key.
A successful collection returns a task_id. Continue with socq_get_task until the task succeeds, then read normalized records from results.items.
See MCP quickstart for the complete submission and polling flow. SocQ follows result pagination until results_limit is reached or no additional page is available. Duplicate listing IDs are saved once, so the final result_count can be lower than the requested limit.

Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
latitude
number
required
Required range: -90 <= x <= 90
longitude
number
required
Required range: -180 <= x <= 180
query
string
required

Search query.

Minimum string length: 1
availability
string
Minimum string length: 1
condition
string
Minimum string length: 1
date_listed
string
Minimum string length: 1
delivery_method
string
Minimum string length: 1
max_price
number
Required range: x >= 0
min_price
number
Required range: x >= 0
radius_km
number
results_limit
integer
Required range: 1 <= x <= 2000
sort_by
string
Minimum string length: 1

Response

Task accepted

code
integer
data
object