Business Statistics

Description

The Fetch Business Statistics endpoint provides aggregated insights into businesses by industry, revenue, employee count, and geographic distribution. It enables users to analyze market trends, segment industries, and gain a high-level overview of business activity within specified parameters.

Coverage

Attribute	Coverage Details
Total Businesses Analyzed	80M+ businesses across 150+ countries
Industry Breakdown	Distribution across 50+ industry categories
Revenue Distribution	Aggregated revenue insights, ranging from $1M-$ 10T+
Company Size Analysis	Categorized by employee count (1-10, 11-50, 51-200, etc.)
Geographic Segmentation	Supports regional and country-level filtering

How It Works

Input: Define filter parameters such as industry, region, and company size.
Processing: The system aggregates data across relevant datasets to generate statistics.
Output: A structured response with key insights into business distribution and segmentation.

Query Parameters

Parameter	Type	Description
`filters`	Object	Defines the filtering criteria for statistics retrieval (e.g., country, industry)
`region_country_code`	Array	Filters businesses by specific regions within countries (e.g., `us-ca`, `us-ga`)
`company_size`	Array	Filters by number of employees (e.g., `1-10`, `11-50`, `51-200`)

Example Request (cURL)

Bash

curl --request POST \
  --url https://api.explorium.ai/v1/businesses/stats \
  --header 'Content-Type: application/json' \
  --header 'accept: application/json' \
  --header 'api_key: key' \
  --data '{
  "filters": {
    "region_country_code": {
      "type": "includes",
      "values": [
        "us-ca",
        "us-ga",
        "us-ut"
      ]
    },
    "company_size": {
      "type": "includes",
      "values": [
        "1-10",
        "11-50",
        "51-200"
      ]
    }
  }
}'

Example Response

JSON

{
  "total_results": 29229,
  "stats": {
    "business_categories_per_location": {
      "Software company": {
        "California, US": 22093,
        "Georgia, US": 4898,
        "Utah, US": 2031,
        "total": 29022
      },
      "Computer software store": {
        "California, US": 160,
        "Georgia, US": 33,
        "Utah, US": 12,
        "total": 205
      },
      "total_per_location": {
        "California, US": 22255,
        "Georgia, US": 4931,
        "Utah, US": 2043,
        "total": 29229
      }
    }
  }
}

Schema Explanation

Field	Type	Description
`filters`	Object	Defines the filtering criteria for the statistics request.
`total_results`	Number	Total number of businesses included in the statistics.
`stats`	Object	Contains breakdowns by category, revenue, employees, and locations.

Best Practices

Use targeted filters to focus on specific industries or regions.
Combine multiple attributes (e.g., region_country_code + company_size) for in-depth segmentation.
Utilize aggregated insights to optimize marketing strategies and market analysis.

Note on Filter Usage

All available business filters (e.g., region_country_code, company_size, etc.) can be applied in this endpoint.
Only one category filter can be used per request: choose from either Google category, LinkedIn industry, or NAICS code. Combining them is not supported.

For detailed endpoint explanations, request examples, and integration tips, explore the documentation sections above.

Body Params - Try Me Example

filters:
  region_country_code: us-ca, us-ga, us-ut
  company_size: 1-10, 11-50, 51-200

