What is Facebook marketplace scraper?

It is simple yet extensive tool to extract listings from facebook marketplace. It supports filters using which you can do targeted queries. You can also export listings to JSON/CSV or any other as format supported by Apify.

Input

Click on the input tab for a full explanation of input in JSON.

There are 2 ways to provide input to the scraper.

Method 1: using search urls.

The scraper accepts search urls as input. Please note not all search urls are supported.

Supported url patterns:

/^https://www.facebook.com/marketplace/(\\d+|\\w+)/(search|vehicles|propertyrentals|apparel|electronics|entertainment|family|free|garden|hobbies|home|home-improvements|instruments|office-supplies|pets|propertyforsale|sports|toys)/?(?query=.+)/

Required:

1. Urls - you can provide in a list of urls.
2. Proxy - must be residential or it may get blocked.
3. Max page limit - 0 would mean no limit otherwise enter the max number of pages to scrape.

Note:

• For search urls, it has been observed that apify proxies doesn't perform well. In that case, please try a different residentaial proxy provider.
• For category based search urls(/category/), the actors uses lat/lng/radius setting from search section input.

Input sample

{
    "isC2CListingOnly": false,
    "extendItem": false,  // default: false, when it fetch item details
    "lat": "40.68",
    "lng": "-73.87",
    "local": true,
    "maxPage": 2,
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    },
    "radius": "10",
    "searchUrls": [
        "https://www.facebook.com/marketplace/105618626137781/search?sortBy=distance_ascend&query=rebuilt%20title%20car&exact=false",
        "https://www.facebook.com/marketplace/nyc/search/?maxPrice=7896&sortBy=distance_ascend&query=rebuilt%20title%20car&exact=false",
        "https://www.facebook.com/marketplace/category/search?deliveryMethod=shipping&query=bag",
        "https://www.facebook.com/marketplace/category/vehicles?deliveryMethod=shipping&sortBy=price_descend&vehicleExteriorColors=black&exact=false"
    ]
}

Method 2: using the search section feature.

Instead of directly feeding in facebook marketplace urls, you can skip it and construct your search from within the dashboard by using the search section. You can find all available options in a dropdown or by clicking on the ❔ icon.

Within search section, there are 2 ways to create a search

Custom Search

Not all search urls are supported in searchurls field. In case like these, we can create a custom search using this field. It accepts search queries in the pattern {location}/{query}.

eg. nyc/ps5 or ps5

If a location isn't specified in the search query, the actor uses the lat/lng of the search section as fallback values.

Note: Using custom search will ignore the category field.

Required:

1. Proxy - must be residential or it may get blocked.
2. Max page limit - 0 would mean no limit otherwise enter the max number of pages to scrape.
3. Custom Search - custom search query(nyc/ps5 or just ps5). For missing location in search query, the actor will use Lat/Lng from thr search section.

{
    "search": "nyc/ps5",
    "isC2CListingOnly": false,
    "lat": "40.68",  // this will be overriden by the search location(nyc)
    "lng": "-73.87", // this will be overriden by the search location(nyc)
    "local": true,
    "maxPage": 2,
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    },
    "radius": "10",
}

{
    "search": "ps5",
    "isC2CListingOnly": false,
    "lat": "40.68",  // this will be used as fallback
    "lng": "-73.87", // this will be used as fallback
    "local": true,
    "maxPage": 2,
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    },
    "radius": "10",
}

category

If you just want to target a specific category only like vehicles, electronice etc. You can use choose this option.

Required:

1. Proxy - must be residential or it may get blocked.
2. Location data - latitude/longitude along with radius of your search query.
3. Max page limit - 0 would mean no limit otherwise enter the max number of pages to scrape.
4. Category - pick the category for you search.

Input sample

{
    "category": "vehicles",
    "isC2CListingOnly": false,
    "lat": "40.68",
    "lng": "-73.87",
    "local": true,
    "maxPage": 2,
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    },
    "radius": "10",
}

Get detailed Items data

You can also get detailed items data by enabling Get item extended data option.

Output sample

