{ "openapi": "3.0.1", "info": { "title": "B Corp Directory Scraper", "description": "Scrape the official Certified B Corporation directory (bcorporation.net) - search by keyword or filter by operating country, HQ country, industry, sector, company size, ownership demographics and certification status, or look up specific companies by slug/ID with full impact-score breakdown.", "version": "1.0", "x-build-id": "4aDQ5YN64y4ATqDcc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~bcorp-directory-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-bcorp-directory-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/crawlerbros~bcorp-directory-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-bcorp-directory-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/crawlerbros~bcorp-directory-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-bcorp-directory-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byId" ], "type": "string", "description": "What to fetch: free-text/filtered search of the directory, or a direct lookup of specific companies by slug/ID.", "default": "search" }, "searchQuery": { "title": "Search query (mode=search)", "type": "string", "description": "Free-text keyword query across company name, description, website keywords, industry, sector and location fields. Leave empty to browse/filter without a keyword.", "default": "" }, "companySlugs": { "title": "Company slugs or IDs (mode=byId)", "type": "array", "description": "Company slugs (e.g. `patagonia-inc`) or full bcorporation.net profile URLs. Enriches each company with its website URL, full impact-score breakdown, full-time worker count, year-by-year score history across past recertification cycles, and any additional published documents (disclosure reports, score-methodology/brand-list PDFs, subsidiary FAQs) from the company profile page.", "default": [], "items": { "type": "string" } }, "countries": { "title": "Operating countries (mode=search)", "uniqueItems": true, "type": "array", "description": "Only include companies that operate in at least one of these countries. Leave empty for all countries.", "items": { "type": "string", "enum": [ "Afghanistan", "Albania", "Algeria", "Andorra", "Angola", "Anguilla", "Antigua and Barbuda", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahamas The", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bosnia and Herzegovina", "Botswana", "Brazil", "British Virgin Islands", "Brunei", "Bulgaria", "Burkina Faso", "Burundi", "Cambodia", "Cameroon", "Canada", "Cape Verde", "Carribbean Islands (Other)", "Cayman Islands", "Central African Republic", "Chad", "Chile", "China", "Colombia", "Comoros", "Congo", "Congo The Democratic Republic Of The", "Cook Islands", "Costa Rica", "Cote D'Ivoire (Ivory Coast)", "Croatia (Hrvatska)", "Cuba", "Cyprus", "Czech Republic", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Eritrea", "Estonia", "Ethiopia", "Fiji Islands", "Finland", "France", "French Guiana", "Gabon", "Gambia", "Georgia", "Germany", "Ghana", "Greece", "Grenada", "Guatemala", "Guernsey and Alderney", "Guinea", "Guinea-Bissau", "Guyana", "Haiti", "Honduras", "Hong Kong S.A.R.", "Hungary", "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Israel", "Italy", "Jamaica", "Japan", "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Kosovo", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macau S.A.R.", "Macedonia", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Man (Isle of)", "Marshall Islands", "Mauritania", "Mauritius", "Mexico", "Micronesia", "Moldova", "Monaco", "Mongolia", "Montenegro", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nauru", "Nepal", "Netherlands Antilles", "Netherlands The", "New Zealand", "Nicaragua", "Niger", "Nigeria", "North Korea", "Norway", "Oman", "Pakistan", "Palau", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Poland", "Portugal", "Puerto Rico", "Qatar", "Romania", "Russia", "Rwanda", "Saint Kitts and Nevis", "Saint Lucia", "Saint Vincent and the Grenadines", "Samoa", "San Marino", "Sao Tome and Principe", "Saudi Arabia", "Senegal", "Serbia", "Seychelles", "Sierra Leone", "Singapore", "Slovakia", "Slovenia", "Solomon Islands", "Somalia", "South Africa", "South Korea", "South Sudan", "Spain", "Sri Lanka", "Sudan", "Suriname", "Swaziland", "Sweden", "Switzerland", "Syria", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "Timor-Leste", "Togo", "Tonga", "Trinidad and Tobago", "Tunisia", "Turkey", "Turkmenistan", "Turks And Caicos Islands", "Tuvalu", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "Uruguay", "Uzbekistan", "Vanuatu", "Vatican City State (Holy See)", "Venezuela", "Vietnam", "West Bank and Gaza", "Yemen", "Zambia", "Zimbabwe" ], "enumTitles": [ "Afghanistan", "Albania", "Algeria", "Andorra", "Angola", "Anguilla", "Antigua and Barbuda", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahamas The", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bosnia and Herzegovina", "Botswana", "Brazil", "British Virgin Islands", "Brunei", "Bulgaria", "Burkina Faso", "Burundi", "Cambodia", "Cameroon", "Canada", "Cape Verde", "Carribbean Islands (Other)", "Cayman Islands", "Central African Republic", "Chad", "Chile", "China", "Colombia", "Comoros", "Congo", "Congo The Democratic Republic Of The", "Cook Islands", "Costa Rica", "Cote D'Ivoire (Ivory Coast)", "Croatia (Hrvatska)", "Cuba", "Cyprus", "Czech Republic", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Eritrea", "Estonia", "Ethiopia", "Fiji Islands", "Finland", "France", "French Guiana", "Gabon", "Gambia", "Georgia", "Germany", "Ghana", "Greece", "Grenada", "Guatemala", "Guernsey and Alderney", "Guinea", "Guinea-Bissau", "Guyana", "Haiti", "Honduras", "Hong Kong S.A.R.", "Hungary", "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Israel", "Italy", "Jamaica", "Japan", "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Kosovo", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macau S.A.R.", "Macedonia", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Man (Isle of)", "Marshall Islands", "Mauritania", "Mauritius", "Mexico", "Micronesia", "Moldova", "Monaco", "Mongolia", "Montenegro", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nauru", "Nepal", "Netherlands Antilles", "Netherlands The", "New Zealand", "Nicaragua", "Niger", "Nigeria", "North Korea", "Norway", "Oman", "Pakistan", "Palau", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Poland", "Portugal", "Puerto Rico", "Qatar", "Romania", "Russia", "Rwanda", "Saint Kitts and Nevis", "Saint Lucia", "Saint Vincent and the Grenadines", "Samoa", "San Marino", "Sao Tome and Principe", "Saudi Arabia", "Senegal", "Serbia", "Seychelles", "Sierra Leone", "Singapore", "Slovakia", "Slovenia", "Solomon Islands", "Somalia", "South Africa", "South Korea", "South Sudan", "Spain", "Sri Lanka", "Sudan", "Suriname", "Swaziland", "Sweden", "Switzerland", "Syria", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "Timor-Leste", "Togo", "Tonga", "Trinidad and Tobago", "Tunisia", "Turkey", "Turkmenistan", "Turks And Caicos Islands", "Tuvalu", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "Uruguay", "Uzbekistan", "Vanuatu", "Vatican City State (Holy See)", "Venezuela", "Vietnam", "West Bank and Gaza", "Yemen", "Zambia", "Zimbabwe" ] }, "default": [] }, "hqCountries": { "title": "HQ country (mode=search)", "uniqueItems": true, "type": "array", "description": "Only include companies headquartered in one of these countries. Leave empty for all HQ countries.", "items": { "type": "string", "enum": [ "Algeria", "Argentina", "Australia", "Austria", "Belgium", "Belize", "Bolivia", "Botswana", "Brazil", "Bulgaria", "Burkina Faso", "Cambodia", "Canada", "Chile", "China", "Colombia", "Costa Rica", "Croatia (Hrvatska)", "Czech Republic", "Denmark", "Dominican Republic", "Ecuador", "Egypt", "El Salvador", "Estonia", "Ethiopia", "Finland", "France", "Germany", "Ghana", "Greece", "Guatemala", "Guernsey and Alderney", "Haiti", "Honduras", "Hong Kong S.A.R.", "Hungary", "Iceland", "India", "Indonesia", "Ireland", "Israel", "Italy", "Japan", "Jersey", "Kenya", "Latvia", "Lebanon", "Lithuania", "Luxembourg", "Madagascar", "Malaysia", "Malta", "Mauritius", "Mexico", "Monaco", "Morocco", "Mozambique", "Myanmar", "Namibia", "Netherlands The", "New Zealand", "Nicaragua", "Norway", "Panama", "Paraguay", "Peru", "Philippines", "Poland", "Portugal", "Puerto Rico", "Qatar", "Romania", "Russia", "Rwanda", "Saudi Arabia", "Senegal", "Singapore", "Slovakia", "Slovenia", "South Africa", "South Korea", "Spain", "Sri Lanka", "Sweden", "Switzerland", "Taiwan", "Tanzania", "Thailand", "Tunisia", "Turkey", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "Uruguay", "Vanuatu", "Venezuela", "Vietnam", "Zambia" ], "enumTitles": [ "Algeria", "Argentina", "Australia", "Austria", "Belgium", "Belize", "Bolivia", "Botswana", "Brazil", "Bulgaria", "Burkina Faso", "Cambodia", "Canada", "Chile", "China", "Colombia", "Costa Rica", "Croatia (Hrvatska)", "Czech Republic", "Denmark", "Dominican Republic", "Ecuador", "Egypt", "El Salvador", "Estonia", "Ethiopia", "Finland", "France", "Germany", "Ghana", "Greece", "Guatemala", "Guernsey and Alderney", "Haiti", "Honduras", "Hong Kong S.A.R.", "Hungary", "Iceland", "India", "Indonesia", "Ireland", "Israel", "Italy", "Japan", "Jersey", "Kenya", "Latvia", "Lebanon", "Lithuania", "Luxembourg", "Madagascar", "Malaysia", "Malta", "Mauritius", "Mexico", "Monaco", "Morocco", "Mozambique", "Myanmar", "Namibia", "Netherlands The", "New Zealand", "Nicaragua", "Norway", "Panama", "Paraguay", "Peru", "Philippines", "Poland", "Portugal", "Puerto Rico", "Qatar", "Romania", "Russia", "Rwanda", "Saudi Arabia", "Senegal", "Singapore", "Slovakia", "Slovenia", "South Africa", "South Korea", "Spain", "Sri Lanka", "Sweden", "Switzerland", "Taiwan", "Tanzania", "Thailand", "Tunisia", "Turkey", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "Uruguay", "Vanuatu", "Venezuela", "Vietnam", "Zambia" ] }, "default": [] }, "industries": { "title": "Industry (mode=search)", "uniqueItems": true, "type": "array", "description": "Only include companies in one of these upstream-defined industries. Leave empty for all industries.", "items": { "type": "string", "enum": [ "Accommodation", "Accounting & auditing", "Admin, photocopying & mail services", "Advertising & market research", "Ag raw materials/live animals", "Agicultural support/post-harvest", "Agricultural Processing", "Air transport", "Animal Production", "Apparel", "Architecture design & planning", "Arts & entertainment", "Athletic & fitness centers", "Basic metals", "Basic metals & products", "Beverage serving & bars", "Beverages", "Book publishing", "Books or other media", "Call centers", "Chemicals & chemical products", "Civil engineering", "Cleaning products", "Computer & electronic products", "Computer programming services", "Computers & electronics", "Construction", "Contracting & building", "Data processing & hosting", "Deposit bank - Developed Markets", "Deposit bank - Emerging Markets", "Design & building", "Diagnostic services", "Education & training services", "Educational support", "Electrical equipment", "Employment placement & HR", "Engineering", "Environmental consulting", "Equity investing - Developed Markets", "Equity investing - Emerging Markets", "Event catering & related", "Fabricated metal products", "Facilities & cleaning services", "Film, TV & music production", "Financial markets exchanges", "Financial transaction processing", "Fishing & aquaculture", "Food products", "Forestry & logging", "Funeral & related services", "Furniture", "Games & toys", "General retail via Internet", "General second-hand goods", "General secondary education", "General stores", "Growing non-perennial crops", "Growing perennial crops", "Hairdressing & other beauty services", "Health insurance", "Higher education", "Home health care", "Hospital", "Investment advising", "Jewelry & related articles", "Landscape services", "Laundry & dry-cleaning", "Leather & related products", "Legal activities", "Libraries, museums & culture", "Life insurance", "Machinery & equipment", "Management consultant - for-profits", "Management consultant - nonprofits", "Materials recovery & recycling", "Medical & dental practice", "Medical & dental supplies", "Membership organizations", "Microfinance - Emerging Markets", "Mixed Farming", "Mobile applications", "Mortgage advice & brokerage", "Motorized vehicles", "Non-life insurance", "Non-residential social work", "Other business support", "Other credit - Developed Markets", "Other credit - Emerging Markets", "Other education", "Other financial services", "Other human health", "Other info service activities", "Other install & construction", "Other insurance services", "Other land transport", "Other manufacturing", "Other non-metal minerals", "Other non-metallic minerals", "Other personal services", "Other power generation", "Other professional, scientific & tech", "Other publishing activities", "Other recreation", "Other recycling", "Other renewable energy installation", "Other residential care", "Other retail sale", "Other sports", "Other transport equipment", "Other/general wholesale trade", "Paper & paper products", "Pension/retirement plans", "Personal care products", "Pharmaceutical products", "Photography", "Plant propagation", "Postal & courier activities", "Pre- & primary education", "Printing & recorded media", "Programming & broadcasting", "Publishing - newspapers & magazines", "Real estate - leased property", "Real estate development", "Real estate- fee/contract", "Remediation & other waste management", "Rent/lease: motor vehicles", "Rent/lease: other goods", "Rent/lease: personal & household goods", "Repair: Computer & home goods", "Repair: automotive", "Residential elderly & disabled care", "Residential mental health care", "Residential nursing care", "Restaurants & food service", "Rubber & plastics products", "Scientific R&D", "Securities brokerage", "Security & investigation", "Sewerage", "Social networks & info sharing", "Software publishing and SaaS platforms", "Solar panel installation", "Solar power generation", "Spec design (non-building)", "Sports clubs: prof & amateur", "Sports goods", "Steam & air conditioning", "Technical & vocational educ", "Technology-based support services", "Telecommunications", "Textiles", "Transportation support", "Travel agency & related", "Veterinary activities", "Waste collection", "Waste treatment & disposal", "Water supply & treatment", "Water transport", "Web portals", "Wholesale fee/contract basis", "Wind power generation", "Wood & wood products" ], "enumTitles": [ "Accommodation", "Accounting & auditing", "Admin, photocopying & mail services", "Advertising & market research", "Ag raw materials/live animals", "Agicultural support/post-harvest", "Agricultural Processing", "Air transport", "Animal Production", "Apparel", "Architecture design & planning", "Arts & entertainment", "Athletic & fitness centers", "Basic metals", "Basic metals & products", "Beverage serving & bars", "Beverages", "Book publishing", "Books or other media", "Call centers", "Chemicals & chemical products", "Civil engineering", "Cleaning products", "Computer & electronic products", "Computer programming services", "Computers & electronics", "Construction", "Contracting & building", "Data processing & hosting", "Deposit bank - Developed Markets", "Deposit bank - Emerging Markets", "Design & building", "Diagnostic services", "Education & training services", "Educational support", "Electrical equipment", "Employment placement & HR", "Engineering", "Environmental consulting", "Equity investing - Developed Markets", "Equity investing - Emerging Markets", "Event catering & related", "Fabricated metal products", "Facilities & cleaning services", "Film, TV & music production", "Financial markets exchanges", "Financial transaction processing", "Fishing & aquaculture", "Food products", "Forestry & logging", "Funeral & related services", "Furniture", "Games & toys", "General retail via Internet", "General second-hand goods", "General secondary education", "General stores", "Growing non-perennial crops", "Growing perennial crops", "Hairdressing & other beauty services", "Health insurance", "Higher education", "Home health care", "Hospital", "Investment advising", "Jewelry & related articles", "Landscape services", "Laundry & dry-cleaning", "Leather & related products", "Legal activities", "Libraries, museums & culture", "Life insurance", "Machinery & equipment", "Management consultant - for-profits", "Management consultant - nonprofits", "Materials recovery & recycling", "Medical & dental practice", "Medical & dental supplies", "Membership organizations", "Microfinance - Emerging Markets", "Mixed Farming", "Mobile applications", "Mortgage advice & brokerage", "Motorized vehicles", "Non-life insurance", "Non-residential social work", "Other business support", "Other credit - Developed Markets", "Other credit - Emerging Markets", "Other education", "Other financial services", "Other human health", "Other info service activities", "Other install & construction", "Other insurance services", "Other land transport", "Other manufacturing", "Other non-metal minerals", "Other non-metallic minerals", "Other personal services", "Other power generation", "Other professional, scientific & tech", "Other publishing activities", "Other recreation", "Other recycling", "Other renewable energy installation", "Other residential care", "Other retail sale", "Other sports", "Other transport equipment", "Other/general wholesale trade", "Paper & paper products", "Pension/retirement plans", "Personal care products", "Pharmaceutical products", "Photography", "Plant propagation", "Postal & courier activities", "Pre- & primary education", "Printing & recorded media", "Programming & broadcasting", "Publishing - newspapers & magazines", "Real estate - leased property", "Real estate development", "Real estate- fee/contract", "Remediation & other waste management", "Rent/lease: motor vehicles", "Rent/lease: other goods", "Rent/lease: personal & household goods", "Repair: Computer & home goods", "Repair: automotive", "Residential elderly & disabled care", "Residential mental health care", "Residential nursing care", "Restaurants & food service", "Rubber & plastics products", "Scientific R&D", "Securities brokerage", "Security & investigation", "Sewerage", "Social networks & info sharing", "Software publishing and SaaS platforms", "Solar panel installation", "Solar power generation", "Spec design (non-building)", "Sports clubs: prof & amateur", "Sports goods", "Steam & air conditioning", "Technical & vocational educ", "Technology-based support services", "Telecommunications", "Textiles", "Transportation support", "Travel agency & related", "Veterinary activities", "Waste collection", "Waste treatment & disposal", "Water supply & treatment", "Water transport", "Web portals", "Wholesale fee/contract basis", "Wind power generation", "Wood & wood products" ] }, "default": [] }, "sectors": { "title": "B Corp sector (mode=search)", "uniqueItems": true, "type": "array", "description": "Only include companies in one of these 5 official B Corp sector classifications. Leave empty for all sectors.", "items": { "type": "string", "enum": [ "Manufacturing", "Wholesale/Retail", "Agriculture/Growers", "Service with Minor Environmental Footprint", "Service with Significant Environmental Footprint" ], "enumTitles": [ "Manufacturing", "Wholesale/Retail", "Agriculture/Growers", "Service with Minor Environmental Footprint", "Service with Significant Environmental Footprint" ] }, "default": [] }, "companySizes": { "title": "Company size (mode=search)", "uniqueItems": true, "type": "array", "description": "Only include companies in one of these employee-count buckets. Leave empty for all sizes.", "items": { "type": "string", "enum": [ "0", "1-9", "10-49", "1000+", "250-999", "50-249", "Company without Workers", "Large", "Medium", "Micro", "Small", "X Large", "XX Large" ], "enumTitles": [ "0 employees", "1-9 employees", "10-49 employees", "1000+ employees", "250-999 employees", "50-249 employees", "Company without Workers", "Large (bucketed)", "Medium (bucketed)", "Micro (bucketed)", "Small (bucketed)", "X Large (bucketed)", "XX Large (bucketed)" ] }, "default": [] }, "demographics": { "title": "Ownership / demographic tags (mode=search)", "uniqueItems": true, "type": "array", "description": "Only include companies self-identifying with at least one of these ownership demographics. Leave empty for all companies.", "items": { "type": "string", "enum": [ "blackOwned", "employeeOwned", "familyOwned", "immigrantOwned", "indigenousOwned", "lgbtqOwned", "minorityOwned", "personWithDisabilityOwned", "veteranOwned", "womenOwned" ], "enumTitles": [ "Black-Owned", "Employee-Owned", "Family-Owned", "Immigrant-Owned", "Indigenous-Owned", "LGBTQ+-Owned", "Minority-Owned", "Person-With-Disability-Owned", "Veteran-Owned", "Women-Owned" ] }, "default": [] }, "certifiedAfter": { "title": "Certified on/after (mode=search)", "type": "string", "description": "Only include companies first certified on or after this date (YYYY-MM-DD). Leave empty for no lower bound.", "default": "" }, "certifiedBefore": { "title": "Certified on/before (mode=search)", "type": "string", "description": "Only include companies first certified on or before this date (YYYY-MM-DD). Leave empty for no upper bound.", "default": "" }, "certificationStatus": { "title": "Certification status (mode=search)", "enum": [ "any", "certifiedOnly", "notCertifiedOnly" ], "type": "string", "description": "Filter by whether the company currently holds active B Corp certification. A small number of companies in the directory are decertified or pending.", "default": "any" }, "sortBy": { "title": "Sort order (mode=search)", "enum": [ "newest", "oldest", "nameAsc", "nameDesc", "highestImpact", "lowestImpact", "relevance" ], "type": "string", "description": "Order in which matching companies are emitted. Use `relevance` when `searchQuery` is set, to rank the best keyword matches first instead of by date.", "default": "newest" }, "includeFullDetails": { "title": "Include full company profile details (mode=search)", "type": "boolean", "description": "Fetch each company's profile page for its website URL, full impact-score breakdown (Governance/Workers/Community/Environment/Customers), year-by-year score history across past recertification cycles, and any additional published documents (disclosure reports, score-methodology/brand-list PDFs, subsidiary FAQs). Slower — one extra request per company. Always enabled for mode=byId.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap on the number of company records emitted.", "default": 10 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }