Business Statistics

Fetch Stats

curl --request POST \
  --url https://api.explorium.ai/v1/businesses/stats \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "filters": {},
  "request_context": null
}
'

import requests

url = "https://api.explorium.ai/v1/businesses/stats"

payload = {
    "filters": {},
    "request_context": None
}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({filters: {}, request_context: null})
};

fetch('https://api.explorium.ai/v1/businesses/stats', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.explorium.ai/v1/businesses/stats",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'filters' => [
        
    ],
    'request_context' => null
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.explorium.ai/v1/businesses/stats"

	payload := strings.NewReader("{\n  \"filters\": {},\n  \"request_context\": null\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api_key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.explorium.ai/v1/businesses/stats")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"filters\": {},\n  \"request_context\": null\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.explorium.ai/v1/businesses/stats")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"filters\": {},\n  \"request_context\": null\n}"

response = http.request(request)
puts response.read_body

{
  "response_context": {
    "correlation_id": "<string>",
    "time_took_in_seconds": 123
  },
  "total_results": 123,
  "stats": {
    "business_categories_per_location": {},
    "revenue_per_category": {},
    "number_of_employees_per_category": {}
  }
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

POST

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 '
{
  "filters": {},
  "request_context": null
}
'

import requests

url = "https://api.explorium.ai/v1/businesses/stats"

payload = {
    "filters": {},
    "request_context": None
}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({filters: {}, request_context: null})
};

fetch('https://api.explorium.ai/v1/businesses/stats', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.explorium.ai/v1/businesses/stats",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'filters' => [
        
    ],
    'request_context' => null
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.explorium.ai/v1/businesses/stats"

	payload := strings.NewReader("{\n  \"filters\": {},\n  \"request_context\": null\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api_key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.explorium.ai/v1/businesses/stats")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"filters\": {},\n  \"request_context\": null\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.explorium.ai/v1/businesses/stats")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"filters\": {},\n  \"request_context\": null\n}"

response = http.request(request)
puts response.read_body

{
  "response_context": {
    "correlation_id": "<string>",
    "time_took_in_seconds": 123
  },
  "total_results": 123,
  "stats": {
    "business_categories_per_location": {},
    "revenue_per_category": {},
    "number_of_employees_per_category": {}
  }
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

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
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

Example:

{}

request_context

Request Context · object | null

Example:

null

Response

Successful Response

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

response_context

ResponseContext · object

required

Show child attributes

total_results

integer

required

stats

BusinessesStats · object

required

Show child attributes

Fetch Businesses Autocomplete Businesses

⌘I

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

Authorizations

Body

Response

Description

Note on Filter Usage

Body Params - Try Me Example