[
  {
    "category": "vehicles",
    "category_id": "807311116002614",
    "search_area": {
      "radius": 10,
      "lat": 40.68,
      "lng": -73.87
    },
    "listing": {
      "id": "268673524806527",
      "url": "https://www.facebook.com/marketplace/item/268673524806527/",
      "primary_photo": "https://scontent-hou1-1.xx.fbcdn.net/v/t39.30808-6/240717828_1675731505970468_2601249461663042388_n.jpg?stp=c0.29.261.261a_dst-jpg_p261x260&_nc_cat=102&ccb=1-7&_nc_sid=870c51&_nc_ohc=-4mphYcsbqgAX9IFBRw&_nc_ht=scontent-hou1-1.xx&oh=00_AfCR47HrqYgBnFSLBfKuGDcUQ71f7OxXtGmSn47fXDlObA&oe=651E86D1",
      "title": "2000 Volvo V70 · XC AWD SE Wagon 4D",
      "custom_title": "2000 Volvo v70 XC AWD SE Wagon 4D",
      "custom_subtitles": [
        "128K miles"
      ],
      "price": {
        "formatted_amount": "$2,800",
        "amount_with_offset_in_currency": "280000"
      },
      "max_listing_price": null,
      "min_listing_price": null,
      "strikethrough_price": null,
      "boosted_marketplace_listing": null,
      "promoted_listing": null,
      "description": "Volvo v70xc awd se for sale clean low miles hmu for details ",
      "creation_timestamp": 1629930264,
      "inventory_type": "SINGLE_QUANTITY",
      "condition": "USED",
      "details": {
        "id": "268673524806527",
        "creation_time": 1629930264,
        "location_vanity_or_id": "111806958846634",
        "is_viewer_seller": false,
        "listing_inventory_type": "SINGLE_QUANTITY",
        "payment_time_period": null,
        "condition": "USED",
        "logging_id": "4102544856521811",
        "marketplace_lead_gen_form": null,
        "listed_by": null,
        "real_estate_listing_agent": null,
        "inventory_count": null,
        "legal_reporting_cta_type": null,
        "legal_reporting_uri": null,
        "messaging_enabled": true,
        "listing_is_rejected": false,
        "seller_message_thread": null,
        "is_checkout_enabled": false,
        "is_draft": false,
        "can_seller_edit": false,
        "origin_group": null,
        "default_variant_listing": null,
        "hidden_from_friends": null,
        "can_share": true,
        "can_seller_change_availability": false,
        "messagingEnabled": true,
        "has_children": false,
        "active_order": null,
        "rebuy_order_receipt": null,
        "c2c_shipping_eligible": false,
        "is_shipping_offered": false,
        "most_recent_active_order_as_buyer": null,
        "order_summaries": [],
        "should_hide_pdp_shipping_content": true,
        "shipping_profile": null,
        "is_seller_business_onboarded": false,
        "is_buy_now_enabled": false,
        "is_purchase_protected": false,
        "can_buyer_make_checkout_offer": false,
        "is_cart_enabled": false,
        "vacation_mode": null,
        "all_message_threads": {
          "is_empty": true
        },
        "marketplace_listing_category_id": "807311116002614",
        "should_show_txn_survey_on_mas": false,
        "incentive_campaign_for_free_shipping": null,
        "first_message_suggested_value": null,
        "marketplace_bump_info": null,
        "fi_enhanced_appeal_data": {
          "use_fi_appeals": false
        },
        "listing_seller_notices": [],
        "fair_market_value_data": null,
        "vehicle_condition": null,
        "vehicle_exterior_color": "black",
        "vehicle_features": [
          {
            "display_name": "Leather Seats",
            "feature_category": "SEATING",
            "feature_type": "LEATHER"
          },
          {
            "display_name": "Moon Roof",
            "feature_category": "EXTERIOR",
            "feature_type": "MOON_ROOF"
          },
          {
            "display_name": "Alloy Wheels",
            "feature_category": "EXTERIOR",
            "feature_type": "ALLOY_WHEELS"
          },
          {
            "display_name": "5-Cyl, Turbo, 2.4 Liter",
            "feature_category": "ENGINE",
            "feature_type": null
          },
          {
            "display_name": "ABS",
            "feature_category": "SAFETY",
            "feature_type": "ABS_BRAKES"
          },
          {
            "display_name": "AM/FM Stereo",
            "feature_category": "ENTERTAINMENT",
            "feature_type": null
          },
          {
            "display_name": "AWD",
            "feature_category": "DRIVETRAIN",
            "feature_type": null
          },
          {
            "display_name": "Air Conditioning",
            "feature_category": "CONVENIENCE",
            "feature_type": "AIR_CONDITIONING"
          },
          {
            "display_name": "Automatic",
            "feature_category": "TRANSMISSION",
            "feature_type": null
          },
          {
            "display_name": "MP3",
            "feature_category": "ENTERTAINMENT",
            "feature_type": "MP3"
          },
          {
            "display_name": "Cassette",
            "feature_category": null,
            "feature_type": null
          },
          {
            "display_name": "Cruise Control",
            "feature_category": "CONVENIENCE",
            "feature_type": "CRUISE_CONTROL"
          },
          {
            "display_name": "Dual Air Bags",
            "feature_category": "SAFETY",
            "feature_type": null
          },
          {
            "display_name": "Power Door Locks",
            "feature_category": "CONVENIENCE",
            "feature_type": "POWER_DOOR_LOCKS"
          },
          {
            "display_name": "Power Seats",
            "feature_category": "SEATING",
            "feature_type": "POWER_SEATS"
          },
          {
            "display_name": "Power Steering",
            "feature_category": "CONVENIENCE",
            "feature_type": "POWER_STEERING"
          },
          {
            "display_name": "Power Windows",
            "feature_category": "CONVENIENCE",
            "feature_type": "POWER_WINDOWS"
          },
          {
            "display_name": "Roof Rack",
            "feature_category": "EXTERIOR",
            "feature_type": "ROOF_RACK"
          },
          {
            "display_name": "Side Air Bags",
            "feature_category": "SAFETY",
            "feature_type": null
          },
          {
            "display_name": "Telescoping Wheel",
            "feature_category": null,
            "feature_type": null
          }
        ],
        "vehicle_fuel_type": null,
        "vehicle_identification_number": null,
        "vehicle_interior_color": "",
        "vehicle_is_paid_off": null,
        "vehicle_make_display_name": "Volvo",
        "vehicle_model_display_name": "V70",
        "vehicle_number_of_owners": "ONE",
        "vehicle_odometer_data": {
          "unit": "MILES",
          "value": 128000
        },
        "vehicle_registration_plate_information": null,
        "vehicle_seller_type": "PRIVATE_SELLER",
        "vehicle_specifications": {
          "co2_emissions": null,
          "engine_size": null,
          "gas_mileage_city": {
            "type": "GAS_MILEAGE_CITY",
            "units": "MPG",
            "value": "16.00"
          },
          "gas_mileage_combined": {
            "type": "GAS_MILEAGE_COMBINED",
            "units": "MPG",
            "value": "19.00"
          },
          "gas_mileage_highway": {
            "type": "GAS_MILEAGE_HIGHWAY",
            "units": "MPG",
            "value": "23.00"
          },
          "horse_power": null,
          "safety_rating_front": null,
          "safety_rating_overall": null,
          "safety_rating_rollover": null,
          "safety_rating_side": null,
          "safety_rating_side_barrier": null
        },
        "vehicle_title_status": null,
        "vehicle_transmission_type": "AUTOMATIC",
        "vehicle_trim_display_name": "XC AWD SE Wagon 4D",
        "vehicle_carfax_report": null,
        "attribute_data": [],
        "origin_target": {
          "__typename": "Marketplace",
          "id": "1663689853903557"
        },
        "shipping_offered": false,
        "legal_disclosure_impressum_url": null,
        "commerce_badges_info": {
          "source_summary": null,
          "badges": []
        },
        "listing_address": null,
        "vehicle_website_link": null,
        "dealership_name": null,
        "energy_efficiency_class_eu": null,
        "pre_recorded_videos": []
      }
    },
    "media": {
      "pre_recorded_videos": []
    },
    "seller": {
      "id": "100006009033120",
      "name": "Jensen Albanese",
      "profile_url": "https://www.facebook.com/profile.php?id=100006009033120",
      "joined": 1369590095,
      "is_verified": false,
      "rating": {
        "average": 0,
        "count": 0,
        "private": true
      },
      "is_seller_business_onboarded": false
    },
    "location": {
      "city": "Union",
      "state": "NJ",
      "city_displayname": "Union Township",
      "latitude": 40.690612792969,
      "longitude": -74.295043945312
    },
    "origin_group": null,
    "delivery": [
      "IN_PERSON"
    ],
    "is_hidden": false,
    "is_live": true,
    "is_pending": false,
    "is_sold": false
  },
  {
    "category": "vehicles",
    "category_id": "807311116002614",
    "search_area": {
      "radius": 10,
      "lat": 40.68,
      "lng": -73.87
    },
    "listing": {
      "id": "1259043654806502",
      "url": "https://www.facebook.com/marketplace/item/1259043654806502/",
      "primary_photo": "https://scontent-hou1-1.xx.fbcdn.net/v/t39.30808-6/380808074_6631616276930554_4162667673972440599_n.jpg?stp=c43.0.260.260a_dst-jpg_p261x260&_nc_cat=102&ccb=1-7&_nc_sid=870c51&_nc_ohc=QDiBdb3J7SEAX97fpEd&_nc_ht=scontent-hou1-1.xx&oh=00_AfDy8VhEAHdpIytFlKAB0vGIHExKEDEEjGvN9tJWvkHoJA&oe=651F8F9D",
      "title": "2018 Ford Fiesta · Titanium Sedan 4D",
      "custom_title": "2018 Ford fiesta Titanium Sedan 4D",
      "custom_subtitles": [
        "91K miles"
      ],
      "price": {
        "formatted_amount": "$7,600",
        "amount_with_offset_in_currency": "760000"
      },
      "max_listing_price": null,
      "min_listing_price": null,
      "strikethrough_price": null,
      "boosted_marketplace_listing": null,
      "promoted_listing": null,
      "description": "2018 Ford fiesta ,Bluetooth, backup camera, Run and Drives excellent, no issues, gas saver up to 37 MPG, Clean Title, Private Owner, Se habla español…",
      "creation_timestamp": 1695423588,
      "inventory_type": "SINGLE_QUANTITY",
      "condition": "USED",
      "details": {
        "id": "1259043654806502",
        "creation_time": 1695423588,
        "location_vanity_or_id": "108294892526075",
        "is_viewer_seller": false,
        "listing_inventory_type": "SINGLE_QUANTITY",
        "payment_time_period": null,
        "condition": "USED",
        "logging_id": "6653208631441519",
        "marketplace_lead_gen_form": null,
        "listed_by": null,
        "real_estate_listing_agent": null,
        "inventory_count": null,
        "legal_reporting_cta_type": null,
        "legal_reporting_uri": null,
        "messaging_enabled": true,
        "listing_is_rejected": false,
        "seller_message_thread": null,
        "is_checkout_enabled": false,
        "is_draft": false,
        "can_seller_edit": false,
        "origin_group": null,
        "default_variant_listing": null,
        "hidden_from_friends": "VISIBLE_TO_EVERYONE",
        "can_share": true,
        "can_seller_change_availability": false,
        "messagingEnabled": true,
        "has_children": false,
        "active_order": null,
        "rebuy_order_receipt": null,
        "c2c_shipping_eligible": false,
        "is_shipping_offered": false,
        "most_recent_active_order_as_buyer": null,
        "order_summaries": [],
        "should_hide_pdp_shipping_content": true,
        "shipping_profile": null,
        "is_seller_business_onboarded": false,
        "is_buy_now_enabled": false,
        "is_purchase_protected": false,
        "can_buyer_make_checkout_offer": false,
        "is_cart_enabled": false,
        "vacation_mode": null,
        "all_message_threads": {
          "is_empty": true
        },
        "marketplace_listing_category_id": "807311116002614",
        "should_show_txn_survey_on_mas": false,
        "incentive_campaign_for_free_shipping": null,
        "first_message_suggested_value": null,
        "marketplace_bump_info": null,
        "fi_enhanced_appeal_data": {
          "use_fi_appeals": false
        },
        "listing_seller_notices": [],
        "fair_market_value_data": null,
        "vehicle_condition": null,
        "vehicle_exterior_color": "white",
        "vehicle_features": [
          {
            "display_name": "Leather Seats",
            "feature_category": "SEATING",
            "feature_type": "LEATHER"
          },
          {
            "display_name": "Navigation",
            "feature_category": "CONVENIENCE",
            "feature_type": "NAVIGATION"
          },
          {
            "display_name": "Alloy Wheels",
            "feature_category": "EXTERIOR",
            "feature_type": "ALLOY_WHEELS"
          },
          {
            "display_name": "Backup Camera",
            "feature_category": "SAFETY",
            "feature_type": "BACKUP_CAMERA"
          },
          {
            "display_name": "4-Cyl, 1.6 Liter",
            "feature_category": "ENGINE",
            "feature_type": null
          },
          {
            "display_name": "ABS",
            "feature_category": "SAFETY",
            "feature_type": "ABS_BRAKES"
          },
          {
            "display_name": "HD Radio",
            "feature_category": "ENTERTAINMENT",
            "feature_type": "HD_RADIO"
          },
          {
            "display_name": "Stability Control",
            "feature_category": "SAFETY",
            "feature_type": "STABILITY_CONTROL"
          },
          {
            "display_name": "Air Conditioning",
            "feature_category": "CONVENIENCE",
            "feature_type": "AIR_CONDITIONING"
          },
          {
            "display_name": "Alarm",
            "feature_category": "SAFETY",
            "feature_type": "ALARM"
          },
          {
            "display_name": "Auto, 6-Spd SelectShift",
            "feature_category": "TRANSMISSION",
            "feature_type": null
          },
          {
            "display_name": "MP3",
            "feature_category": "ENTERTAINMENT",
            "feature_type": "MP3"
          },
          {
            "display_name": "Cruise Control",
            "feature_category": "CONVENIENCE",
            "feature_type": "CRUISE_CONTROL"
          },
          {
            "display_name": "Dual Air Bags",
            "feature_category": "SAFETY",
            "feature_type": null
          },
          {
            "display_name": "FWD",
            "feature_category": "DRIVETRAIN",
            "feature_type": null
          },
          {
            "display_name": "Fog Lights",
            "feature_category": "EXTERIOR",
            "feature_type": "FOG_LIGHTS"
          },
          {
            "display_name": "Head Curtain Air Bags",
            "feature_category": "SAFETY",
            "feature_type": null
          },
          {
            "display_name": "Heated Seats",
            "feature_category": "SEATING",
            "feature_type": "HEATED_SEATS"
          },
          {
            "display_name": "Hill Start Assist",
            "feature_category": "SAFETY",
            "feature_type": "HILL_START_ASSIST"
          },
          {
            "display_name": "Keyless Entry",
            "feature_category": "CONVENIENCE",
            "feature_type": "KEYLESS_ENTRY"
          },
          {
            "display_name": "Knee Air Bags",
            "feature_category": "SAFETY",
            "feature_type": null
          },
          {
            "display_name": "Park Assist",
            "feature_category": "CONVENIENCE",
            "feature_type": "PARK_ASSIST"
          },
          {
            "display_name": "Power Door Locks",
            "feature_category": "CONVENIENCE",
            "feature_type": "POWER_DOOR_LOCKS"
          },
          {
            "display_name": "Power Steering",
            "feature_category": "CONVENIENCE",
            "feature_type": "POWER_STEERING"
          },
          {
            "display_name": "Power Windows",
            "feature_category": "CONVENIENCE",
            "feature_type": "POWER_WINDOWS"
          },
          {
            "display_name": "Push Button Start",
            "feature_category": null,
            "feature_type": null
          },
          {
            "display_name": "SYNC",
            "feature_category": null,
            "feature_type": null
          },
          {
            "display_name": "Side Air Bags",
            "feature_category": "SAFETY",
            "feature_type": null
          },
          {
            "display_name": "Satellite Radio",
            "feature_category": "ENTERTAINMENT",
            "feature_type": "SATELLITE_RADIO"
          },
          {
            "display_name": "Sony Premium Sound",
            "feature_category": "ENTERTAINMENT",
            "feature_type": null
          },
          {
            "display_name": "Tilt Steering Wheel",
            "feature_category": "CONVENIENCE",
            "feature_type": "TILT_STEERING_WHEEL"
          },
          {
            "display_name": "Traction Control",
            "feature_category": "SAFETY",
            "feature_type": "TRACTION_CONTROL"
          }
        ],
        "vehicle_fuel_type": "GASOLINE",
        "vehicle_identification_number": null,
        "vehicle_interior_color": "black",
        "vehicle_is_paid_off": "IS_PAID_OFF",
        "vehicle_make_display_name": "Ford",
        "vehicle_model_display_name": "Fiesta",
        "vehicle_number_of_owners": "ONE",
        "vehicle_odometer_data": {
          "unit": "MILES",
          "value": 91500
        },
        "vehicle_registration_plate_information": null,
        "vehicle_seller_type": "PRIVATE_SELLER",
        "vehicle_specifications": {
          "co2_emissions": null,
          "engine_size": null,
          "gas_mileage_city": null,
          "gas_mileage_combined": null,
          "gas_mileage_highway": null,
          "horse_power": null,
          "safety_rating_front": {
            "type": "SAFETY_RATINGS_FRONT",
            "units": "",
            "value": "4 Star Rating"
          },
          "safety_rating_overall": {
            "type": "SAFETY_RATINGS_OVERALL",
            "units": "",
            "value": "4 Star Rating"
          },
          "safety_rating_rollover": {
            "type": "SAFETY_RATINGS_ROLLOVER",
            "units": "",
            "value": "4 Star Rating"
          },
          "safety_rating_side": {
            "type": "SAFETY_RATINGS_SIDE",
            "units": "",
            "value": "4 Star Rating"
          },
          "safety_rating_side_barrier": {
            "type": "SAFETY_RATINGS_SIDE_BARRIER",
            "units": "",
            "value": "4 Star Rating"
          }
        },
        "vehicle_title_status": null,
        "vehicle_transmission_type": "AUTOMATIC",
        "vehicle_trim_display_name": "Titanium Sedan 4D",
        "vehicle_carfax_report": null,
        "attribute_data": [],
        "origin_target": {
          "__typename": "Marketplace",
          "id": "1663689853903557"
        },
        "shipping_offered": false,
        "legal_disclosure_impressum_url": null,
        "commerce_badges_info": {
          "source_summary": null,
          "badges": []
        },
        "listing_address": null,
        "vehicle_website_link": null,
        "dealership_name": null,
        "energy_efficiency_class_eu": null,
        "pre_recorded_videos": []
      }
    },
    "media": {
      "pre_recorded_videos": []
    },
    "seller": {
      "id": "100002467417787",
      "name": "Jessica Ivette Martinez",
      "profile_url": "https://www.facebook.com/profile.php?id=100002467417787",
      "joined": 1307220281,
      "is_verified": false,
      "rating": {
        "average": 0,
        "count": 0,
        "private": true
      },
      "is_seller_business_onboarded": false
    },
    "location": {
      "city": "Belleville",
      "state": "NJ",
      "city_displayname": "Belleville, New Jersey",
      "latitude": 40.794982910156,
      "longitude": -74.163208007812
    },
    "origin_group": null,
    "delivery": [
      "IN_PERSON"
    ],
    "is_hidden": false,
    "is_live": true,
    "is_pending": false,
    "is_sold": false
  }
]

Issues & Fixes

Few fields not visible in table or json format and showing undefined as shown below

You can still view all the fields by clicking on All Fields or you can download the data where the fields will be visible.

User profile data isn't visible

With the recent changes in the facebook marketplace, user profile data is no longer available publicaly.