---
title: "Marketplace › Search"
method: GET
path: "/v1/facebook/marketplace/search"
tags: ["facebook"]
---

# Marketplace › Search

`GET /v1/facebook/marketplace/search`

## Request

- Base URL: `https://api.insightsocial.app`
- URL: `https://api.insightsocial.app/v1/facebook/marketplace/search`
- Auth: API key in header `x-api-key`

Returns Facebook Marketplace listings near a lat/lng, each with title, price, location, photo, delivery types, and sold or live flags.

Use it to find listings in an area; get lat and lng from marketplace/location/search, and de-duplicate by listing id since ordering can shift.

**10 credits** per call.

Paginates by `cursor`: see [Pagination](https://www.insightsocial.app/docs/pagination).

## Query parameters

- `query` string, required
- `lat` string, required
- `lng` string, required
- `radius_km` integer
- `min_price` integer
- `max_price` integer
- `count` integer
- `sort_by` 'suggested' | 'distance_ascend' | 'creation_time_descend' | 'price_ascend' | 'price_descend'
- `delivery_method` 'all' | 'local_pickup' | 'shipping'
- `condition` 'new' | 'used_like_new' | 'used_good' | 'used_fair'
- `date_listed` 'all' | '1' | '7' | '30' | 'last_24_hours' | 'last_7_days' | 'last_30_days'
- `availability` 'available' | 'sold' | 'all'
- `cursor` string
- `dry_run` '1'

## Response `200`

Success.

- object
  - `success` true, required
  - `platform` string, required
  - `endpoint` string, required
  - `schema_version` '2', required
  - `data` ConventionsData, required
  - `pagination` Pagination
    - `next_cursor` string, nullable, required
    - `has_more` boolean, required
    - `page_size` integer, required
    - `stopped_at` 'since' | 'known_id' | 'end', nullable
  - `unavailable` string[], required
  - `credits_used` integer, required
  - `credits_remaining` integer, required
  - `request_id` string, required
  - `cached` boolean, required
  - `idempotent_replay` boolean, required
  - `charge_reason` string, required
  - `free_call` boolean, required

## Other responses

- `400`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `401`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `402`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `404`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `409`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `429`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `500`: See [Error handling](https://www.insightsocial.app/docs/errors).
- `503`: See [Error handling](https://www.insightsocial.app/docs/errors).

---

[API](https://skmtc.dev/insightsocial/apis/insightsocial-api.md) · [All operations](https://skmtc.dev/insightsocial/apis/insightsocial-api/llms.txt) · [OpenAPI document](https://skmtc.dev/insightsocial/apis/insightsocial-api/revisions/c82924cdabf2?raw)