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.

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. Run the Scraper: Execute the scraper to start extracting data in your preferred format (JSON, CSV, Excel, etc.).
7. 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:

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

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.
• 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:

1{
2    "nodeId": "8957290531006607:IN_MEMORY_MARKETPLACE_FEED_STORY_ENT:MarketplaceFeedStoryBase:503",
3    "id": "965275082178408",
4    "is_live": true,
5    "is_sold": false,
6    "is_pending": false,
7    "title": "Asus chromebook c434T Flip",
8    "seller": null,
9    "price": null,
10    "formatted_price": "DKK1,500",
11    "price_old": {
12        "amount": "",
13        "formatted_amount": ""
14    },
15    "creation_time": 1736101338,
16    "image": "https://scontent.fsjj1-1.fna.fbcdn.net/v/t45.5328-4/472698707_2276534949399820_7645078251739499063_n.jpg?stp=c159.0.960.960a_dst-jpg_p960x960_tt6&_nc_cat=103&ccb=1-7&_nc_sid=b81e62&_nc_ohc=a2r_wBCSxhQQ7kNvgH-ueRq&_nc_oc=AdjbDTxNU45Act-1lnNt0kmX7tSNh-jAU9RnlVlYSEJSLutJmXxviRzYrbV0tc0OUiw&_nc_zt=23&_nc_ht=scontent.fsjj1-1.fna&_nc_gid=AfZmqowj7ujHaP5EFJJ-BR_&oh=00_AYBZsaIDsUWYSyCY_gkjx6ZVe63FxU1kmMf-easX5p4bLw&oe=6795CDF4",
17    "url": "https://www.facebook.com/marketplace/item/965275082178408",
18    "share_uri": "https://www.facebook.com/marketplace/item/965275082178408/",
19    "location": {
20        "reverse_geocode_detailed": {
21            "city": "Vejle",
22            "state": "",
23            "postal_code": "7100"
24        }
25    },
26    "category": "Electronics & computers",
27    "searchedWord": "laptop",
28    "moreDetails": {
29        "location": {
30            "latitude": 55.719909667969,
31            "longitude": 9.5196533203125
32        },
33        "is_shipping_offered": false,
34        "base_marketplace_listing_title": "Asus chromebook c434T Flip",
35        "marketplace_listing_title": "Asus chromebook c434T Flip",
36        "description": "Asus chromebook c434T Flip. Med touchskærm.",
37        "location_text": "Vejle",
38        "listing_inventory_type": "SINGLE_QUANTITY",
39        "listing_price": {
40            "formatted_amount_zeros_stripped": "DKK1,500",
41            "amount_with_offset_in_currency": "20888",
42            "amount": "1500.00",
43            "currency": "DKK"
44        },
45        "strikethrough_price": null,
46        "inventory_count": null,
47        "attribute_data": [
48            {
49                "attribute_name": "Condition",
50                "value": "used_like_new",
51                "label": "Used - like new"
52            }
53        ],
54        "marketplace_listing_seller": null
55    }
56}

---

Output Fields Explanation

• nodeId: Internal identifier for the listing on Facebook Marketplace.
• id: Unique identifier for the specific item.
• is_live: Boolean indicating whether the listing is currently live.
• is_sold: Boolean indicating whether the item has been sold.
• is_pending: Boolean indicating whether the item is pending.
• title: Title of the listed item.
• seller: Information about the seller. If available, this will contain data about the seller; otherwise, it will be null.
• price: Price information for the item. This field can be null if no price is provided.
• formatted_price: The price in a formatted string (e.g., "DKK1,500").
• price_old: Previous price details (if applicable), including amount (numeric) and formatted_amount (string).
• creation_time: Timestamp representing when the listing was created.
• image: URL of the primary image of the item.
• url: URL to the specific item listing on Facebook Marketplace.
• share_uri: A URL that can be used to share the listing.
• location: The location of the item, which includes:
  • reverse_geocode_detailed: An object containing city, state, and postal code details.
• category: The category that the item belongs to, such as "Electronics & computers".
• searchedWord: The keyword or search term used to find the item.
• moreDetails: Contains additional detailed information, including:
  • location: Geographical coordinates (latitude and longitude).
  • is_shipping_offered: Boolean indicating if shipping is offered for the item.
  • description: The description of the item.
  • location_text: The location text, e.g., "Vejle".
  • listing_inventory_type: Type of inventory (e.g., "SINGLE_QUANTITY").
  • listing_price: Contains the price details:
    • formatted_amount_zeros_stripped: The price without any leading zeros (e.g., "DKK1,500").
    • amount_with_offset_in_currency: The price adjusted for currency.
    • amount: Numeric value of the price.
    • currency: The currency of the price (e.g., "DKK").
  • strikethrough_price: If applicable, the previous price before any discounts.
  • inventory_count: The number of items available for sale.
  • attribute_data: A list of attributes related to the item, such as "Condition" or "Brand".
  • marketplace_listing_seller: Information about the seller, if available.

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