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
• 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 includeSeller option. 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

1. Set Up: Ensure you have an Apify account and access to the Apify platform.
2. Configure Proxy Settings: (Optional) For enhanced reliability, configure proxy settings to bypass Facebook's anti-scraping measures.
3. 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.
4. Adjust Proxy Positioning: You can adjust your geographical location through the proxy configuration to target different regions more effectively.
5. Include Seller Data: If you'd like to extract more detailed data about the seller and item, enable the includeSeller option.
6. Enable Monitoring Mode: If you want to avoid processing duplicate items, enable the monitoringMode option. This will skip items that have already been scraped in previous runs.
7. Run the Scraper: Execute the scraper to start extracting data in your preferred format (JSON, CSV, Excel, etc.).
8. 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"
        }
    ],
    "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 to start scraping from. This is an array of strings, where each string is a Facebook Marketplace URL.
• Include Seller Data (includeSeller): If set to true, the scraper will extract additional data from the item pages, including seller information and more details about the item.
• Monitoring Mode (monitoringMode): If set to true, 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 is 100.
• Min Delay for API Call (minDelay): Minimum delay (in seconds) before the scraper makes an API call for new items. Default is 5.
• Max Delay for API Call (maxDelay): Maximum delay (in seconds) before the scraper makes an API call for new items. Default is 10.
• Max Concurrency (maxConcurrency): Maximum number of pages that can be processed at the same time. Default is 10.
• Min Concurrency (minConcurrency): Minimum number of pages that will be processed at the same time. Default is 1.
• Max Request Retries (maxRequestRetries): Number of retries the scraper will make for failed requests before giving up. Default is 100.
• 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/perth/search?query=cars&radius=805&minPrice=0&maxPrice=99999&sortBy=creation_time_descend&deliveryMethod=all&daysSinceListed=1",
        "listingUrl": "https://www.facebook.com/marketplace/item/1399040977954303",
        "id": "1399040977954303",
        "primary_listing_photo": {
            "__typename": "Photo",
            "id": "3287498094725653",
            "photo_image_url": "https://scontent.fsjj1-1.fna.fbcdn.net/v/t39.30808-6/494926682_3287498108058985_5636516328575753220_n.jpg?stp=c0.169.1536.1536a_dst-jpg_s600x600_tt6&_nc_cat=100&ccb=1-7&_nc_sid=454cf4&_nc_ohc=L5iSCn3QRsEQ7kNvwGnsN9i&_nc_oc=AdnJNBLFU2w1WlEatKQfseJX5fwbaLbW9q3-HAsHnh0wNWdXzQTDx6VhNsYvJgCpqpI&_nc_zt=23&_nc_ht=scontent.fsjj1-1.fna&_nc_gid=02W5IoaZsCGJzCsufYfxzg&oh=00_AfJdtuArB8VPz0Frkqm47SFXIgeCMFbu2F6wF-IXJdC9GA&oe=682400EA"
        },
        "listing_price": {
            "formatted_amount": "A$8,500",
            "amount_with_offset_in_currency": "542194",
            "amount": "8500.00"
        },
        "strikethrough_price": null,
        "comparable_price": null,
        "comparable_price_type": null,
        "location": {
            "reverse_geocode": {
                "city": "Perth",
                "state": "WA",
                "city_page": {
                    "display_name": "Perth, Western Australia",
                    "id": "108252552529332"
                }
            }
        },
        "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": "2007 Toyota Yaris",
        "custom_title": "2007 Toyota yaris",
        "custom_sub_titles_with_rendering_flags": [
            {
                "subtitle": "196K km"
            }
        ],
        "origin_group": null,
        "listing_video": null,
        "parent_listing": null,
        "marketplace_listing_seller": null,
        "delivery_types": [
            "IN_PERSON"
        ]
    }
}

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., "Photo").
  • 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 (e.g., "A$8,500").
  • amount_with_offset_in_currency: The price adjusted for currency offset.
  • amount: The numeric value of the price (e.g., "8500.00").
• strikethrough_price: The original price before any discounts, if applicable. This field is null if no strikethrough price is available.
• comparable_price: A comparable price for the item, if available. This field is null if no comparable price is provided.
• comparable_price_type: The type of comparable price, if applicable. This field is null if 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., "Perth").
    • state: The state where the item is located (e.g., "WA").
    • city_page: Contains additional details about the city:
      • display_name: The full display name of the city (e.g., "Perth, Western Australia").
      • 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 is null if no minimum price is provided.
• max_listing_price: The maximum price for the item, if applicable. This field is null if 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.
• custom_title: A custom title for the item, if provided.
• custom_sub_titles_with_rendering_flags: An array of subtitles with additional details about the item:
  • subtitle: A subtitle providing extra information (e.g., "196K km").
• origin_group: The origin group of the listing, if applicable. This field is null if no origin group is provided.
• listing_video: Details about the listing's video, if available. This field is null if no video is provided.
• parent_listing: The parent listing of the item, if applicable. This field is null if no parent listing is provided.
• marketplace_listing_seller: Information about the seller, if available. This field is null if no seller information is provided.
• delivery_types: An array of delivery methods available for the item (e.g., ["IN_PERSON"]).

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