# Dun & Bradstreet Scraper (`epctex/dnb-scraper`)

Effortlessly extract valuable company information, financial projections, industry insights, and more from the extensive Dun & Bradstreet commercial database. Dive deep into the D\&B Data Cloud, Business Directory, articles, companies, and industries with customized search terms.

- **URL**: https://beta-securitybyobscurity.apify.com/epctex/dnb-scraper.md
- **Developed by:** [epctex](https://beta-securitybyobscurity.apify.com/epctex) (community)
- **Categories:** News
- **Stats:** 1,935 total users, 22 monthly users, 99.8% runs succeeded, 22 bookmarks
- **User rating**: 2.00 out of 5 stars

## Pricing

$25.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.
You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

# README

### Features

The [official Dun and Bradstreet API](https://directplus.documentation.dnb.com/) enables you to get data, but it also [enforces quotas and rate limiting](https://directplus.documentation.dnb.com/html/pages/UsingDplusAPIs.html). If you need to do more, this unofficial Dun and Bradstreet API will enable you to:

- Scrape companies: extract data on companies listed in the DnB Business Directory by search term
- Scrape articles: extract article content on the DnB website by search term
- Scrape industries: extract industry insights by search term
- Scrape URLs: scrape data from one or more specific URLs

### Why scrape Dun & Bradstreet?

[Dun & Bradstreet](https://www.dnb.com/) has been helping its clients and partners grow through the smart use of data and analytics [for over 200 years](https://www.dnb.com/about-us.html). The company offers a wealth of valuable data and insights.

The Dun & Bradstreet website has a [great section of use cases](https://developer.dnb.com/#/use-cases/All) to explain the benefits of using DnB data, covering areas such as:

- Business due diligence
- Buyer activity notifications
- Buyer and influencer mapping
- Portfolio monitoring
- Segmentation and prospect identification

### Tutorial

The developer of DnB Scraper has created a [detailed step-by-step guide](https://blog.apify.com/dun-bradstreet-scraper-dnb-api/) to help you scrape Dun & Bradstreet.

If you're new to the world of web scraping, you should check out our [Beginner's Guide to Web Scraping](https://apify.com/web-scraping).

To learn more about using Apify, read our [quick start guide](https://docs.apify.com/tutorials/quick-start#run-an-actor) to using any [Apify actor](https://apify.com/actors).

### Tip

DnB has a geo-location-based protection system. That's why you should always use US-based proxies.

### Cost of usage

The DnB Scraper actor is optimized to run very quickly and scrape items efficiently. Depending on various factors, it should scrape 100 companies in 2 minutes!

### Input parameters

The input for the scraper should be in JSON. Possible fields are:

- `search`: (Optional) (String) The keyword that you want to search on Dun & Bradstreet with the selected mode.

- `mode`: (Optional) (String) Mode for the actor. Can be either `COMPANIES`, `ARTICLES` or `INDUSTRIES`. Will work in combination with the `search` parameter.

- `startUrls`: (Optional) (Array) List of DnB URLs. You should provide only company, article, or industry detail URLs.

- `maxItems`: (Optional) (Number) You can limit scraped items. This should be useful when you search through the big lists or search results.

- `country`: (Optional) (String) You can limit the companies by the country filter if that has been provided. Only works on the `search` mode.

- `proxy`: (Required) (Proxy Object) Proxy configuration.

- `extendOutputFunction`: (Optional) (String) Function that takes a JQuery handle ($) as an argument and returns an object with data.

This scraper requires the use of **proxy servers**, either your own proxy servers or <a href="https://www.apify.com/docs/proxy">Apify Proxy</a>.

#### DnB Scraper input example

```json
{
  "search": "apple",
  "maxItems": 21,
  "endPage": 21,
  "mode": "COMPANIES",
  "country": "ca",
  "proxy":{
    "useApifyProxy":true,
    "apifyProxyGroups":["RESIDENTIAL"]
  }
}
```

### During the run

During the run, the actor will output messages letting you know what's going on and which page it's currently scraping.

When items are loaded from the page, you should see a message about this event with a loaded item count.

If you provide incorrect input to the actor, it will immediately stop with a failure state and output an explanation of what went wrong.

### DnB Scraper export

During the run, the actor stores results into an Apify dataset. Each item is a separate item in the dataset.

You can manage the results in any language (Python, PHP, Node.js/NPM). See the FAQ or <a href="https://www.apify.com/docs/api" target="blank">our API reference</a> to learn more about getting results from this Dun & Bradstreet actor.

### Output examples

#### Scraped company result

The structure of each company scraped from DnB looks like this:

```json
{
    "Company Name": "NEXT BYTE PTY LTD",
    "Company Summary": "NEXT BYTE PTY LTD is located in Albion, QUEENSLAND, Australia and is part of the Retail Sector Industry. NEXT BYTE PTY LTD has 1,440 total employees across all of its locations and generates $505.96 million in sales (USD). There are 54 companies in the NEXT BYTE PTY LTD corporate family.\n\nD&B Hoovers provides sales leads and sales intelligence data on over 120 million companies like NEXT BYTE PTY LTD around the world, including contacts, financials, and competitor information. To witness the full depth and breadth of our data and for industry leading sales intelligence tools, take D&B Hoovers for a test drive. Try D&B Hoovers FreeNEXT BYTE PTY LTD is located in Albion, QUEENSLAND, Australia and is part of the Retail Sector Industry. NEXT BYTE PTY LTD has 1,440 total employees across all of its locations and generates $505.96 million in sales (USD). There are 54 companies in the NEXT BYTE PTY LTD corporate family.",
    "Company Type": "Proprietorship",
    "Company Role": "Subsidiary",
    "Website": "http://www.vitagroup.com.au",
    "Location": {
        "Street Address": "Vita Place 77 Hudson Rd",
        "City": "Albion",
        "Region": "QUEENSLAND",
        "Postal Code": "4010",
        "Country": "Australia"
    },
    "Phone": "+61-736246666\n                        \n                                        Call Us\n                                            \n                                            (866) 258-3217",
    "Description": "NEXT BYTE PTY LTD is located in Albion, QUEENSLAND, Australia and is part of the Retail Sector Industry. NEXT BYTE PTY LTD has 1,440 total employees across all of its locations and generates $505.96 million in sales (USD). There are 54 companies in the NEXT BYTE PTY LTD corporate family.",
    "Key Principal": "MAXINE JOAN HORNE",
    "Industry": [
        "Retail Sector",
        "Miscellaneous retail stores, nec",
        "Computer and software stores",
        "Computer related services, nec",
        "Services, nec"
    ],
    "Company Snapshot": {
        "Employees (This Site)": "",
        "Employees (All Sites)": "1,440",
        "Revenue": "505.96",
        "Year Started": "1997",
        "Incorporated": "1997",
        "Fiscal Year End": "JUN",
        "Assets": "",
        "Ticker Symbol": "",
        "Net Income Growth": "",
        "Sales Growth": ""
    },
    "Financial Statements": {
        "Cost Of Revenue": "",
        "Gross Profit": "",
        "Operating Income": "",
        "Income Before Tax": "",
        "Net income": "",
        "Diluted EPS": ""
    },
    "Competitors": [],
    "Principals": [
        {
            "Name": "MAXINE JOAN HORNE",
            "Position": "Director"
        },
        {
            "Name": "GEORGE EDWARD JAMES SOUTHGATE",
            "Position": "Director"
        }
    ],
    "Breadcrumbs": [
        "HOME",
        "BUSINESS DIRECTORY",
        "RETAIL",
        "AUSTRALIA",
        "QUEENSLAND",
        "ALBION"
    ]
}
```

#### Scraped DnB article

The structure of each article scraped from DnB looks like this:

```json
{
    "Url": "https://www.dnb.com/en-us/blog/financial-risk/monthly-us-economic-health-report.html",
    "Title": "Achieve Greater FATCA and CRS Compliance More Efficiently",
    "Date": "May 30, 2017",
    "Related Articles": [
        {
            "Name": "Six Degrees of Separation: Why You Need to Be Smarter with Data",
            "Link": "/perspectives/corporate-compliance/data-connectivity-relationships.html"
        },
        {
            "Name": "A Record Year for FCPA Fines",
            "Link": "/perspectives/corporate-compliance/2020-record-year-fcpa-settlement-amounts.html"
        },
        {
            "Name": "Beneficial Ownership",
            "Link": "/products/corporate-compliance/beneficial-ownership.html"
        },
        {
            "Name": "Direct for Compliance",
            "Link": "/products/corporate-compliance/direct-for-compliance.html"
        },
        {
            "Name": "D&B Compass",
            "Link": "/products/corporate-compliance/dnb-compass.html"
        },
        {
            "Name": "D&B Onboard",
            "Link": "/products/corporate-compliance/dnb-onboard.html"
        },
        {
            "Name": "",
            "Link": "/products.html"
        }
    ],
    "Cover Image": "https://www.dnb.com/content/dam/english/image-library/Modernization/workspaces/FACTA-and-crs-compliance.jpg",
    "Body": "\n\n                            <p>Foreign Account Tax Compliance Act (FATCA) 2016 deadlines may have passed, but financial institutions (FIs) can achieve Common Reporting Standards (CRS) and FATCA compliance more easily in 2017 using data and technology, as well as lessons learned from 2016.<b></b></p>\n<h2>Pre-existing Account Review Process Is People-Intensive</h2>\n<p>FIs were expected to review their pre-existing accounts (a financial account opened prior to July 1, 2014) to document their account holders' FATCA status during 2016. Once the accounts' FATCA statuses are established, FIs would monitor the accounts for any change in circumstances. Many organizations went to great expense and effort to meet this goal with varying results.&nbsp;</p>\n<p></p>"
}
```

#### Scraped DnB industry result

The structure of each industry scraped from DnB looks like this:

```json
{
    "url": "https://www.dnb.com/business-directory/industry-analysis.commercial_and_industrial_machinery_and_equipment_rental_and_leasing.html",
    "type": "Industry",
    "title": "Commercial and Industrial Machinery and Equipment Rental and Leasing IndustryInsights from D&B Hoovers\n                        Industry Analysis\n                                            Geographic Segmentation",
    "Description": "This industry group comprises establishments primarily engaged in renting or leasing commercial-type and industrial-type machinery and equipment.  Establishments included in this industry group are generally involved in providing capital or investment-type equipment that clients use in their business operations.  These establishments typically cater to a business clientele and do not generally operate a retail-like or storefront facility.",
    "Industry Activities": "Aircraft rental or leasing without operator\n                                \n                                            Airplane rental or leasing without operator\n                                \n                                            Barge rental or leasing without crew\n                                \n                                            Boat rental (except pleasure) without crew\n                                \n                                            Boat rental or leasing, commercial\n                                \n                                            Railroad car rental or leasing\n                                \n                                            Ship rental or leasing without crew\n                                \n                                            Steamship rental or leasing without crew\n                                \n                                            Tanker (boat) rental or leasing without crew\n                                \n                                            Towboat rental or leasing without crew\n                                \n                                            Tugboat rental or leasing without crew\n                                \n                                            Bulldozer rental or leasing without operator\n                                \n                                            Construction form rental\n                                \n                                            Construction machinery and equipment rental or leasing without operator\n                                \n                                            Crane rental or leasing without operator\n                                \n                                            Earthmoving equipment rental or leasing without operator\n                                \n                                            Forestry machinery and equipment rental or leasing\n                                \n                                            Heavy construction equipment rental without operator\n                                \n                                            Logging equipment rental or leasing without operator\n                                \n                                            Mining machinery and equipment rental or leasing\n                                \n                                            Oil field machinery and equipment rental or leasing\n                                \n                                            Oil well drilling machinery and equipment rental or leasing\n                                \n                                            Welding equipment rental or leasing\n                                \n                                            Well drilling machinery and equipment rental or leasing\n                                \n                                            Cash register rental or leasing\n                                \n                                            Computer peripheral equipment rental or leasing\n                                \n                                            Computer rental or leasing\n                                \n                                            Copier rental or leasing\n                                \n                                            Duplicating machine (e.g., copier) rental or leasing\n                                \n                                            Facsimile machine rental or leasing\n                                \n                                            Fax machine rental or leasing\n                                \n                                            Furniture, office, rental or leasing\n                                \n                                            Mailing equipment rental or leasing\n                                \n                                            Office furniture rental or leasing\n                                \n                                            Office machinery and equipment rental or leasing\n                                \n                                            Agricultural machinery and equipment rental or leasing\n                                \n                                            Audio visual equipment rental or leasing\n                                \n                                            Carpentry equipment rental or leasing\n                                \n                                            Carpet and rug cleaning equipment rental or leasing\n                                \n                                            Compressor, air and gas, rental or leasing\n                                \n                                            Farm equipment rental or leasing\n                                \n                                            Farm tractor rental or leasing\n                                \n                                            Floor sanding machine rental or leasing\n                                \n                                            Floor waxing equipment rental or leasing\n                                \n                                            Furniture, institutional (i.e. public building), rental or leasing\n                                \n                                            Garden tractor rental or leasing\n                                \n                                            Generator rental or leasing\n                                \n                                            Industrial truck rental or leasing\n                                \n                                            Lawnmower rental or leasing\n                                \n                                            Manufacturing machinery and equipment rental or leasing\n                                \n                                            Material handling machinery and equipment rental or leasing\n                                \n                                            Medical equipment (except home health furniture and equipment) rental or leasing\n                                \n                                            Metalworking machinery and equipment rental or leasing\n                                \n                                            Mobile office building rental or leasing, off-site\n                                \n                                            Modular building rental or leasing, off-site\n                                \n                                            Motion picture equipment rental or leasing\n                                \n                                            Pallet rental or leasing\n                                \n                                            Plumbing equipment rental or leasing\n                                \n                                            Power washer rental or leasing\n                                \n                                            Public address system rental or leasing\n                                \n                                            Renting coin- or card-operated amusement devices (except concession operators)\n                                \n                                            Sawmill machinery rental or leasing\n                                \n                                            Scaffolding rental or leasing\n                                \n                                            Scenery, theatrical, rental or leasing\n                                \n                                            Skid rental or leasing\n                                \n                                            Sound and lighting equipment rental or leasing\n                                \n                                            Telecommunications equipment rental or leasing\n                                \n                                            Textile machinery rental or leasing\n                                \n                                            Theatrical equipment (except costumes) rental or leasing\n                                \n                                            Tractor, farm, rental or leasing\n                                \n                                            Tractor, garden, rental or leasing\n                                \n                                            Traffic control equipment (e.g., barricades, cones, traffic signs) rental or leasing\n                                \n                                            Truck, industrial, rental or leasing\n                                \n                                            TV broadcasting and studio equipment rental or leasing\n                                \n                                            Vending machine rental\n                                \n                                            Woodworking machinery and equipment rental or leasing\n                                \n                                            View 76 industry activities"
}
```

### Bugs, fixes, updates, and changelog

This scraper is under active development. If you have any feature requests you can create an issue from [here](https://github.com/epctex-support/dnb-scraper/issues).

### Contact

Please visit us through [epctex.com](https://epctex.com) to see all the products that are available for you. If you are looking for any custom integration or so, please reach out to us through the chat box in [epctex.com](https://epctex.com). In need of support? <business@epctex.com> is at your service.

# Actor input Schema

## `startUrls` (type: `array`):

URLs to start with

## `maxItems` (type: `integer`):

Maximum number of items that you want as output. Default is all

## `mode` (type: `string`):

Select the mode that you want to initiate the actor

## `search` (type: `string`):

The keyword that you want to search on. Eg: 'Medical'

## `country` (type: `string`):

The country that you want to filter companies by. Eg: 'United States'

## `extendOutputFunction` (type: `string`):

A function which result will get merged with the default result

## `proxy` (type: `object`):

Select proxies to be used by your crawler.

## Actor input object example

```json
{
  "startUrls": [
    "https://www.dnb.com/business-directory/industry-analysis.commercial_and_industrial_machinery_and_equipment_rental_and_leasing.html",
    "https://www.dnb.com/en-us/blog/financial-risk/monthly-us-economic-health-report.html",
    "https://www.dnb.com/business-directory/company-profiles.alibaba_(china)_technology_co_ltd.e3529c2476c569b9912000545d3314d6.html"
  ],
  "maxItems": 50,
  "mode": "COMPANIES",
  "country": "all",
  "extendOutputFunction": "($) => {\n    const result = {};\n    // Uncomment to add a title to the output\n    // result.title = $('title').text().trim();\n\n    return result;\n}",
  "proxy": {
    "useApifyProxy": true
  }
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        "https://www.dnb.com/business-directory/industry-analysis.commercial_and_industrial_machinery_and_equipment_rental_and_leasing.html",
        "https://www.dnb.com/en-us/blog/financial-risk/monthly-us-economic-health-report.html",
        "https://www.dnb.com/business-directory/company-profiles.alibaba_(china)_technology_co_ltd.e3529c2476c569b9912000545d3314d6.html"
    ],
    "maxItems": 50,
    "extendOutputFunction": ($) => {
        const result = {};
        // Uncomment to add a title to the output
        // result.title = $('title').text().trim();
    
        return result;
    },
    "proxy": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("epctex/dnb-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrls": [
        "https://www.dnb.com/business-directory/industry-analysis.commercial_and_industrial_machinery_and_equipment_rental_and_leasing.html",
        "https://www.dnb.com/en-us/blog/financial-risk/monthly-us-economic-health-report.html",
        "https://www.dnb.com/business-directory/company-profiles.alibaba_(china)_technology_co_ltd.e3529c2476c569b9912000545d3314d6.html",
    ],
    "maxItems": 50,
    "extendOutputFunction": """($) => {
    const result = {};
    // Uncomment to add a title to the output
    // result.title = $('title').text().trim();

    return result;
}""",
    "proxy": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("epctex/dnb-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    "https://www.dnb.com/business-directory/industry-analysis.commercial_and_industrial_machinery_and_equipment_rental_and_leasing.html",
    "https://www.dnb.com/en-us/blog/financial-risk/monthly-us-economic-health-report.html",
    "https://www.dnb.com/business-directory/company-profiles.alibaba_(china)_technology_co_ltd.e3529c2476c569b9912000545d3314d6.html"
  ],
  "maxItems": 50,
  "extendOutputFunction": "($) => {\\n    const result = {};\\n    // Uncomment to add a title to the output\\n    // result.title = $('\''title'\'').text().trim();\\n\\n    return result;\\n}",
  "proxy": {
    "useApifyProxy": true
  }
}' |
apify call epctex/dnb-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=epctex/dnb-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Dun & Bradstreet Scraper",
        "description": "Effortlessly extract valuable company information, financial projections, industry insights, and more from the extensive Dun & Bradstreet commercial database. Dive deep into the D&B Data Cloud, Business Directory, articles, companies, and industries with customized search terms.",
        "version": "0.0",
        "x-build-id": "k68s6ulhqhxAvOfLr"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/epctex~dnb-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-epctex-dnb-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/epctex~dnb-scraper/runs": {
            "post": {
                "operationId": "runs-sync-epctex-dnb-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/epctex~dnb-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-epctex-dnb-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": [
                    "proxy"
                ],
                "properties": {
                    "startUrls": {
                        "title": "Start URLs",
                        "type": "array",
                        "description": "URLs to start with",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxItems": {
                        "title": "Maximum number of items",
                        "type": "integer",
                        "description": "Maximum number of items that you want as output. Default is all"
                    },
                    "mode": {
                        "title": "Mode",
                        "enum": [
                            "COMPANIES",
                            "ARTICLES"
                        ],
                        "type": "string",
                        "description": "Select the mode that you want to initiate the actor",
                        "default": "COMPANIES"
                    },
                    "search": {
                        "title": "Search",
                        "type": "string",
                        "description": "The keyword that you want to search on. Eg: 'Medical'"
                    },
                    "country": {
                        "title": "Country",
                        "enum": [
                            "all",
                            "us",
                            "in",
                            "cn",
                            "gb",
                            "jp",
                            "br",
                            "au",
                            "kr",
                            "ca",
                            "za",
                            "hk",
                            "kz",
                            "my",
                            "it",
                            "ae",
                            "fr",
                            "vn",
                            "nl",
                            "th",
                            "pl",
                            "es",
                            "nz",
                            "tw",
                            "sg",
                            "ph",
                            "de",
                            "ng",
                            "ro",
                            "sa",
                            "uz",
                            "il",
                            "jm",
                            "ie",
                            "ke",
                            "ec",
                            "co",
                            "eg",
                            "cz",
                            "be",
                            "bg",
                            "pe",
                            "mx",
                            "cl",
                            "id",
                            "se",
                            "rs",
                            "bh",
                            "bs",
                            "fi",
                            "hu",
                            "ma",
                            "ch",
                            "cy",
                            "gr",
                            "tz",
                            "ru",
                            "sk",
                            "pt",
                            "ua",
                            "lb",
                            "bb",
                            "dk",
                            "no",
                            "tr",
                            "pk",
                            "do",
                            "om",
                            "pa",
                            "kw",
                            "bw",
                            "mu",
                            "cr",
                            "af",
                            "ag",
                            "me",
                            "qa",
                            "at",
                            "gh",
                            "hr",
                            "lv",
                            "md",
                            "mt",
                            "bz",
                            "dz",
                            "ar",
                            "dm",
                            "bo",
                            "lt",
                            "tn",
                            "ve",
                            "vg",
                            "bd",
                            "ee",
                            "gp",
                            "lk",
                            "mo",
                            "ba",
                            "cw",
                            "is",
                            "kg",
                            "na",
                            "aw",
                            "gu",
                            "ir",
                            "lu",
                            "cd",
                            "cm",
                            "gt",
                            "ky",
                            "mm",
                            "np",
                            "re",
                            "si",
                            "sz",
                            "uy",
                            "ai",
                            "az",
                            "bj",
                            "bm",
                            "bn",
                            "ci",
                            "et",
                            "gi",
                            "hn",
                            "iq",
                            "jo",
                            "kh",
                            "ly",
                            "mk",
                            "mp",
                            "mq",
                            "mw",
                            "pf",
                            "sb",
                            "sc",
                            "sv",
                            "ug",
                            "zw"
                        ],
                        "type": "string",
                        "description": "The country that you want to filter companies by. Eg: 'United States'",
                        "default": "all"
                    },
                    "extendOutputFunction": {
                        "title": "Extend output function",
                        "type": "string",
                        "description": "A function which result will get merged with the default result"
                    },
                    "proxy": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Select proxies to be used by your crawler."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
