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. The scraper is perfect 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 details of items listed on Facebook Marketplace, including prices, descriptions, and locations.

Flexible Input Configuration: Start scraping with any valid Facebook Marketplace URL. 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.

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, as Facebook employs 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. Make sure 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. Run the Scraper: Execute the scraper and obtain the extracted data in your preferred format, such as JSON, CSV, Excel, or others as supported by Apify.
6. Run the Scraper: Execute the scraper and obtain the extracted data in your preferred format, such as JSON, CSV, Excel, or others as supported by Apify.

Input Data

Here's an example of how to set up a search for products on Facebook Marketplace:

1{
2    "startUrls": [
3        {
4            "url": "https://www.facebook.com/marketplace/nyc/search/?query=sleeper%20trucks"
5        }
6    ],
7    "maxItems": 100,
8    "minDelay": 5,
9    "maxDelay": 10,
10    "proxyConfiguration": {
11        "useApifyProxy": true,
12        "apifyProxyGroups": [
13            "RESIDENTIAL"
14        ]
15    }
16}

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 URL.
• 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) to wait before calling the API for new items. Default is 5.
• Max Delay for API Call (maxDelay): Maximum delay (in seconds) to wait before calling the API 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 times the scraper will retry a failed request before giving up. Default is 100.
• Proxy Configuration (proxy): Specifies proxy servers that will be used by the scraper to hide its origin, ensuring greater reliability and anonymity. For more details, see the Proxy configuration.

Output Structure

The output data typically includes:

1{
2  "nodeId": "9020142724683645:IN_MEMORY_MARKETPLACE_FEED_STORY_ENT:MarketplaceFeedStoryBase:503",
3  "id": "962887592547404",
4  "is_live": true,
5  "is_sold": true,
6  "title": "2006 Freightliner 350",
7  "seller": null,
8  "price": {
9    "formatted_amount": "$4,000",
10    "amount_with_offset_in_currency": "400000",
11    "amount": "4000.00"
12  },
13  "price_old": {
14    "amount": "",
15    "formatted_amount": ""
16  },
17  "image": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.30808-6/464633728_1091590595877285_1530082255933910151_n.jpg?stp=c0.135.1284.1284a_dst-jpg_s261x260&_nc_cat=108&ccb=1-7&_nc_sid=454cf4&_nc_ohc=bANM52eFdOQQ7kNvgHwzqZ5&_nc_zt=23&_nc_ht=scontent-iad3-1.xx&_nc_gid=AIh36oTmI_yXmJ3nUY0RQB7&oh=00_AYCQIxTLpJlAwCwRGEgwIzi7eNtHyoFv-v8LIrGasVzbAg&oe=6725C3DA",
18  "url": "https://www.facebook.com/marketplace/item/962887592547404",
19  "location": {
20    "reverse_geocode": {
21      "city": "Secaucus",
22      "state": "NJ",
23      "city_page": {
24        "display_name": "Secaucus, New Jersey",
25        "id": "113214642026789"
26      }
27    }
28  }
29}

Output Fields Explanation

• nodeId: Internal identifier for the listing on Facebook Marketplace.
• id: Unique identifier for the specific item.
• is_live: Boolean indicating if the listing is currently live.
• is_sold: Boolean indicating if the item has been sold.
• title: Title of the listed item.
• seller: Information about the seller (currently null in the sample output).
• price: Object containing details about the price, including formatted_amount (e.g., "$4,000"), amount_with_offset_in_currency, and amount.
• price_old: Object containing information about the old price, if available.
• image: URL of the primary image of the item.
• url: URL to the specific item listing on Facebook Marketplace.
• location: Object containing location details of the item, including city, state, and city_page with display_name and id.

Support

• If you encounter issues or have specific requests for customization, feel free to contact our support team.
• For further customization or to request the entire dataset, email us at [your-email@example.com].
• Visit our documentation for more information on how to get the most out of the Facebook Marketplace Scraper.