Skip to main content
POST
/
v1
/
businesses
/
stats
Fetch Stats
curl --request POST \
  --url https://api.explorium.ai/v1/businesses/stats \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '{
  "request_context": {},
  "filters": {
    "country_code": {
      "values": [
        "US",
        "IL"
      ]
    },
    "company_size": {
      "values": [
        "1-10",
        "11-50",
        "51-200",
        "201-500",
        "501-1000"
      ]
    },
    "company_revenue": {
      "values": [
        "75M-200M",
        "200M-500M",
        "500M-1B"
      ]
    },
    "linkedin_category": {
      "values": [
        "Market research"
      ]
    }
  }
}'
{
  "response_context": {
    "correlation_id": "<string>",
    "request_status": "success",
    "time_took_in_seconds": 123
  },
  "total_results": 123,
  "stats": {
    "business_categories_per_location": {},
    "revenue_per_category": {},
    "number_of_employees_per_category": {}
  }
}

​
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.
AttributeCoverage Details
Total Businesses Analyzed80M+ businesses across 150+ countries
Industry BreakdownDistribution across 50+ industry categories
Revenue DistributionAggregated revenue insights, ranging from 1M−1M-10T+
Company Size AnalysisCategorized by employee count (1-10, 11-50, 51-200, etc.)
Geographic SegmentationSupports regional and country-level filtering
  • 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.
ParameterTypeDescription
filtersObjectDefines the filtering criteria for statistics retrieval (e.g., country, industry)
region_country_codeArrayFilters businesses by specific regions within countries (e.g., us-ca, us-ga)
company_sizeArrayFilters by number of employees (e.g., 1-10, 11-50, 51-200)
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"
      ]
    }
  }
}'
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
      }
    }
  }
}
FieldTypeDescription
filtersObjectDefines the filtering criteria for the statistics request.
total_resultsNumberTotal number of businesses included in the statistics.
statsObjectContains breakdowns by category, revenue, employees, and locations.
  • 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
object
required
Example:
{
  "country_code": { "values": ["US", "IL"] },
  "company_size": {
    "values": [
      "1-10",
      "11-50",
      "51-200",
      "201-500",
      "501-1000"
    ]
  },
  "company_revenue": {
    "values": ["75M-200M", "200M-500M", "500M-1B"]
  },
  "linkedin_category": { "values": ["Market research"] }
}
​
request_context
object

Response

Successful Response

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

​
response_context
object
required
​
total_results
integer
required
​
stats
object
required
⌘I