Overview

The BBB Scraper or Better Business Bureau Scraper allows you to search for business locations and retrieve detailed business leads based on specific locations and categories.

Input

The actor accepts a JSON object with the following keys:

• locations (required): A single string or an array of strings representing the locations you want to search.
• categories (optional): A single string or an array of strings representing the categories of leads you want.

Usage

Workflow for Getting Leads

Step 1: Retrieve Locations

1. Input: Start by providing only the locations key.
   • Example Input:

     1{
     2  "locations": "New York"
     3}
     

   • Or for multiple locations:

     1{
     2  "locations": ["New York", "Los Angeles"]
     3}
     

2. Output: The actor will return a list of business locations related to the specified location(s).
   • Example Response:

     1{
     2  "locations": [
     3    {
     4      "bbbId": "0121",
     5      "country": "USA",
     6      "cultureId": "en-us",
     7      "displayText": "New York, NY",
     8      "id": "New York_NY_USA",
     9      "latLng": "40.762801,-73.977818"
     10    },
     11    {
     12      "bbbId": "0221",
     13      "country": "USA",
     14      "cultureId": "en-us",
     15      "displayText": "West New York, NJ",
     16      "id": "West New York_NJ_USA",
     17      "latLng": "40.787879,-74.014306"
     18    }
     19  ]
     20}
     

Step 2: Filter the Locations

1. Action: Review the locations returned in the response. Select the relevant locations for your lead search.
   • For example, you may choose "New York, NY" from the previous response.

Step 3: Retrieve Business Leads

1. Input: Use the locations you filtered from Step 2 and provide the categories key with the categories you want leads for.
   • Example Input:

     1{
     2  "locations": ["New York, NY"],
     3  "categories": ["Roofing Contractors"]
     4}
     

   • Or for multiple locations and categories:

     1{
     2  "locations": ["New York, NY", "Los Angeles, CA"],
     3  "categories": ["Roofing Contractors", "Plumbers"]
     4}
     

2. Output: The actor will return a list of business leads related to the specified location(s) and category(ies).
   • Example Response:

     1{
     2    "categories": [
     3        {
     4            "category": "roofing-contractors",
     5            "entityId": "10126-000",
     6            "id": "1362_3100-14100"
     7        },
     8        {
     9            "category": "tile-roofing-contractors",
     10            "entityId": "10126-400",
     11            "id": "1363_3100-14100-100"
     12        }
     13    ],
     14    "data": [
     15        {
     16            "accreditationStatus": null,
     17            "accreditedCharity": false,
     18            "address": "104 W. 41st Street",
     19            "bbbId": "0121",
     20            "bbbMember": false,
     21            "bbbName": "BBB Serving Metropolitan New York",
     22            "businessId": "16491",
     23            "businessLoginUrl": "https://www.bbb.org/new-york-city/login",
     24            "businessName": "GAF Corporation",
     25            "categories": [
     26                {
     27                    "id": "10126-000",
     28                    "name": "Roofing Contractors"
     29                }
     30            ],
     31            "charitySeal": false,
     32            "city": "New York",
     33            "distance": "0.3 mi",
     34            "hasServiceArea": false,
     35            "id": "59647249_15820",
     36            "isCharity": 0,
     37            "leaveReviewUrl": "https://www.bbb.org/us/ny/new-york/profile/roofing-contractors/gaf-corporation-0121-16491/customer-reviews",
     38            "localReportUrl": null,
     39            "location": "40.759,-73.9795",
     40            "logoUri": null,
     41            "outOfBusinessStatus": null,
     42            "phone": null,
     43            "postalcode": "10020",
     44            "raqEnabled": true,
     45            "rating": "NR",
     46            "ratingScore": 0,
     47            "reportUrl": "https://www.bbb.org/us/ny/new-york/profile/roofing-contractors/gaf-corporation-0121-16491",
     48            "requestAQuoteUrl": null,
     49            "requestAQuoteUrlId": 0,
     50            "score": 9348.38,
     51            "serviceArea": null,
     52            "serviceAreaDescription": null,
     53            "serviceAreasSummary": null,
     54            "state": "NY",
     55            "tobId": "10126-000",
     56            "tobText": "Roofing Contractors"
     57        }
     58    ],
     59    "errors": 0,
     60    "locations": [
     61        {
     62            "bbbId": "0121",
     63            "country": "USA",
     64            "cultureId": "en-us",
     65            "displayText": "New York, NY",
     66            "id": "New York_NY_USA",
     67            "latLng": "40.762801,-73.977818"
     68        },
     69        {
     70            "bbbId": "0221",
     71            "country": "USA",
     72            "cultureId": "en-us",
     73            "displayText": "West New York, NJ",
     74            "id": "West New York_NJ_USA",
     75            "latLng": "40.787879,-74.014306"
     76        }
     77    ]
     78}