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

# Search Facebook Marketplace

`GET /facebook/marketplace/search`

## Request

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

Fetches Facebook Marketplace search or browse results for a location: listing id, title, price, city/state, and a thumbnail image per result. Only the first page Facebook's own server-rendered results page returns is available — Facebook's own further pagination requires a logged-in session and is out of scope. Omit both query and category to get the location's browse feed instead of running a search. minPrice, maxPrice, sortBy, daysSinceListed, and condition only take effect alongside a query or category (Facebook itself ignores them on the plain browse feed), except for the property_rentals category, which has its own always-filtered listing page. This endpoint can take noticeably longer than other search endpoints (up to roughly a minute in the slowest case) as it retries to get past an intermittent upstream condition; priced accordingly.

## Query parameters

- `location` string, required
- `query` string
- `category` 'vehicles' | 'property_rentals' | 'classifieds' | 'apparel' | 'electronics' | 'entertainment' | 'family' | 'free' | 'garden_outdoors' | 'hobbies' | 'home_goods' | 'home_improvement' | 'musical_instruments' | 'office_supplies' | 'pet_supplies' | 'property_sale' | 'sporting_goods' | 'toys_games'
- `min_price` integer
- `max_price` integer
- `sort_by` 'best_match' | 'distance_ascend' | 'creation_time_descend' | 'price_ascend' | 'price_descend'
- `days_since_listed` 1 | 7 | 30
- `condition` 'new' | 'used_like_new' | 'used_good' | 'used_fair'

## Headers

- `x-api-key` string, required

## Response `200`

OK

- FacebookMarketplaceSearchResponseDoc
  - `code` integer
  - `data` FacebookMarketplaceSearchResult
    - `category` string
    - `hasMore` boolean
    - `listings` FacebookMarketplaceListing[]
      - `city` string
      - `id` string
      - `image` string
      - `price` FacebookMarketplacePrice
        - `amount` string
        - `currency` string
        - `formatted` string: Formatted is Facebook's own display string, e.g. "$4,500" or "FREE".
        - `isFree` boolean: IsFree is true when the listing has no price (Formatted == "FREE").
      - `state` string
      - `title` string
      - `url` string
    - `location` string
    - `query` string
    - `sourceUrl` string
  - `msg` string

## Other responses

- `400`: Bad request — missing location, an unrecognized enum value, an invalid price range, or a filter given without query/category
- `404`: Location not recognized by Facebook Marketplace
- `500`: Internal server error while fetching search results

---

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