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 urls, location and radius data.

The scraper accepts urls as input in combination with location(lat/lng) and radius data.

Required:

1. Urls - you can provide in a list of urls.
2. Proxy - must be residential or it may get blocked.
3. Location data - latitude/longitude along with radius of your search query.
4. Max page limit - 0 would mean no limit otherwise enter the max number of pages to scrape.

Input sample

1{
2    "isC2CListingOnly": false,
3    "extendItem": false,  // default: false, when it fetch item details
4    "lat": "40.68",
5    "lng": "-73.87",
6    "local": true,
7    "maxPage": 2,
8    "proxy": {
9        "useApifyProxy": true,
10        "apifyProxyGroups": [
11            "RESIDENTIAL"
12        ],
13        "apifyProxyCountry": "US"
14    },
15    "radius": "10",
16    "searchUrls": [
17        "https://www.facebook.com/marketplace/vehicles"
18    ]
19}

Method 2: creating queries from the dashboard using filters and options.

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

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

1{
2    "category": "vehicles",
3    "isC2CListingOnly": false,
4    "lat": "40.68",
5    "lng": "-73.87",
6    "local": true,
7    "maxPage": 2,
8    "proxy": {
9        "useApifyProxy": true,
10        "apifyProxyGroups": [
11            "RESIDENTIAL"
12        ],
13        "apifyProxyCountry": "US"
14    },
15    "radius": "10",
16}

Get detailed Items data

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

Output sample

