Facebook

Search Facebook Marketplace

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.

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

Query parameters

locationstring required

Facebook Marketplace location vanity slug

querystring

Free-text search terms; omit (with category) for the location's browse feed

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'

Marketplace category

min_priceinteger

Minimum price in whole currency units; requires query or category

max_priceinteger

Maximum price in whole currency units; requires query or category

sort_by'best_match' | 'distance_ascend' | 'creation_time_descend' | 'price_ascend' | 'price_descend'

Result order; requires query or category

days_since_listed1 | 7 | 30

Restrict to listings posted within this many days; requires query or category

condition'new' | 'used_like_new' | 'used_good' | 'used_fair'

Comma-separated listing conditions; requires query or category

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "category": "vehicles",
    "hasMore": true,
    "listings": [
      {
        "city": "Austin",
        "id": "1548909030206114",
        "image": "https://scontent.fsgn12-1.fna.fbcdn.net/v/t39.84726-6/763156366_1318061980540811_5053765390157515593_n.jpg",
        "price": {
          "amount": "4500.00",
          "currency": "USD",
          "formatted": "$4,500"
        },
        "state": "TX",
        "title": "Electric bike",
        "url": "https://www.facebook.com/marketplace/item/1548909030206114/"
      }
    ],
    "location": "austin",
    "query": "bike",
    "sourceUrl": "https://www.facebook.com/marketplace/austin/search/?query=bike"
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.