B Corporation Data Scraper

This Apify actor scrapes business data from https://bcorporation.net. You can fetch either a paginated list of certified B Corporations or detailed information for a single company.

Table of Contents

• Input Parameters
• Output Structure
• Usage
• Example

Input Parameters

The input parameters are defined as a JSON object with the following fields:

List Mode

{
    "mode": "index",
    "page": 1,
    "pageSize": 10 // max page Size is 250
}

Single Company Mode

{
    "mode": "company",
    "url": "company-name-slug"  // or full URL to company profile
}

Output Structure

The output structure varies depending on the mode selected:

List Mode Output

interface IndexResponse {
  companies: CompanyListItem[];
}

interface CompanyListItem {
  id: string;
  name: string;
  description: string;
  slug: string;
  industry: string;
  sector: string;
  size: string;
  isCertified: boolean;
  latestVerifiedScore: string;
  initialCertificationDateTimestamp: number;
  companyLogo?: string;
  
  // Location information
  hqCity: string;
  hqCountry: string;
  hqProvince?: string;
  hqPostalCode?: string;
  cities: string[];
  countries: string[];
  provinces: string[];

  // Additional metadata
  demographicsList: string[];
  websiteKeywords?: string;
}

Company Mode Output

interface CompanyDetail {
  id: string;
  name: string;
  slug: string;
  description: string;
  sector: string;
  industry: string;
  size: string;
  website?: string;
  companyLogo?: string;
  lifestyleLogo?: string;
  
  // Demographics
  demographics: {
    womenOwned: boolean;
    minorityOwned: boolean;
    lgbtqOwned: boolean;
    blackOwned: boolean;
    employeeOwned: boolean;
    familyOwned: boolean;
    veteranOwned: boolean;
    indigenousOwned: boolean;
    personWithDisabilityOwned: boolean;
    immigrantOwned: boolean;
  };

  // Location information
  hqCountry: string;
  hqProvince: string;
  hqCity: string;
  hqPostalCode: string;
  countries: string[];
  provinces: string[];
  cities: string[];

  // B Corp specific data
  latestVerifiedScore: number;
  initialCertificationDateTimestamp: number;
  websiteKeywords?: string;
  
  // Assessment details
  assessments: Array<{
    overallScore: number;
    ratingDate: number;
    fullTimeWorkers: number;
    impactAreas: Array<{
      id: number;
      name: string;
      score: number;
      impactTopics: Array<{
        id: number;
        name: string;
        score: number;
        isIbm: boolean;
      }>;
    }>;
  }>;
}

Example Company Response

{
  "id": "example-id-123",
  "name": "Example Sustainable Solutions",
  "description": "A technology company dedicated to sustainable solutions...",
  "sector": "Service with Significant Environmental Footprint",
  "industry": "Technology & Software",
  "size": "50-249",
  "website": "www.example.com",
  "latestVerifiedScore": 95.5,
  "demographics": {
    "womenOwned": false,
    "minorityOwned": false,
    "lgbtqOwned": false,
    "employeeOwned": true
  },
  "hqCity": "Austin",
  "hqCountry": "United States",
  "hqProvince": "Texas",
  "assessments": [
    {
      "overallScore": 95.5,
      "fullTimeWorkers": 75,
      "impactAreas": [
        {
          "name": "Governance",
          "score": 18.2,
          "impactTopics": [
            {
              "name": "Mission & Engagement",
              "score": 4.5,
              "isIbm": false
            }
          ]
        }
      ]
    }
  ]
}

Usage

1. Choose operation mode: Decide whether you want to scrape the company index or a single company profile
2. Configure input: Create a JSON file with your desired input parameters (see Input Parameters section)
3. Run the actor: Execute the Apify actor with your JSON input
4. Process results: Access the structured data from Apify's storage

Example

List Mode Example

{
  "mode": "index",
  "index": {
    "page": 1,
    "pageSize": 25 // max page Size is 250
  }
}

Single Company Example

{
  "mode": "company",
  "company": {
    "url": "smith-limited"
  }
}

Disclaimer

This actor is designed for legitimate data collection from B Lab's public B Corporation directory. Please ensure your usage complies with bcorporation.net's terms of service and robots.txt policies.