Facebook marketplace scraper

The Facebook Marketplace Scraper extracts data from Facebook Marketplace listings for research, analysis, price monitoring, and deal hunting.

Supported categories: Vehicles, Electronics, Real Estate, Classifieds, and all Marketplace categories.

Key features

• Search or individual listings – Use search URLs (category, location, etc.) or direct listing URLs (e.g. facebook.com/marketplace/item/123456789/)
• Get listing details – Fetch full details, media, and vehicle specs (when applicable)
• Get all listing photos – Optional: skip media to reduce requests by ~33%
• Strict filtering – Exclude broad-match listings (outside location, similar items)
• Scrape Until date – Stop when listings are older than a given date (requires Get listing details + newest-first sort)

Proxy & results

Proxies are managed internally you only need to set proxy country in proxy input field.

⚠️ Important: Search results vary by proxy country and Facebook login state. Set the proxy country to your target marketplace region and generate URLs in an incognito window for accurate results.

Information provided by the scraper

Based on the chosen category, you get more or less detail. For example, here are the fields for Vehicles:

Vehicles listing

🆔 ID	📸 Primary Listing Photo URI	💵 Listing Price
🌐 Location	ℹ️ Condition	#️⃣ Inventory count
📅 Creation Time	🚗 Vehicle Information	🚚 Delivery Types
👤 Seller Information	🚘 Vehicle Features	📊 Vehicle Safety Ratings
📷 Listing Photos	📚 Additional Data	💬 Reviews

Sample data

Here is the sample json output of this actor:

