Social Fetch
Get API key
Facebook hub

Facebook Marketplace Search API

Keyword search over Marketplace listings near a latitude and longitude — structured rows in the same envelope as the rest of the Facebook tag.

GET /v1/facebook/marketplace/search

1 credit per successful request.

Try in playgroundFull API docs

About this endpoint

Price monitoring, local inventory research, and reseller alerts all need the same input: a search phrase and a place on the map. Clicking through Marketplace in a browser works for a few queries; it falls apart when you sweep dozens of cities on a schedule or want listing rows next to Ad Library and page data in one warehouse.

`GET /v1/facebook/marketplace/search` takes a required `query`, `lat`, and `lng`, then returns matching listings under `data.listings`. Optional filters narrow the page: `radiusKm`, `minPrice` / `maxPrice`, `count` (1–100), `sortBy` (`suggested`, `distanceAscend`, `creationTimeDescend`, `priceAscend`, `priceDescend`), `deliveryMethod` (`all`, `localPickup`, `shipping`), `condition`, `dateListed`, and `availability`. When `data.page.hasMore` is true, pass `data.page.nextCursor` as `cursor` on the next call. Bill from `meta.creditsCharged`; the flat amount for this operation is on this page and in the OpenAPI note.

Need coordinates for a city name first? Use `GET /v1/facebook/marketplace/locations/search`. For one known listing URL or id, use `GET /v1/facebook/marketplace/items`. All three share one Social Fetch API key.

Facebook Marketplace Search API FAQ

What does the Facebook Marketplace Search API return?

A page of Marketplace listings under data.listings, the echoed query and location under data.query and data.location, totalListings for this page, and pagination under data.page (hasMore, nextCursor). Each listing can include id, url, title, price, location, primaryPhoto, deliveryTypes, and status flags. Responses use the shared Social Fetch envelope with meta.requestId and meta.creditsCharged.

How do I search Facebook Marketplace listings via API?

Send GET /v1/facebook/marketplace/search with x-api-key and required query, lat, and lng parameters. Optionally add radiusKm, minPrice, maxPrice, count, sortBy, deliveryMethod, condition, dateListed, availability, and cursor. Full enums and examples are in the API docs.

How much does Facebook Marketplace listing search cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth. Each paginated page is a separate billed request.

Do I need lat/lng, or can I search Marketplace by city name alone?

Listing search requires latitude and longitude. Resolve a city or place name with GET /v1/facebook/marketplace/locations/search first, then pass the coordinates into this route.

Is Marketplace search the same as fetching one Marketplace item?

No. GET /v1/facebook/marketplace/search finds listings by keyword near a location. GET /v1/facebook/marketplace/items returns a single listing when you already have a Marketplace item URL or id.

How does pagination work on Facebook Marketplace search?

When data.page.hasMore is true, pass data.page.nextCursor as the cursor query param on the next request. Keep the same query, coordinates, and filters across pages.

Do I need a Facebook account or Graph API token to search Marketplace?

No. You authenticate to Social Fetch with an API key. The route reads public Marketplace search results; it does not act on behalf of a Facebook account you manage.

Other Facebook endpoints