Endpoint Examples

/totals

Get summary metrics on all profiles matching the filters.


POST /totals

Query Parameters

NameDescription
new_taxonomy_versions
enum
Use new taxonomy versions.
This parameter is optional.
Must be one of: true, false
lot_version
enum
Specify LOT taxonomy version to use.
This parameter is optional.
Default: 7
Must be one of: 6, 7
naics_version
enum
Specify NAICS taxonomy version to use.
This parameter is optional.
Default: naics_std_2022
Must be one of: naics_std_2022, naics_std_2017
area_version
enum
Specify area taxonomy version to use.
This parameter is optional.
Default: lf_area_2025_1
Must be one of: lf_area_2023_2, lf_area_2025_1
area_laa_version
enum
Specify LAA area taxonomy version to use.
This parameter is optional.
Default: 2
Must be one of: 1, 2

Request Body

{
  "filter": {
    "company_name": [
      "Zoho Corporation"
    ]
  },
  "metrics": [
    "profiles",
    "unique_companies"
  ]
}

Code Examples

curl --request POST \
  --url https://api.lightcast.io/global-profiles/totals \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --header 'Content-Type: application/json' \
  --data '{ "filter": { "company_name": [ "Zoho Corporation" ] }, "metrics": [ "profiles", "unique_companies" ] }'

Response Examples

{
  "data": {
    "totals": {
      "profiles": 125286,
      "unique_companies": 20934
    }
  }
}