{
	"id": "1384077819184401",
	"primary_listing_photo_url": "https://scontent-mia3-1.xx.fbcdn.net/v/t39.30808-6/395461179_24825490330375167_1179639226609319637_n.jpg?stp=c0.29.261.261a_dst-jpg_p261x260&_nc_cat=106&ccb=1-7&_nc_sid=5f2048&_nc_ohc=8mrP8mk737sAX90b48M&_nc_ht=scontent-mia3-1.xx&oh=00_AfDba_RT2HKFB8ZMAhcKz1wFwccWrGLgXFRFzRpvOXX-ng&oe=654C9FED",
	"listing_price": {
		"formatted_amount": "$3,500",
		"amount_with_offset_in_currency": "350000",
		"amount": "3500.00",
		"amount_with_offset": "350000",
		"currency": "USD"
	},
	"strikethrough_price": null,
	"comparable_price": null,
	"comparable_price_type": null,
	"location": {
		"reverse_geocode": {
		"city": "New York",
		"state": "NY",
		"city_page": {
			"display_name": "New York, New York",
			"id": "108424279189115"
		}
		},
		"latitude": 40.718078613281,
		"longitude": -73.998413085938,
		"reverse_geocode_detailed": {
		"country_alpha_two": "US",
		"postal_code_trimmed": "10013-4741"
		}
	},
	"is_hidden": false,
	"is_live": true,
	"is_pending": false,
	"is_sold": false,
	"is_viewer_seller": false,
	"min_listing_price": null,
	"max_listing_price": null,
	"marketplace_listing_category_id": "807311116002614",
	"marketplace_listing_title": "2013 Nissan Rogue · SV w/SL Pkg Sport Utility 4D",
	"custom_title": "2013 Nissan rogue SV w/SL Pkg Sport Utility 4D",
	"custom_sub_titles_with_rendering_flags": [
		{
		"subtitle": "142K miles"
		}
	],
	"origin_group": null,
	"pre_recorded_videos": [],
	"parent_listing": null,
	"marketplace_listing_seller": {
		"name": "Ray Goberdhan",
		"id": "pfbid02Q55A7QFyyRk9Y2nvxKBXhQ56szFFYSRdN52ZHvusyXZ1SnsR7T9thJ9pmHfDtfFGl",
		"user_id": "pfbid02Q55A7QFyyRk9Y2nvxKBXhQ56szFFYSRdN52ZHvusyXZ1SnsR7T9thJ9pmHfDtfFGl",
		"marketplace_user_profile": {
		"c2c_orders_shipped": null,
		"id": "2993266854024162"
		},
		"profile_picture": {
		"uri": "https://scontent-ord5-2.xx.fbcdn.net/v/t39.30808-1/354458750_23977528571838018_5293173894153871824_n.jpg?stp=cp6_dst-jpg_p74x74&_nc_cat=105&ccb=1-7&_nc_sid=5f2048&_nc_ohc=lBfiDHRZ1w4AX8HEkAo&_nc_ht=scontent-ord5-2.xx&oh=00_AfAeRQG2gK5ohakex9U-aRs9lv_YaHfWr-TZNOZ1iSbBHQ&oe=654D0AAB"
		},
		"profile_picture_160": {
		"uri": "https://scontent-ord5-2.xx.fbcdn.net/v/t39.30808-1/354458750_23977528571838018_5293173894153871824_n.jpg?stp=cp6_dst-jpg_p240x240&_nc_cat=105&ccb=1-7&_nc_sid=5f2048&_nc_ohc=lBfiDHRZ1w4AX8HEkAo&_nc_ht=scontent-ord5-2.xx&oh=00_AfBSoyGfMqikALmtnQDHG92RVo2sXuaL9W-H8w2xgQLwdg&oe=654D0AAB"
		},
		"profile_picture_112": {
		"uri": "https://scontent-ord5-2.xx.fbcdn.net/v/t39.30808-1/354458750_23977528571838018_5293173894153871824_n.jpg?stp=cp6_dst-jpg_p200x200&_nc_cat=105&ccb=1-7&_nc_sid=5f2048&_nc_ohc=lBfiDHRZ1w4AX8HEkAo&_nc_ht=scontent-ord5-2.xx&oh=00_AfBLjJ9_-nsdAPms1CTQICKHh2iiqolKa14hghIUoNIMqQ&oe=654D0AAB"
		},
		"profile_picture_64": {
		"uri": "https://scontent-ord5-2.xx.fbcdn.net/v/t39.30808-1/354458750_23977528571838018_5293173894153871824_n.jpg?stp=cp6_dst-jpg_p100x100&_nc_cat=105&ccb=1-7&_nc_sid=5f2048&_nc_ohc=lBfiDHRZ1w4AX8HEkAo&_nc_ht=scontent-ord5-2.xx&oh=00_AfDsqpmerPGfFKaAte_5KnkIXDz7qk5zNrOmOEBotVF5iw&oe=654D0AAB"
		},
		"profile_picture_60": {
		"uri": "https://scontent-ord5-2.xx.fbcdn.net/v/t39.30808-1/354458750_23977528571838018_5293173894153871824_n.jpg?stp=cp6_dst-jpg_p100x100&_nc_cat=105&ccb=1-7&_nc_sid=5f2048&_nc_ohc=lBfiDHRZ1w4AX8HEkAo&_nc_ht=scontent-ord5-2.xx&oh=00_AfDsqpmerPGfFKaAte_5KnkIXDz7qk5zNrOmOEBotVF5iw&oe=654D0AAB"
		},
		"profile_picture_50": {
		"uri": "https://scontent-ord5-2.xx.fbcdn.net/v/t39.30808-1/354458750_23977528571838018_5293173894153871824_n.jpg?stp=cp6_dst-jpg_p74x74&_nc_cat=105&ccb=1-7&_nc_sid=5f2048&_nc_ohc=lBfiDHRZ1w4AX8HEkAo&_nc_ht=scontent-ord5-2.xx&oh=00_AfAeRQG2gK5ohakex9U-aRs9lv_YaHfWr-TZNOZ1iSbBHQ&oe=654D0AAB"
		},
		"commerce_profile_picture_with_fallback_160": {
		"uri": "https://scontent-ord5-2.xx.fbcdn.net/v/t39.30808-1/354458750_23977528571838018_5293173894153871824_n.jpg?stp=cp6_dst-jpg_p240x240&_nc_cat=105&ccb=1-7&_nc_sid=5f2048&_nc_ohc=lBfiDHRZ1w4AX8HEkAo&_nc_ht=scontent-ord5-2.xx&oh=00_AfBSoyGfMqikALmtnQDHG92RVo2sXuaL9W-H8w2xgQLwdg&oe=654D0AAB"
		},
		"commerce_profile_picture_with_fallback_112": {
		"uri": "https://scontent-ord5-2.xx.fbcdn.net/v/t39.30808-1/354458750_23977528571838018_5293173894153871824_n.jpg?stp=cp6_dst-jpg_p200x200&_nc_cat=105&ccb=1-7&_nc_sid=5f2048&_nc_ohc=lBfiDHRZ1w4AX8HEkAo&_nc_ht=scontent-ord5-2.xx&oh=00_AfBLjJ9_-nsdAPms1CTQICKHh2iiqolKa14hghIUoNIMqQ&oe=654D0AAB"
		},
		"commerce_profile_picture_with_fallback_64": {
		"uri": "https://scontent-ord5-2.xx.fbcdn.net/v/t39.30808-1/354458750_23977528571838018_5293173894153871824_n.jpg?stp=cp6_dst-jpg_p100x100&_nc_cat=105&ccb=1-7&_nc_sid=5f2048&_nc_ohc=lBfiDHRZ1w4AX8HEkAo&_nc_ht=scontent-ord5-2.xx&oh=00_AfDsqpmerPGfFKaAte_5KnkIXDz7qk5zNrOmOEBotVF5iw&oe=654D0AAB"
		},
		"commerce_profile_picture_with_fallback_60": {
		"uri": "https://scontent-ord5-2.xx.fbcdn.net/v/t39.30808-1/354458750_23977528571838018_5293173894153871824_n.jpg?stp=cp6_dst-jpg_p100x100&_nc_cat=105&ccb=1-7&_nc_sid=5f2048&_nc_ohc=lBfiDHRZ1w4AX8HEkAo&_nc_ht=scontent-ord5-2.xx&oh=00_AfDsqpmerPGfFKaAte_5KnkIXDz7qk5zNrOmOEBotVF5iw&oe=654D0AAB"
		},
		"commerce_profile_picture_with_fallback_50": {
		"uri": "https://scontent-ord5-2.xx.fbcdn.net/v/t39.30808-1/354458750_23977528571838018_5293173894153871824_n.jpg?stp=cp6_dst-jpg_p74x74&_nc_cat=105&ccb=1-7&_nc_sid=5f2048&_nc_ohc=lBfiDHRZ1w4AX8HEkAo&_nc_ht=scontent-ord5-2.xx&oh=00_AfAeRQG2gK5ohakex9U-aRs9lv_YaHfWr-TZNOZ1iSbBHQ&oe=654D0AAB"
		},
		"join_time": 1250912804,
		"marketplace_ratings_stats_by_role": {
		"seller_stats": {
			"five_star_ratings_average": 0,
			"five_star_total_rating_count_by_role": 0
		},
		"seller_ratings_are_private": true
		},
		"marketplace_should_display_verified_badge": false
	},
	"delivery_types": [
		"IN_PERSON"
	],
	"story": {
		"translation_available_for_viewer": false,
		"translatability_for_viewer": {
		"source_dialect_name": "English"
		},
		"translated_message_for_viewer": null,
		"id": "UzpfSTEwMDAwMDIyNjI5MDI0OTpWSzoxMzg0MDc3ODE5MTg0NDAx",
		"actors": [
		{
			"name": "Ray Goberdhan",
			"id": "pfbid02Q55A7QFyyRk9Y2nvxKBXhQ56szFFYSRdN52ZHvusyXZ1SnsR7T9thJ9pmHfDtfFGl"
		}
		],
		"url": "https://www.facebook.com/marketplace/item/1384077819184401/",
		"tracking": "{\"photo_id\":\"24825490457041821\",\"story_location\":26,\"story_attachment_style\":\"native_templates\",\"ent_attachement_type\":\"LegacyCommerceAttachment\",\"actrs\":\"100000226290249\",\"ftmd_400706\":\"111112l\"}",
		"save_info": {
		"viewer_save_state": "NOT_SAVED"
		},
		"post_id": "24241793005435397"
	},
	"redacted_description": {
		"text": "Good condition. Was only used for pleasure. Reverse camera, leather seats, AC works perfectly, engine oil was only changed recently and very reliable."
	},
	"creation_time": 1698270232,
	"location_text": {
		"text": "New York, NY"
	},
	"location_vanity_or_id": "nyc",
	"listing_inventory_type": "SINGLE_QUANTITY",
	"formatted_price": {
		"text": "$3,500"
	},
	"payment_time_period": null,
	"condition": "USED",
	"logging_id": "24241793005435397",
	"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,
	"default_variant_listing": null,
	"reportable_ent_id": "24241793005435397",
	"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,
	"product_item": {
		"id": "24241793005435397",
		"viewer_purchase_limit": -1,
		"boosted_marketplace_listing": null,
		"promoted_listing": null
	},
	"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
	},
	"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": "Moon Roof",
		"feature_category": "EXTERIOR",
		"feature_type": "MOON_ROOF"
		},
		{
		"display_name": "Navigation",
		"feature_category": "CONVENIENCE",
		"feature_type": "NAVIGATION"
		},
		{
		"display_name": "Bluetooth",
		"feature_category": "ENTERTAINMENT",
		"feature_type": "BLUETOOTH"
		},
		{
		"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, 2.5 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": "Alarm",
		"feature_category": "SAFETY",
		"feature_type": "ALARM"
		},
		{
		"display_name": "Automatic, CVT",
		"feature_category": "TRANSMISSION",
		"feature_type": null
		},
		{
		"display_name": "Bose Premium Sound",
		"feature_category": "ENTERTAINMENT",
		"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": "F&R Head Curtain Air Bags",
		"feature_category": "SAFETY",
		"feature_type": null
		},
		{
		"display_name": "Fog Lights",
		"feature_category": "EXTERIOR",
		"feature_type": "FOG_LIGHTS"
		},
		{
		"display_name": "HID Headlights",
		"feature_category": "EXTERIOR",
		"feature_type": "HID_HEADLIGHTS"
		},
		{
		"display_name": "Heated Seats",
		"feature_category": "SEATING",
		"feature_type": "HEATED_SEATS"
		},
		{
		"display_name": "Keyless Entry",
		"feature_category": "CONVENIENCE",
		"feature_type": "KEYLESS_ENTRY"
		},
		{
		"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": "Premium Pkg",
		"feature_category": null,
		"feature_type": null
		},
		{
		"display_name": "Rear Spoiler",
		"feature_category": "EXTERIOR",
		"feature_type": "REAR_SPOILER"
		},
		{
		"display_name": "SL Pkg",
		"feature_category": null,
		"feature_type": null
		},
		{
		"display_name": "Side Air Bags",
		"feature_category": "SAFETY",
		"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"
		},
		{
		"display_name": "Stability Control",
		"feature_category": "SAFETY",
		"feature_type": "STABILITY_CONTROL"
		},
		{
		"display_name": "Satellite Radio",
		"feature_category": "ENTERTAINMENT",
		"feature_type": "SATELLITE_RADIO"
		}
	],
	"vehicle_fuel_type": null,
	"vehicle_identification_number": null,
	"vehicle_interior_color": "",
	"vehicle_is_paid_off": null,
	"vehicle_make_display_name": "Nissan",
	"vehicle_model_display_name": "Rogue",
	"vehicle_number_of_owners": null,
	"vehicle_odometer_data": {
		"unit": "MILES",
		"value": 142000
	},
	"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": "5 Star Rating"
		},
		"safety_rating_side_barrier": {
		"type": "SAFETY_RATINGS_SIDE_BARRIER",
		"units": "",
		"value": "5 Star Rating"
		}
	},
	"vehicle_title_status": null,
	"vehicle_transmission_type": "AUTOMATIC",
	"vehicle_trim_display_name": "SV w/SL Pkg Sport Utility 4D",
	"vehicle_carfax_report": null,
	"attribute_data": [],
	"origin_target": {
		"id": "1663689853903557"
	},
	"shipping_offered": false,
	"legal_disclosure_impressum_url": null,
	"commerce_badges_info": {
		"source_summary": null,
		"badges": []
	},
	"listing_address": null,
	"seller_phone_number": null,
	"vehicle_website_link": null,
	"dealership_name": null,
	"seller": {
		"id": "pfbid02Q55A7QFyyRk9Y2nvxKBXhQ56szFFYSRdN52ZHvusyXZ1SnsR7T9thJ9pmHfDtfFGl",
		"marketplace_user_profile": {
		"business_information": null,
		"id": "2993266854024162"
		}
	},
	"energy_efficiency_class_eu": null,
	"listing_photos": [
		{
		"accessibility_caption": "May be an image of 1 person, car, road and street",
		"image": {
			"height": 959,
			"width": 720,
			"uri": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.30808-6/395461179_24825490330375167_1179639226609319637_n.jpg?stp=dst-jpg_p720x720&_nc_cat=106&ccb=1-7&_nc_sid=5f2048&_nc_ohc=8mrP8mk737sAX-5TFKW&_nc_ht=scontent-ord5-1.xx&oh=00_AfAaH5eoaafQ6_sCJB8NNjHPWGMinzaEJj8gcpJZ--7-_w&oe=654C9FED"
		},
		"id": "24825490457041821"
		},
		{
		"accessibility_caption": "May be an image of car and road",
		"image": {
			"height": 959,
			"width": 720,
			"uri": "https://scontent-ord5-2.xx.fbcdn.net/v/t39.30808-6/395623847_24825485130375687_2530795154037914048_n.jpg?stp=dst-jpg_p720x720&_nc_cat=102&ccb=1-7&_nc_sid=5f2048&_nc_ohc=DXUnOg5x4SUAX86OQ8Z&_nc_ht=scontent-ord5-2.xx&oh=00_AfCyg7bOz55ZzLSNlMNZO8hlguo7vxgFzIqIjJfV75sGmA&oe=654BC4F9"
		},
		"id": "24825485150375685"
		},
		{
		"accessibility_caption": "May be an image of car and road",
		"image": {
			"height": 959,
			"width": 720,
			"uri": "https://scontent-ord5-2.xx.fbcdn.net/v/t39.30808-6/394333783_24825485107042356_1605326722481083868_n.jpg?stp=dst-jpg_p720x720&_nc_cat=105&ccb=1-7&_nc_sid=5f2048&_nc_ohc=KGgStJJqGOMAX8Xxpz4&_nc_ht=scontent-ord5-2.xx&oh=00_AfCEwVMPjEZXosK6ZrIwPp6Jj2jEt9azIbdeXgY96Z-Rdw&oe=654C7AE6"
		},
		"id": "24825485143709019"
		},
		{
		"accessibility_caption": "May be an image of text",
		"image": {
			"height": 959,
			"width": 720,
			"uri": "https://scontent-ord5-2.xx.fbcdn.net/v/t39.30808-6/395818923_24825485133709020_2654919834618037708_n.jpg?stp=dst-jpg_p720x720&_nc_cat=102&ccb=1-7&_nc_sid=5f2048&_nc_ohc=YfsAuUB9i5oAX86AAfO&_nc_ht=scontent-ord5-2.xx&oh=00_AfDTlX5seQ2fYHIu2RRVD75SsPiLzv-KhVjT4Al1QwvWrQ&oe=654D2363"
		},
		"id": "24825485163709017"
		},
		{
		"accessibility_caption": "May be an image of text",
		"image": {
			"height": 959,
			"width": 720,
			"uri": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.30808-6/398755397_24883303351260531_635019047324926861_n.jpg?stp=dst-jpg_p720x720&_nc_cat=101&ccb=1-7&_nc_sid=5f2048&_nc_ohc=N4Wb3EH3cIsAX-6Dg2a&_nc_ht=scontent-ord5-1.xx&oh=00_AfCLqWjT6CySi1XSHzwkwQ2wME8FJlThDprm8jsMYygRDQ&oe=654C4E34"
		},
		"id": "24883303364593863"
		}
	]
}