1[
2  {
3    "category": "vehicles",
4    "category_id": "807311116002614",
5    "search_area": {
6      "radius": 10,
7      "lat": 40.68,
8      "lng": -73.87
9    },
10    "listing": {
11      "id": "268673524806527",
12      "url": "https://www.facebook.com/marketplace/item/268673524806527/",
13      "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",
14      "title": "2000 Volvo V70 · XC AWD SE Wagon 4D",
15      "custom_title": "2000 Volvo v70 XC AWD SE Wagon 4D",
16      "custom_subtitles": [
17        "128K miles"
18      ],
19      "price": {
20        "formatted_amount": "$2,800",
21        "amount_with_offset_in_currency": "280000"
22      },
23      "max_listing_price": null,
24      "min_listing_price": null,
25      "strikethrough_price": null,
26      "boosted_marketplace_listing": null,
27      "promoted_listing": null,
28      "description": "Volvo v70xc awd se for sale clean low miles hmu for details ",
29      "creation_timestamp": 1629930264,
30      "inventory_type": "SINGLE_QUANTITY",
31      "condition": "USED",
32      "details": {
33        "id": "268673524806527",
34        "creation_time": 1629930264,
35        "location_vanity_or_id": "111806958846634",
36        "is_viewer_seller": false,
37        "listing_inventory_type": "SINGLE_QUANTITY",
38        "payment_time_period": null,
39        "condition": "USED",
40        "logging_id": "4102544856521811",
41        "marketplace_lead_gen_form": null,
42        "listed_by": null,
43        "real_estate_listing_agent": null,
44        "inventory_count": null,
45        "legal_reporting_cta_type": null,
46        "legal_reporting_uri": null,
47        "messaging_enabled": true,
48        "listing_is_rejected": false,
49        "seller_message_thread": null,
50        "is_checkout_enabled": false,
51        "is_draft": false,
52        "can_seller_edit": false,
53        "origin_group": null,
54        "default_variant_listing": null,
55        "hidden_from_friends": null,
56        "can_share": true,
57        "can_seller_change_availability": false,
58        "messagingEnabled": true,
59        "has_children": false,
60        "active_order": null,
61        "rebuy_order_receipt": null,
62        "c2c_shipping_eligible": false,
63        "is_shipping_offered": false,
64        "most_recent_active_order_as_buyer": null,
65        "order_summaries": [],
66        "should_hide_pdp_shipping_content": true,
67        "shipping_profile": null,
68        "is_seller_business_onboarded": false,
69        "is_buy_now_enabled": false,
70        "is_purchase_protected": false,
71        "can_buyer_make_checkout_offer": false,
72        "is_cart_enabled": false,
73        "vacation_mode": null,
74        "all_message_threads": {
75          "is_empty": true
76        },
77        "marketplace_listing_category_id": "807311116002614",
78        "should_show_txn_survey_on_mas": false,
79        "incentive_campaign_for_free_shipping": null,
80        "first_message_suggested_value": null,
81        "marketplace_bump_info": null,
82        "fi_enhanced_appeal_data": {
83          "use_fi_appeals": false
84        },
85        "listing_seller_notices": [],
86        "fair_market_value_data": null,
87        "vehicle_condition": null,
88        "vehicle_exterior_color": "black",
89        "vehicle_features": [
90          {
91            "display_name": "Leather Seats",
92            "feature_category": "SEATING",
93            "feature_type": "LEATHER"
94          },
95          {
96            "display_name": "Moon Roof",
97            "feature_category": "EXTERIOR",
98            "feature_type": "MOON_ROOF"
99          },
100          {
101            "display_name": "Alloy Wheels",
102            "feature_category": "EXTERIOR",
103            "feature_type": "ALLOY_WHEELS"
104          },
105          {
106            "display_name": "5-Cyl, Turbo, 2.4 Liter",
107            "feature_category": "ENGINE",
108            "feature_type": null
109          },
110          {
111            "display_name": "ABS",
112            "feature_category": "SAFETY",
113            "feature_type": "ABS_BRAKES"
114          },
115          {
116            "display_name": "AM/FM Stereo",
117            "feature_category": "ENTERTAINMENT",
118            "feature_type": null
119          },
120          {
121            "display_name": "AWD",
122            "feature_category": "DRIVETRAIN",
123            "feature_type": null
124          },
125          {
126            "display_name": "Air Conditioning",
127            "feature_category": "CONVENIENCE",
128            "feature_type": "AIR_CONDITIONING"
129          },
130          {
131            "display_name": "Automatic",
132            "feature_category": "TRANSMISSION",
133            "feature_type": null
134          },
135          {
136            "display_name": "MP3",
137            "feature_category": "ENTERTAINMENT",
138            "feature_type": "MP3"
139          },
140          {
141            "display_name": "Cassette",
142            "feature_category": null,
143            "feature_type": null
144          },
145          {
146            "display_name": "Cruise Control",
147            "feature_category": "CONVENIENCE",
148            "feature_type": "CRUISE_CONTROL"
149          },
150          {
151            "display_name": "Dual Air Bags",
152            "feature_category": "SAFETY",
153            "feature_type": null
154          },
155          {
156            "display_name": "Power Door Locks",
157            "feature_category": "CONVENIENCE",
158            "feature_type": "POWER_DOOR_LOCKS"
159          },
160          {
161            "display_name": "Power Seats",
162            "feature_category": "SEATING",
163            "feature_type": "POWER_SEATS"
164          },
165          {
166            "display_name": "Power Steering",
167            "feature_category": "CONVENIENCE",
168            "feature_type": "POWER_STEERING"
169          },
170          {
171            "display_name": "Power Windows",
172            "feature_category": "CONVENIENCE",
173            "feature_type": "POWER_WINDOWS"
174          },
175          {
176            "display_name": "Roof Rack",
177            "feature_category": "EXTERIOR",
178            "feature_type": "ROOF_RACK"
179          },
180          {
181            "display_name": "Side Air Bags",
182            "feature_category": "SAFETY",
183            "feature_type": null
184          },
185          {
186            "display_name": "Telescoping Wheel",
187            "feature_category": null,
188            "feature_type": null
189          }
190        ],
191        "vehicle_fuel_type": null,
192        "vehicle_identification_number": null,
193        "vehicle_interior_color": "",
194        "vehicle_is_paid_off": null,
195        "vehicle_make_display_name": "Volvo",
196        "vehicle_model_display_name": "V70",
197        "vehicle_number_of_owners": "ONE",
198        "vehicle_odometer_data": {
199          "unit": "MILES",
200          "value": 128000
201        },
202        "vehicle_registration_plate_information": null,
203        "vehicle_seller_type": "PRIVATE_SELLER",
204        "vehicle_specifications": {
205          "co2_emissions": null,
206          "engine_size": null,
207          "gas_mileage_city": {
208            "type": "GAS_MILEAGE_CITY",
209            "units": "MPG",
210            "value": "16.00"
211          },
212          "gas_mileage_combined": {
213            "type": "GAS_MILEAGE_COMBINED",
214            "units": "MPG",
215            "value": "19.00"
216          },
217          "gas_mileage_highway": {
218            "type": "GAS_MILEAGE_HIGHWAY",
219            "units": "MPG",
220            "value": "23.00"
221          },
222          "horse_power": null,
223          "safety_rating_front": null,
224          "safety_rating_overall": null,
225          "safety_rating_rollover": null,
226          "safety_rating_side": null,
227          "safety_rating_side_barrier": null
228        },
229        "vehicle_title_status": null,
230        "vehicle_transmission_type": "AUTOMATIC",
231        "vehicle_trim_display_name": "XC AWD SE Wagon 4D",
232        "vehicle_carfax_report": null,
233        "attribute_data": [],
234        "origin_target": {
235          "__typename": "Marketplace",
236          "id": "1663689853903557"
237        },
238        "shipping_offered": false,
239        "legal_disclosure_impressum_url": null,
240        "commerce_badges_info": {
241          "source_summary": null,
242          "badges": []
243        },
244        "listing_address": null,
245        "vehicle_website_link": null,
246        "dealership_name": null,
247        "energy_efficiency_class_eu": null,
248        "pre_recorded_videos": []
249      }
250    },
251    "media": {
252      "pre_recorded_videos": []
253    },
254    "seller": {
255      "id": "100006009033120",
256      "name": "Jensen Albanese",
257      "profile_url": "https://www.facebook.com/profile.php?id=100006009033120",
258      "joined": 1369590095,
259      "is_verified": false,
260      "rating": {
261        "average": 0,
262        "count": 0,
263        "private": true
264      },
265      "is_seller_business_onboarded": false
266    },
267    "location": {
268      "city": "Union",
269      "state": "NJ",
270      "city_displayname": "Union Township",
271      "latitude": 40.690612792969,
272      "longitude": -74.295043945312
273    },
274    "origin_group": null,
275    "delivery": [
276      "IN_PERSON"
277    ],
278    "is_hidden": false,
279    "is_live": true,
280    "is_pending": false,
281    "is_sold": false
282  },
283  {
284    "category": "vehicles",
285    "category_id": "807311116002614",
286    "search_area": {
287      "radius": 10,
288      "lat": 40.68,
289      "lng": -73.87
290    },
291    "listing": {
292      "id": "1259043654806502",
293      "url": "https://www.facebook.com/marketplace/item/1259043654806502/",
294      "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",
295      "title": "2018 Ford Fiesta · Titanium Sedan 4D",
296      "custom_title": "2018 Ford fiesta Titanium Sedan 4D",
297      "custom_subtitles": [
298        "91K miles"
299      ],
300      "price": {
301        "formatted_amount": "$7,600",
302        "amount_with_offset_in_currency": "760000"
303      },
304      "max_listing_price": null,
305      "min_listing_price": null,
306      "strikethrough_price": null,
307      "boosted_marketplace_listing": null,
308      "promoted_listing": null,
309      "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…",
310      "creation_timestamp": 1695423588,
311      "inventory_type": "SINGLE_QUANTITY",
312      "condition": "USED",
313      "details": {
314        "id": "1259043654806502",
315        "creation_time": 1695423588,
316        "location_vanity_or_id": "108294892526075",
317        "is_viewer_seller": false,
318        "listing_inventory_type": "SINGLE_QUANTITY",
319        "payment_time_period": null,
320        "condition": "USED",
321        "logging_id": "6653208631441519",
322        "marketplace_lead_gen_form": null,
323        "listed_by": null,
324        "real_estate_listing_agent": null,
325        "inventory_count": null,
326        "legal_reporting_cta_type": null,
327        "legal_reporting_uri": null,
328        "messaging_enabled": true,
329        "listing_is_rejected": false,
330        "seller_message_thread": null,
331        "is_checkout_enabled": false,
332        "is_draft": false,
333        "can_seller_edit": false,
334        "origin_group": null,
335        "default_variant_listing": null,
336        "hidden_from_friends": "VISIBLE_TO_EVERYONE",
337        "can_share": true,
338        "can_seller_change_availability": false,
339        "messagingEnabled": true,
340        "has_children": false,
341        "active_order": null,
342        "rebuy_order_receipt": null,
343        "c2c_shipping_eligible": false,
344        "is_shipping_offered": false,
345        "most_recent_active_order_as_buyer": null,
346        "order_summaries": [],
347        "should_hide_pdp_shipping_content": true,
348        "shipping_profile": null,
349        "is_seller_business_onboarded": false,
350        "is_buy_now_enabled": false,
351        "is_purchase_protected": false,
352        "can_buyer_make_checkout_offer": false,
353        "is_cart_enabled": false,
354        "vacation_mode": null,
355        "all_message_threads": {
356          "is_empty": true
357        },
358        "marketplace_listing_category_id": "807311116002614",
359        "should_show_txn_survey_on_mas": false,
360        "incentive_campaign_for_free_shipping": null,
361        "first_message_suggested_value": null,
362        "marketplace_bump_info": null,
363        "fi_enhanced_appeal_data": {
364          "use_fi_appeals": false
365        },
366        "listing_seller_notices": [],
367        "fair_market_value_data": null,
368        "vehicle_condition": null,
369        "vehicle_exterior_color": "white",
370        "vehicle_features": [
371          {
372            "display_name": "Leather Seats",
373            "feature_category": "SEATING",
374            "feature_type": "LEATHER"
375          },
376          {
377            "display_name": "Navigation",
378            "feature_category": "CONVENIENCE",
379            "feature_type": "NAVIGATION"
380          },
381          {
382            "display_name": "Alloy Wheels",
383            "feature_category": "EXTERIOR",
384            "feature_type": "ALLOY_WHEELS"
385          },
386          {
387            "display_name": "Backup Camera",
388            "feature_category": "SAFETY",
389            "feature_type": "BACKUP_CAMERA"
390          },
391          {
392            "display_name": "4-Cyl, 1.6 Liter",
393            "feature_category": "ENGINE",
394            "feature_type": null
395          },
396          {
397            "display_name": "ABS",
398            "feature_category": "SAFETY",
399            "feature_type": "ABS_BRAKES"
400          },
401          {
402            "display_name": "HD Radio",
403            "feature_category": "ENTERTAINMENT",
404            "feature_type": "HD_RADIO"
405          },
406          {
407            "display_name": "Stability Control",
408            "feature_category": "SAFETY",
409            "feature_type": "STABILITY_CONTROL"
410          },
411          {
412            "display_name": "Air Conditioning",
413            "feature_category": "CONVENIENCE",
414            "feature_type": "AIR_CONDITIONING"
415          },
416          {
417            "display_name": "Alarm",
418            "feature_category": "SAFETY",
419            "feature_type": "ALARM"
420          },
421          {
422            "display_name": "Auto, 6-Spd SelectShift",
423            "feature_category": "TRANSMISSION",
424            "feature_type": null
425          },
426          {
427            "display_name": "MP3",
428            "feature_category": "ENTERTAINMENT",
429            "feature_type": "MP3"
430          },
431          {
432            "display_name": "Cruise Control",
433            "feature_category": "CONVENIENCE",
434            "feature_type": "CRUISE_CONTROL"
435          },
436          {
437            "display_name": "Dual Air Bags",
438            "feature_category": "SAFETY",
439            "feature_type": null
440          },
441          {
442            "display_name": "FWD",
443            "feature_category": "DRIVETRAIN",
444            "feature_type": null
445          },
446          {
447            "display_name": "Fog Lights",
448            "feature_category": "EXTERIOR",
449            "feature_type": "FOG_LIGHTS"
450          },
451          {
452            "display_name": "Head Curtain Air Bags",
453            "feature_category": "SAFETY",
454            "feature_type": null
455          },
456          {
457            "display_name": "Heated Seats",
458            "feature_category": "SEATING",
459            "feature_type": "HEATED_SEATS"
460          },
461          {
462            "display_name": "Hill Start Assist",
463            "feature_category": "SAFETY",
464            "feature_type": "HILL_START_ASSIST"
465          },
466          {
467            "display_name": "Keyless Entry",
468            "feature_category": "CONVENIENCE",
469            "feature_type": "KEYLESS_ENTRY"
470          },
471          {
472            "display_name": "Knee Air Bags",
473            "feature_category": "SAFETY",
474            "feature_type": null
475          },
476          {
477            "display_name": "Park Assist",
478            "feature_category": "CONVENIENCE",
479            "feature_type": "PARK_ASSIST"
480          },
481          {
482            "display_name": "Power Door Locks",
483            "feature_category": "CONVENIENCE",
484            "feature_type": "POWER_DOOR_LOCKS"
485          },
486          {
487            "display_name": "Power Steering",
488            "feature_category": "CONVENIENCE",
489            "feature_type": "POWER_STEERING"
490          },
491          {
492            "display_name": "Power Windows",
493            "feature_category": "CONVENIENCE",
494            "feature_type": "POWER_WINDOWS"
495          },
496          {
497            "display_name": "Push Button Start",
498            "feature_category": null,
499            "feature_type": null
500          },
501          {
502            "display_name": "SYNC",
503            "feature_category": null,
504            "feature_type": null
505          },
506          {
507            "display_name": "Side Air Bags",
508            "feature_category": "SAFETY",
509            "feature_type": null
510          },
511          {
512            "display_name": "Satellite Radio",
513            "feature_category": "ENTERTAINMENT",
514            "feature_type": "SATELLITE_RADIO"
515          },
516          {
517            "display_name": "Sony Premium Sound",
518            "feature_category": "ENTERTAINMENT",
519            "feature_type": null
520          },
521          {
522            "display_name": "Tilt Steering Wheel",
523            "feature_category": "CONVENIENCE",
524            "feature_type": "TILT_STEERING_WHEEL"
525          },
526          {
527            "display_name": "Traction Control",
528            "feature_category": "SAFETY",
529            "feature_type": "TRACTION_CONTROL"
530          }
531        ],
532        "vehicle_fuel_type": "GASOLINE",
533        "vehicle_identification_number": null,
534        "vehicle_interior_color": "black",
535        "vehicle_is_paid_off": "IS_PAID_OFF",
536        "vehicle_make_display_name": "Ford",
537        "vehicle_model_display_name": "Fiesta",
538        "vehicle_number_of_owners": "ONE",
539        "vehicle_odometer_data": {
540          "unit": "MILES",
541          "value": 91500
542        },
543        "vehicle_registration_plate_information": null,
544        "vehicle_seller_type": "PRIVATE_SELLER",
545        "vehicle_specifications": {
546          "co2_emissions": null,
547          "engine_size": null,
548          "gas_mileage_city": null,
549          "gas_mileage_combined": null,
550          "gas_mileage_highway": null,
551          "horse_power": null,
552          "safety_rating_front": {
553            "type": "SAFETY_RATINGS_FRONT",
554            "units": "",
555            "value": "4 Star Rating"
556          },
557          "safety_rating_overall": {
558            "type": "SAFETY_RATINGS_OVERALL",
559            "units": "",
560            "value": "4 Star Rating"
561          },
562          "safety_rating_rollover": {
563            "type": "SAFETY_RATINGS_ROLLOVER",
564            "units": "",
565            "value": "4 Star Rating"
566          },
567          "safety_rating_side": {
568            "type": "SAFETY_RATINGS_SIDE",
569            "units": "",
570            "value": "4 Star Rating"
571          },
572          "safety_rating_side_barrier": {
573            "type": "SAFETY_RATINGS_SIDE_BARRIER",
574            "units": "",
575            "value": "4 Star Rating"
576          }
577        },
578        "vehicle_title_status": null,
579        "vehicle_transmission_type": "AUTOMATIC",
580        "vehicle_trim_display_name": "Titanium Sedan 4D",
581        "vehicle_carfax_report": null,
582        "attribute_data": [],
583        "origin_target": {
584          "__typename": "Marketplace",
585          "id": "1663689853903557"
586        },
587        "shipping_offered": false,
588        "legal_disclosure_impressum_url": null,
589        "commerce_badges_info": {
590          "source_summary": null,
591          "badges": []
592        },
593        "listing_address": null,
594        "vehicle_website_link": null,
595        "dealership_name": null,
596        "energy_efficiency_class_eu": null,
597        "pre_recorded_videos": []
598      }
599    },
600    "media": {
601      "pre_recorded_videos": []
602    },
603    "seller": {
604      "id": "100002467417787",
605      "name": "Jessica Ivette Martinez",
606      "profile_url": "https://www.facebook.com/profile.php?id=100002467417787",
607      "joined": 1307220281,
608      "is_verified": false,
609      "rating": {
610        "average": 0,
611        "count": 0,
612        "private": true
613      },
614      "is_seller_business_onboarded": false
615    },
616    "location": {
617      "city": "Belleville",
618      "state": "NJ",
619      "city_displayname": "Belleville, New Jersey",
620      "latitude": 40.794982910156,
621      "longitude": -74.163208007812
622    },
623    "origin_group": null,
624    "delivery": [
625      "IN_PERSON"
626    ],
627    "is_hidden": false,
628    "is_live": true,
629    "is_pending": false,
630    "is_sold": false
631  }
632]

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.