Note: For any unused filter, set \`negate\` (boolean) as empty instead of \`false\`, as it defaults to \`false\`.

Authorizations

api_key

string

header

required

Body

application/json

filters

BusinessesFetchFilters · object

required

Show child attributes

filters.country_code

Country Code · object

A two-letter country code (ISO Alpha-2 format).

Show child attributes

filters.country_code.values

string[]

required

filters.country_code.negate

boolean

Example:

{ "values": ["US", "CA"] }

filters.region_country_code

Region Country Code · object

Filter prospects by region using ISO 3166-2 codes. Example: [us-ut, us-ca].

Show child attributes

filters.region_country_code.values

string[]

required

filters.region_country_code.negate

boolean

Example:

{ "values": ["US-CA", "IL-TA"] }

filters.company_size

Company Size · object

Filter accounts by the number of employees at all company sites. Categories: [1-10, 11-50, ..., 10001+].

Show child attributes

filters.company_size.values

enum<string>[]

required

The NumberOfEmployeesRange class is an enumeration that represents predefined ranges for the number of employees in a company. These ranges are used for filtering and categorizing companies based on their workforce size.

Available options:

1-10,

11-50,

51-200,

201-500,

501-1000,

1001-5000,

5001-10000,

10001+

filters.company_size.negate

boolean

Example:

{
  "values": [
    "1-10",
    "11-50",
    "51-200",
    "201-500",
    "501-1000",
    "1001-5000",
    "5001-10000",
    "10001+"
  ]
}

filters.company_revenue

Company Revenue · object

Filter by company’s annual revenue. Options: [0-500K, 500K-1M, ..., 10B-100B].

Show child attributes

filters.company_revenue.values

enum<string>[]

required

The RevenueRange class is an enumeration that represents predefined ranges for the revenue of a company.

Available options:

0-500K,

500K-1M,

1M-5M,

5M-10M,

10M-25M,

25M-75M,

75M-200M,

200M-500M,

500M-1B,

1B-10B,

10B-100B,

100B-1T,

1T-10T,

10T+

filters.company_revenue.negate

boolean

Example:

{
  "values": [
    "0-500K",
    "500K-1M",
    "1M-5M",
    "5M-10M",
    "10M-25M",
    "25M-75M",
    "75M-200M",
    "200M-500M",
    "500M-1B",
    "1B-10B",
    "10B-100B",
    "100B-1T",
    "1T-10T",
    "10T+"
  ]
}

filters.company_age

Company Age · object

Filter accounts by how many years since they were established. Categories: [0-3, 3-6, ..., 20+].

Show child attributes

filters.company_age.values

enum<string>[]

required

The CompanyAgeRange class is an enumeration that inherits from BaseFilterEnum.

It represents predefined ranges for the age of a company, such as "0-3 years" or "20+ years". This enum is used to categorize companies based on their age, ensuring consistent filtering and comparison across the application. Each range is defined as a string value for easy conversion and usage.

Available options:

0-3,

3-6,

6-10,

10-20,

20+

filters.company_age.negate

boolean

Example:

{
  "values": ["0-3", "3-6", "6-10", "10-20", "20+"]
}

filters.google_category

Google Category · object

Filter by company’s Google business category. Example: [Paving contractor, Retail].

Show child attributes

filters.google_category.values

string[]

required

filters.google_category.negate

boolean

Example:

{ "values": ["Retail"] }

filters.naics_category

NAICS Category · object

Filter accounts by their 2017 NAICS industry code. Example: [23, 5611].

Show child attributes

filters.naics_category.values

string[]

required

filters.naics_category.negate

boolean

Example:

{ "values": ["541512"] }

filters.linkedin_category

LinkedIn Category · object

Filter accounts by their classified LinkedIn business category. Example: [software development, investment banking].

Show child attributes

filters.linkedin_category.values

string[]

required

filters.linkedin_category.negate

boolean

Example:

{ "values": ["Market research"] }

filters.company_tech_stack_category

Company Tech Stack Category · object

Filter accounts by the technology categories they use. Example: [Marketing, CRM, Cloud Services].

Show child attributes

filters.company_tech_stack_category.values

string[]

required

filters.company_tech_stack_category.negate

boolean

Example:

{
  "values": [
    "Business Intelligence And Analytics",
    "Devops And Development"
  ]
}

filters.company_tech_stack_tech

Company Tech Stack Tech · object

Filter accounts by the specific technologies they use. Example: [JavaScript, HTML5, Apache].

Show child attributes

filters.company_tech_stack_tech.values

string[]

required

filters.company_tech_stack_tech.negate

boolean

Example:

{
  "values": ["JavaScript", "HTML5", "Apache"]
}

filters.company_name

Company Name · object

Filter accounts by specific company names. Example: [Microsoft, Walmart].

Show child attributes

filters.company_name.values

string[]

required

Maximum string length: 256

filters.company_name.negate

boolean

Example:

{ "values": ["Microsoft", "Google"] }

filters.number_of_locations

Number of Locations · object

Filter accounts by how many office locations they operate. Example: [1, 2-5, 6+].

Show child attributes

filters.number_of_locations.values

enum<string>[]

required

The NumberOfLocations class is an enumeration that represents predefined ranges

Available options:

0-1,

2-5,

6-20,

21-50,

51-100,

101-1000,

1001+

filters.number_of_locations.negate

boolean

Example:

{
  "values": [
    "0-1",
    "2-5",
    "6-20",
    "21-50",
    "51-100",
    "101-1000",
    "1001+"
  ]
}

filters.city_region_country

City Region Country · object

Filter accounts by geographic region, down to city-level granularity. Example: [San Francisco, CA, US].

Show child attributes

filters.city_region_country.values

string[]

required

filters.city_region_country.negate

boolean

Example:

{
  "values": [
    "Paris, FR",
    "Tel Aviv, IL",
    "Miami, FL, US"
  ]
}

filters.website_keywords

Website Keywords · object

Filter accounts by exact phrases mentioned on their websites. Example: [summer camp, machine learning]

Show child attributes

filters.website_keywords.values

string[]

required

filters.website_keywords.negate

boolean

Example:

{
  "values": ["summer camp", "machine learning"]
}

filters.business_intent_topics

Business Intent Topics · object

Filter accounts by intent data topics with composite score levels. Automatically expands to include bucket suffixes (_low, _medium, _high).

Show child attributes

filters.business_intent_topics.topics

string[]

required

filters.business_intent_topics.negate

boolean

filters.business_intent_topics.topic_intent_level

enum<string>

An enumeration.

Available options:

emerging_intent,

high_intent,

very_high_intent

Example:

{
  "topics": [
    "Security:Cloud Security",
    "HR:Employee Benefits",
    "Smartphones:iPhone"
  ],
  "topic_intent_level": "high_intent"
}

Example:

{}

request_context

Request Context · object

Example:

null

Response

Successful Response

This is base response model for all responses in partner service.

response_context

ResponseContext · object

required

Show child attributes

response_context.correlation_id

string

required

response_context.request_status

enum<string>

required

The RequestStatus class is an enumeration that defines the possible statuses of a request.

This enum is used to indicate whether a request was successful, missed, or failed. It ensures consistent handling of request statuses across the application.

Attributes: SUCCESS: Indicates that the request was successfully processed. MISS: Indicates that the request did not find any matching data. FAILURE: Indicates that the request encountered an error or failure.

Available options:

success,

miss,

failure

response_context.time_took_in_seconds

number

required

total_results

integer

required

stats

BusinessesStats · object

required

Show child attributes

stats.business_categories_per_location

Business Categories Per Location · object

stats.revenue_per_category

Revenue Per Category · object

stats.number_of_employees_per_category

Number Of Employees Per Category · object

Explorium AgentSource

Partners

Description

Note on Filter Usage

Body Params - Try Me Example

Authorizations

Body

Response

Explorium AgentSource

Partners

​Description

​ Note on Filter Usage

​Body Params - Try Me Example

Authorizations

Body

Response

Description

Note on Filter Usage

Body Params - Try Me Example