Charging info

Each output item includes an apify_charge_info field indicating which chargeable events were applied (for PPE billing transparency):

Field	Description
listing_item	Base item pushed (always true)
listing_item_details	Details page was fetched (when Get listing details enabled)
seller_details	Seller profile URL was fetched (when Get seller profile URL enabled)

Input options

Option	Type	Default	Description
urls	array	required	Search URLs (e.g. marketplace/nyc/cars) or individual listing URLs (e.g. marketplace/item/3195892660712281/). Open in incognito to verify.
getListingDetails	boolean	false	Visit each listing's details page for full data (description, photos, vehicle specs, etc.).
getAllListingPhotos	boolean	true	When Get listing details is on, fetch listing media. Set to false to skip and reduce requests by ~33%.
strictFiltering	boolean	true	Exclude broad-match listings (outside your location, similar items).
maxPagesPerUrl	integer	—	Max search pages per URL.
untilDate	string	—	Stop when listings are older than this date (YYYY-MM-DD). Requires Get listing details and a URL sorted by newest first (sortBy=creation_time_descend).
proxy	object	—	Set proxy country (e.g. apifyProxyCountry: "US"). Results depend on proxy region.

Quick start

1. Open Facebook Marketplace in an incognito window.
2. Set location, category, or search query and copy the URL—or copy a specific listing URL (e.g. facebook.com/marketplace/item/123456789/).
3. Paste the URL(s) into the actor input. Enable Get listing details for full data.
4. Set Proxy → country to match your target marketplace (e.g. US, IN, UK).
5. Click Start and download results as JSON, CSV, or Excel.

Deal hunting tip: Schedule the actor to run every 5–15 minutes for real-time alerts on new listings. Use untilDate with Get listing details to avoid re-scraping old items.

Performance tips

• Light runs: Use 512 MB memory for listing-only scrapes to reduce cost.
• Faster detail scrapes: Set getAllListingPhotos: false when you don't need listing photos.
• Large scrapes: Use maxPagesPerUrl to control output size and costs.

Integrations

You can use Make to integrate Facebook marketplace scraper to any other SaaS platform by designing your own automation flows.

Facebook marketplace API

The actor stores results in a dataset. You can export data in various formats such as CSV, JSON, XLS, etc. You can scrape and access data on demand using API. For more information, Go to Facebook marketplace scraper API integration page

Is it legal to scrape Facebook marketplace ?

Our scrapers are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our scrapers, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You can also read our blog post on the legality of web scraping

Your feedback

We’re always working on improving the performance of our Actors. So if you’ve got any technical feedback for this scraper or simply found a bug, please create an issue on the actor’s Issues tab in Apify Console

For additional information you can email us at heycuriouscoder@gmail.com