build.com

Here's a comprehensive documentation to help users easily understand and use your Build.com product scraper actor on Apify.

Build.com Product Scraper Actor Documentation

Overview

The Build.com Product Scraper is designed to extract detailed product information from any sub-category page on Build.com. It collects data such as product IDs, categories, model numbers, titles, URLs, ratings, prices, shipping messages, and more.

How to Use

1. Input Parameters:

   • subCategoryUrl: The URL of the Build.com sub-category page where the product listings are available.
     • Example: https://www.build.com/two-light-bathroom-lighting/c108912

   Example Input:

   {
     "subCategoryUrl": "https://www.build.com/two-light-bathroom-lighting/c108912"
   }
   

2. Output Schema: The scraper will return a JSON array of objects, each representing a product with the following fields:

   • id: Product ID
   • Base Category: Main category of the product
   • Business Category: Specific business category
   • Model Number: Model number of the product
   • Title: Product title
   • URL: Product URL
   • Square Footage Based: Boolean indicating if the product is based on square footage
   • Rating Count: Number of ratings
   • Rating Value: Average rating value
   • Brand Name: Brand name
   • Price current: Current price
   • Price unitPrice: Unit price if applicable
   • Quick Ship: Boolean indicating if quick shipping is available
   • Shipping Message: Shipping message/details
   • Image URL: URL of the product image
   • Image Description: Description of the image
   • Bulb Base: Bulb base type (if applicable)
   • Height: Height of the product
   • Location Rating: Location rating (e.g., Damp Location)
   • Number of Bulbs: Number of bulbs (if applicable)
   • Width: Width of the product

   Example Output:

   [
     {
       "id": 4227109,
       "Base Category": "Lighting",
       "Business Category": "Bathroom Lights",
       "Model Number": "944734",
       "Title": "Mooretown Single Light 8\" Wide Bathroom Sconce",
       "URL": "https://www.build.com/signature-hardware-944734/s1790171?uid=4227109",
       "Square Footage Based": false,
       "Rating Count": 8,
       "Rating Value": 4.75,
       "Brand Name": "Signature Hardware",
       "Price current": 49.99,
       "Price unitPrice": null,
       "Quick Ship": true,
       "Shipping Message": "FREE 2-Day Shipping",
       "Image URL": "https://s3.img-b.com/image/private/t_base,c_pad,f_auto,dpr_auto,w_750,h_750/product/signaturehardware/signature-hardware-440723-3278467.jpg",
       "Image Description": "Signature Hardware",
       "Bulb Base": "Medium (E26)",
       "Height": "8.9",
       "Location Rating": "Damp Location",
       "Number of Bulbs": "1",
       "Width": "7.75"
     }
   ]
   

Usage Instructions

1. Go to your Apify Console and create a new task for the Build.com Product Scraper actor.
2. Provide the sub-category URL you wish to scrape in the subCategoryUrl field.
3. Run the task.
4. Once the task completes, download the results in your preferred format (JSON, CSV, etc.).

Cost and Efficiency

• It is more efficient to run one longer scrape rather than multiple shorter ones due to startup times.
• The cost of running this scraper can be estimated based on the number of items scraped. Refer to the platform pricing page for detailed information.

Additional Notes

• Ensure proxy settings are configured for optimal scraping performance.
• For best results, consider using a subscribed Apify account to access a larger pool of proxies.

This documentation should help users effectively utilize your Build.com product scraper actor.