Facebook Marketplace | Search | Detail Pages | Scraper
Pricing
$18.00/month + usage
Facebook Marketplace | Search | Detail Pages | Scraper
Unlock valuable insights from Facebook Marketplace effortlessly – perfect for market research, price tracking, and competitor analysis, all while staying anonymous.
Pricing
$18.00/month + usage
Rating
5.0
(2)
Developer

Muhamed Didovic
Actor stats
8
Bookmarked
133
Total users
12
Monthly active users
5.3 hours
Issues response
12 hours ago
Last modified
Categories
Share
Facebook Marketplace Scraper
How it works
This actor allows you to scrape product listings from Facebook Marketplace, extracting important details like item name, price, location, seller information, and description. You can also scrape additional data about the seller and the item itself if needed. This tool is ideal for market research, competitor analysis, or collecting information on specific items.
Features
- Multiple Search Queries: Supports scraping based on multiple start URLs. Simply copy and paste the link from Facebook Marketplace, formatted as:
https://www.facebook.com/marketplace/nyc/search/?query=sleeper%20trucks
- Detail Page Scraping: You can also scrape individual item detail pages by providing direct item URLs, for example:
https://www.facebook.com/marketplace/item/3039750046185684/
- Extract Marketplace Listings: Extract detailed information on items listed on Facebook Marketplace, including prices, descriptions, locations, images, and seller details.
- Optional Seller Data: Choose to include additional details about the seller and the item itself by enabling the
includeSelleroption. When enabled, the scraper will visit each item's page to extract more data such as the seller’s contact information, ratings, and more. - Customizable Crawl Settings: Adjust concurrency, request retries, and delays for API calls to optimize scraping performance.
- Proxy Support: Utilize proxy settings to minimize IP bans and ensure continuous scraping.
- Monitoring Mode (Deduplication): Enable this mode to filter out or skip items that have already been scraped in previous runs. This ensures that only new or updated listings are processed, making it ideal for continuous monitoring of Facebook Marketplace.
How to Use
- Set Up: Ensure you have an Apify account and access to the Apify platform.
- Configure Proxy Settings: (Optional) For enhanced reliability, configure proxy settings to bypass Facebook's anti-scraping measures.
- Provide Start URLs: Copy the link of the desired listings from Facebook Marketplace, including any filters you want to apply, and paste it into the scraper. Ensure the URLs point to specific search pages.
- Adjust Proxy Positioning: You can adjust your geographical location through the proxy configuration to target different regions more effectively.
- Include Seller Data: If you'd like to extract more detailed data about the seller and item, enable the
includeSelleroption. - Enable Monitoring Mode: If you want to avoid processing duplicate items, enable the
monitoringModeoption. This will skip items that have already been scraped in previous runs. - Run the Scraper: Execute the scraper to start extracting data in your preferred format (JSON, CSV, Excel, etc.).
- Data Collection: The extracted data will include listings with detailed information that you can use for research or analysis.
Input Data
Here's an example of how to set up a search for products on Facebook Marketplace:
{"startUrls": [{"url": "https://www.facebook.com/marketplace/nyc/search/?query=sleeper%20trucks"},{"url": "https://www.facebook.com/marketplace/item/3039750046185684/"}],"includeSeller": true,"monitoringMode": true,"maxItems": 100,"minDelay": 5,"maxDelay": 10,"proxyConfiguration": {"useApifyProxy": true,"apifyProxyGroups": ["RESIDENTIAL"]}}
Input Options
- Start URLs (
startUrls): URLs of Facebook Marketplace search pages or individual item pages to start scraping from. This is an array of objects, where each object contains aurlproperty with a Facebook Marketplace URL. For example:- Search page:
https://www.facebook.com/marketplace/nyc/search/?query=sleeper%20trucks - Item detail page:
https://www.facebook.com/marketplace/item/3039750046185684/
- Search page:
- Include Seller Data (
includeSeller): If set totrue, the scraper will extract additional data from the item pages, including seller information and more details about the item. - Monitoring Mode (
monitoringMode): If set totrue, the scraper will skip items that have already been scraped in previous runs. This is useful for continuous monitoring of new or updated listings. - Max Items (
maxItems): Maximum number of items that will be scraped per crawl. Default is100. - Min Delay for API Call (
minDelay): Minimum delay (in seconds) before the scraper makes an API call for new items. Default is5. - Max Delay for API Call (
maxDelay): Maximum delay (in seconds) before the scraper makes an API call for new items. Default is10. - Max Concurrency (
maxConcurrency): Maximum number of pages that can be processed at the same time. Default is10. - Min Concurrency (
minConcurrency): Minimum number of pages that will be processed at the same time. Default is1. - Max Request Retries (
maxRequestRetries): Number of retries the scraper will make for failed requests before giving up. Default is100. - Proxy Configuration (
proxy): Specifies the proxy servers to use to avoid IP blocking. Set this for better reliability and anonymity.
Output Structure
The output data includes the following fields for each item listed on Facebook Marketplace:
{"facebookUrl": "https://www.facebook.com/marketplace/sanjosecr/search?query=finca","listingUrl": "https://www.facebook.com/marketplace/item/1181360107153349","id": "1181360107153349","primary_listing_photo": {"__typename": "Photo","id": "1303643114738277","photo_image_url": "https://scontent-eze1-2.xx.fbcdn.net/v/t39.30808-6/546479135_1303643168071605_1587357386926650209_n.jpg?stp=c226.0.581.581a_dst-jpg_s261x260_tt6&_nc_cat=107&ccb=1-7&_nc_sid=454cf4&_nc_ohc=RjfwpMhtSqAQ7kNvwFhSRUa&_nc_oc=AdmC-xz1PhmhYj4mlDgohVTdbolvaljV8owX302d6xpPC1lmX2Va2i2GDn6rCSS9usc&_nc_zt=23&_nc_ht=scontent-eze1-2.xx&_nc_gid=uXxb-WMfF7MkMzdUiJBuVA&oh=00_AfZ_WkpfpkGKIgUxKnQEnxf-_yso4yZsrmJ2ftabxSiGNA&oe=68C81F61"},"listing_price": {"formatted_amount": "CRC1,457,000,000","amount_with_offset_in_currency": "286210312","amount": "1457000000"},"strikethrough_price": null,"comparable_price": null,"comparable_price_type": null,"location": {"reverse_geocode": {"city": "Heredia","state": "CR-H","city_page": {"display_name": "Heredia, Costa Rica","id": "104033792966142"}}},"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": "Finca en puerto viejo sarapiqui del colejio 18km 265ectarias","custom_title": "","custom_sub_titles_with_rendering_flags": [{"subtitle": ""}],"origin_group": null,"listing_video": null,"parent_listing": null,"marketplace_listing_seller": null,"delivery_types": ["IN_PERSON"],"searchedWord": "finca","moreDetails": {"location": {"latitude": 40.278625488281,"longitude": -80.612182617188},"base_marketplace_listing_title": "8 track tapes","marketplace_listing_title": "8 track tapes","redacted_description": "Free","location_text": "Wellsburg, WV","listing_inventory_type": "SINGLE_QUANTITY","listing_price": {"formatted_amount_zeros_stripped": "$0","amount_with_offset_in_currency": "0","amount": "0.00","currency": "USD"},"strikethrough_price": null,"inventory_count": null,"attribute_data": [{"attribute_name": "Condition","value": "used_fair","label": "Used - Fair"}],"marketplace_listing_seller": null,"is_shipping_offered": false,"delivery_types": ["IN_PERSON"],"is_sold": false,"listing_photos": [{"__typename": "CatalogMarketplaceEnhancementTransformedImage","accessibility_caption": "No photo description available.","image": {"height": 960,"width": 722,"uri": "https://scontent-det1-1.xx.fbcdn.net/v/t39.84726-6/584425004_1159129096359359_3214129764484890920_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=100&ccb=1-7&_nc_sid=92e707&_nc_ohc=zre-zppakEEQ7kNvwFsFNS5&_nc_oc=AdkXSPjRf84aP_CxN2nvY2SApoqKugYCDYlkCzhrSf_BfjVDLyVeVrv46pmI8QaIMD4&_nc_zt=14&_nc_ht=scontent-det1-1.xx&_nc_gid=lPvD4wOqzn1YKoEDvshaAw&oh=00_AfjxUsnByfM11kkGlLAnIA7NNq3jRNYNVxTGj2Wqgnh9zA&oe=69237668"},"id": "1159129089692693"}],"creation_time": 1763537117,"marketplace_listing_category": {"slug": "media","id": "613858625416355"},"marketplace_listing_category_name": "Books, Movies & Music","marketplace_listing_category_id": "613858625416355","seo_virtual_category": {"taxonomy_path": [{"name": "Entertainment","seo_info": {"seo_url": "entertainment","id": "3727006157324485"},"id": "529595287638583"}],"id": "529595287638583"},"is_live": true,"is_pending": false,"is_hidden": false,"is_draft": false,"is_viewer_seller": false,"can_seller_change_availability": false,"is_on_marketplace": true,"reportable_seller_type": null,"reportable_ent_id": "25305292905732975","can_seller_edit": false,"can_share": true,"share_uri": "https://www.facebook.com/marketplace/item/1202789441712860/","messaging_enabled": true,"messagingEnabled": true,"seller_message_thread": null,"is_email_communication_enabled": false,"comparable_price": null,"comparable_price_type": null,"formatted_shipping_price": null,"has_free_shipping_discounts": false,"discounts_text": null,"formatted_shipping_price_list_price_only": [],"formattedShippingPriceListWithZipcode": [],"is_multi_variant_listing": false,"variant_group": null,"has_children": false,"cross_post_info": {"all_listings": [{"__typename": "GroupCommerceProductItem","is_on_marketplace": true,"id": "1202789441712860"}]},"marketplace_hashtags": {"nodes": []},"default_variant_listing": null,"is_purchase_protected": false,"is_checkout_enabled": false,"is_buy_now_enabled": false,"can_buyer_make_checkout_offer": false,"c2c_shipping_eligible": false,"is_cart_enabled": false,"shipping_profile": null,"should_hide_pdp_shipping_content": true,"shipping_label_rate_type": null,"estimated_delivery_window": null,"delivery_data": {"carrier": null,"delivery_address": null},"marketplace_reactions": null,"marketplace_pdp_comments": null,"product_item": {"id": "25305292905732975","boosted_marketplace_listing": null,"promoted_listing": null},"marketplace_bump_info": null,"listing_is_rejected": false,"listing_seller_notices": [],"legal_reporting_cta_type": null,"legal_reporting_uri": null,"nfx_story_data": "{\"session_id\":\"043b4959-bda4-479b-a7f5-6e60649b2065\",\"type\":2,\"story_location\":\"marketplace_pdp\",\"entry_point\":\"report_button\",\"reportable_ent_token\":\"25305292905732975\"}","fi_enhanced_appeal_data": {"use_fi_appeals": true,"enforcement_instance_id": null},"legal_disclosure_impressum_url": null,"is_seller_business_onboarded": false,"seller_cms": null,"origin_group": null,"active_order": null,"rebuy_order_receipt": null,"most_recent_active_order_as_buyer": null,"order_summaries": [],"should_show_txn_survey_on_mas": false,"incentive_campaign_for_free_shipping": null,"first_message_suggested_value": null,"vacation_mode": null,"sweepstake_enabled": false,"sweepstake_status": "INVALID","sweepstake_content": null,"hidden_from_friends": "VISIBLE_TO_EVERYONE","all_message_threads": {"is_empty": true},"item_location": {"latitude": 40.278625488281,"longitude": -80.612182617188},"location_vanity_or_id": "103812432991420","search_pivots": null,"if_should_show_recommended_listings": null,"if_should_show_complementary_listings": null,"commerce_badges_info": {"source_summary": null,"badges": []},"vehicle_seller_type": null,"story": null,"if_viewer_is_buyer": {"__typename": "GroupCommerceProductItem","__isMarketplaceListingWithPDPRewrite": "GroupCommerceProductItem","marketplace_pdp_integrity_banner_strings_rewrite": null,"id": "1202789441712860"},"marketplaceListingRenderableIfLoggedOut": {"__typename": "GroupCommerceProductItem","__isMarketplaceListingRenderable": "GroupCommerceProductItem","__isMarketplaceListingWithTaxonomy": "GroupCommerceProductItem","seo_virtual_category": {"taxonomy_path": [{"name": "Entertainment","seo_info": {"seo_url": "entertainment","id": "3727006157324485"},"id": "529595287638583"}],"id": "529595287638583"},"marketplace_listing_category": {"slug": "media","id": "613858625416355"},"marketplace_listing_category_name": "Books, Movies & Music","id": "1202789441712860"},"description": "Free"}}
Output Fields Explanation
-
facebookUrl: The URL of the Facebook Marketplace search page where the item was found. -
listingUrl: The direct URL to the specific item listing on Facebook Marketplace. -
id: The unique identifier for the specific item. -
primary_listing_photo: Contains details about the primary image of the item:__typename: The type of the photo object (e.g., "ProductImage").id: The unique identifier for the photo.photo_image_url: The URL of the primary image of the item.
-
listing_price: Contains details about the item's price:formatted_amount: The price in a formatted string with local currency (e.g., "CRC45,000,000").amount_with_offset_in_currency: The price adjusted for currency offset.amount: The numeric value of the price without formatting (e.g., "45000000").
-
strikethrough_price: The original price before any discounts, if applicable. This field isnullif no strikethrough price is available. -
comparable_price: A comparable price for the item, if available. This field isnullif no comparable price is provided. -
comparable_price_type: The type of comparable price, if applicable. This field isnullif no comparable price type is provided. -
location: Contains details about the item's location:reverse_geocode: Includes geolocation details:city: The city where the item is located (e.g., "Vuelta de Jorco").state: The state/region code where the item is located (e.g., "CR-SJ" for San Jose, Costa Rica).city_page: Contains additional details about the location:display_name: The full display name of the location (e.g., "Vuelta De Jorco, San Jose, Costa Rica").id: The unique identifier for the city page.
-
is_hidden: Boolean indicating whether the listing is hidden. -
is_live: Boolean indicating whether the listing is currently live. -
is_pending: Boolean indicating whether the item is pending. -
is_sold: Boolean indicating whether the item has been sold. -
is_viewer_seller: Boolean indicating whether the viewer is the seller of the item. -
min_listing_price: The minimum price for the item, if applicable. This field isnullif no minimum price is provided. -
max_listing_price: The maximum price for the item, if applicable. This field isnullif no maximum price is provided. -
marketplace_listing_category_id: The category ID of the item on Facebook Marketplace.marketplace_listing_title: The title of the item as listed on Facebook Marketplace (e.g., "Casa y finca").
-
custom_title: A custom title for the item, if provided (e.g., "Casa y finca"). -
custom_sub_titles_with_rendering_flags: An array of subtitles with additional details about the item:subtitle: A subtitle providing extra information (e.g., "Vuelta de Jorco, CR-SJ").
-
origin_group: The origin group of the listing, if applicable. This field isnullif no origin group is provided. -
listing_video: Details about the listing's video, if available. This field isnullif no video is provided. -
parent_listing: The parent listing of the item, if applicable. This field isnullif no parent listing is provided. -
marketplace_listing_seller: Information about the seller, if available. This field isnullif no seller information is provided. -
delivery_types: An array of delivery methods available for the item (e.g.,["IN_PERSON"]). -
searchedWord: The search term used to find this listing (e.g., "finca"). -
moreDetails: Contains additional detailed information about the listing (100+ fields):Basic Information
base_marketplace_listing_title: The base title of the marketplace listing.marketplace_listing_title: The full title displayed on the listing page.description/redacted_description: Full description of the item as provided by the seller.location_text: Formatted location text (e.g., "Wellsburg, WV").location: Precise geographical coordinates withlatitudeandlongitude.item_location: Additional location object withlatitudeandlongitudecoordinates.location_vanity_or_id: Facebook's internal location identifier.
Pricing Information
listing_price: Detailed price object including:formatted_amount_zeros_stripped: Price formatted without trailing zeros (e.g., "$0").amount_with_offset_in_currency: Price with currency offset.amount: The numeric price value (e.g., "0.00").currency: Currency code (e.g., "USD").
strikethrough_price: Original price before discount, if applicable.comparable_price: Market comparison price, if available.comparable_price_type: Type of comparable price reference.formatted_shipping_price: Shipping cost if applicable.has_free_shipping_discounts: Boolean indicating if free shipping is offered.discounts_text: Text describing any active discounts.formatted_shipping_price_list_price_only: Array of shipping price options.formattedShippingPriceListWithZipcode: Shipping prices with zipcode calculations.listing_inventory_type: Type of inventory (e.g., "SINGLE_QUANTITY").inventory_count: Number of items available.
Media Assets
listing_photos: Array of photo objects, each containing:__typename: Type of image object.accessibility_caption: Alt text for accessibility.image: Object withheight,width, anduri(URL) of the image.id: Unique identifier for the photo.
pre_recorded_videos: Array of video objects associated with the listing.primary_listing_photo: Main photo object for the listing.
Category & Taxonomy
marketplace_listing_category: Category object with:slug: URL-friendly category identifier (e.g., "media").id: Unique category ID.
marketplace_listing_category_name: Human-readable category name (e.g., "Books, Movies & Music").marketplace_listing_category_id: Direct category ID reference.seo_virtual_category: SEO-optimized category hierarchy with:taxonomy_path: Array of category levels with names and SEO information.id: Category identifier.
Dates & Timestamps
creation_time: Unix timestamp of when the listing was created (e.g., 1763537117).
Status & Availability
is_live: Boolean indicating if the listing is currently active.is_pending: Boolean indicating if a sale is pending.is_hidden: Boolean indicating if the listing is hidden from public view.is_draft: Boolean indicating if this is a draft listing.is_sold: Boolean indicating if the item has been sold.is_viewer_seller: Boolean indicating if the current viewer is the seller.can_seller_change_availability: Boolean indicating if the seller can modify availability.is_on_marketplace: Boolean indicating if the listing is published on Marketplace.
Seller Information
marketplace_listing_seller: Detailed seller information object (if available).reportable_seller_type: Type of seller for reporting purposes.reportable_ent_id: Entity ID for reporting.can_seller_edit: Boolean indicating if the seller can edit the listing.is_seller_business_onboarded: Boolean indicating if the seller is a verified business.seller_cms: Seller's content management system data.
Sharing & Communication
can_share: Boolean indicating if the listing can be shared.share_uri: Direct URL for sharing the listing.messaging_enabled/messagingEnabled: Boolean indicating if messaging is enabled.seller_message_thread: Existing message thread with the seller, if any.is_email_communication_enabled: Boolean indicating if email communication is available.all_message_threads: Object containing all message threads related to this listing.first_message_suggested_value: Suggested first message to send to the seller.
Delivery & Shipping
is_shipping_offered: Boolean indicating if shipping is available.delivery_types: Array of available delivery methods (e.g., ["IN_PERSON"]).delivery_data: Object containing carrier and delivery address information.shipping_profile: Shipping profile configuration, if applicable.should_hide_pdp_shipping_content: Boolean controlling shipping content visibility.shipping_label_rate_type: Type of shipping label rate.estimated_delivery_window: Expected delivery timeframe, if applicable.
Commerce & Checkout
is_purchase_protected: Boolean indicating if purchase protection is available.is_checkout_enabled: Boolean indicating if online checkout is enabled.is_buy_now_enabled: Boolean indicating if "Buy Now" feature is available.can_buyer_make_checkout_offer: Boolean indicating if buyers can make offers.c2c_shipping_eligible: Boolean indicating customer-to-customer shipping eligibility.is_cart_enabled: Boolean indicating if shopping cart functionality is enabled.
Product Attributes
attribute_data: Array of product attributes, each containing:attribute_name: Name of the attribute (e.g., "Condition").value: Value code (e.g., "used_fair").label: Human-readable label (e.g., "Used - Fair").
Variants & Related Listings
is_multi_variant_listing: Boolean indicating if the product has multiple variants.variant_group: Group information for product variants.has_children: Boolean indicating if this listing has child listings.default_variant_listing: Default variant selection, if applicable.cross_post_info: Information about cross-posted listings, including:all_listings: Array of all related cross-posted listings.
Social Features
marketplace_hashtags: Object containing hashtags associated with the listing:nodes: Array of hashtag objects.
marketplace_reactions: Reactions (likes, etc.) on the listing.marketplace_pdp_comments: Comments on the product detail page.hidden_from_friends: Privacy setting (e.g., "VISIBLE_TO_EVERYONE").
Promotion & Marketing
product_item: Object containing product promotion details:id: Product item identifier.boosted_marketplace_listing: Boosting status and details.promoted_listing: Promotion campaign details.
marketplace_bump_info: Information about listing bump features.incentive_campaign_for_free_shipping: Free shipping campaign details.commerce_badges_info: Commerce badges and certifications:source_summary: Summary of badge sources.badges: Array of badge objects.
Reporting & Compliance
listing_is_rejected: Boolean indicating if the listing was rejected.listing_seller_notices: Array of notices sent to the seller.legal_reporting_cta_type: Type of legal reporting call-to-action.legal_reporting_uri: URI for legal reporting.nfx_story_data: JSON string containing session and reporting metadata.fi_enhanced_appeal_data: Enhanced appeal data for flagged listings:use_fi_appeals: Boolean for appeal availability.enforcement_instance_id: Enforcement instance identifier.
legal_disclosure_impressum_url: Legal disclosure URL, if required.
Orders & Transactions
active_order: Currently active order for this listing, if any.rebuy_order_receipt: Receipt for rebuy orders.most_recent_active_order_as_buyer: Most recent order placed as a buyer.order_summaries: Array of order summary objects.should_show_txn_survey_on_mas: Boolean for transaction survey display.
Special Features
vacation_mode: Seller's vacation mode status.sweepstake_enabled: Boolean indicating if sweepstakes are enabled.sweepstake_status: Status of sweepstakes (e.g., "INVALID").sweepstake_content: Sweepstakes content details.
Search & Recommendations
search_pivots: Related search suggestions.if_should_show_recommended_listings: Boolean for showing recommended items.if_should_show_complementary_listings: Boolean for showing complementary items.
Vehicle-Specific
vehicle_seller_type: Type of vehicle seller (private, dealer, etc.), if applicable.vehicle_odometer_data: Object containing vehicle mileage:unit: Unit of measurement (e.g., "MILES", "KM").value: Odometer reading value.
vehicle_specifications: Object containing technical specifications (e.g., transmission, fuel type).vehicle_identification_number: VIN of the vehicle.vehicle_condition: Condition of the vehicle (e.g., "USED", "NEW").vehicle_fuel_type: Fuel type (e.g., "GASOLINE", "DIESEL").vehicle_transmission_type: Transmission type (e.g., "AUTOMATIC", "MANUAL").vehicle_make_display_name: Make of the vehicle.vehicle_model_display_name: Model of the vehicle.vehicle_trim_display_name: Trim level of the vehicle.vehicle_exterior_color: Exterior color.vehicle_interior_color: Interior color.vehicle_number_of_owners: Number of previous owners.vehicle_title_status: Title status (e.g., "CLEAN", "SALVAGE").vehicle_is_paid_off: Boolean indicating if the vehicle is paid off.vehicle_carfax_report: Link or data related to Carfax report.vehicle_features: List or object of vehicle features.vehicle_registration_plate_information: License plate info (if available).vehicle_website_link: Link to external vehicle website.
Seller & Location Details
listing_address: Detailed address of the listing.dealership_name: Name of the dealership (if applicable).seller_phone_number: Seller's phone number (if available).
Group & Origin
origin_group: The Facebook group where the item originated, if applicable.story: Social story associated with the listing.
Internal Metadata
if_viewer_is_buyer: Object containing buyer-specific metadata.marketplaceListingRenderableIfLoggedOut: Full listing render data for logged-out users, including all taxonomy and category information.
Explore More Scrapers
If you found this Facebook Marketplace Scraper useful, be sure to check out our other powerful scrapers and actors on memo23's Apify profile. We offer a wide range of tools to enhance your web scraping and automation needs across various platforms.
Support
- For issues or feature requests, please use the Issues section of this actor.
- If you need customization or have questions, feel free to contact the author:
- Author's website: https://muhamed-didovic.github.io/
- Email: muhamed.didovic@gmail.com
Additional Services
- Request customization or the full dataset: muhamed.didovic@gmail.com
- For API services of this scraper (no Apify fee, just usage fee for the API), contact: muhamed.didovic@gmail.com
- Email: muhamed.didovic@gmail.com
