Response fields and types

Field name (key)

Type

Description

search_details

JSON object

An object that provides insight into why a particular query was matched against the Veridion database.
[Note: present only for Product Search, Keyword Search ][Note: present only for Product Search, Keyword Search ]

search_details.product_match

JSON object

An object that provides insight into why a particular product query was matched against the Veridion database.
[Note: present only for Product Search][Note: present only for Product Search]

  • *search_details.product_match
    .context**

JSON object

An object that provides additional context on the product matched through the Product Search query.

  • *search_details.product_match
    .context.headline**

string

A snippet that refers to the product name,
the name of the product category, the product line,
the product collection, or the specific capability of a manufacturer.

  • *search_details.product_match
    .context.content**

string

A larger, more descriptive paragraph of text associated with the content of the "Product Headline" (see above).

  • *search_details.product_match
    .context.url**

string

The source URL where the product was identified
and extracted from.

  • *search_details.product_match
    .context.snippets**

array

A list of text snippets that best match the search terms.
This can be part of the "Product Content" (see above)
or a completely different snippet associated with the same result (e.g., a snippet that explains a product/service characteristics).

  • *search_details.product_match
    .supplier_types**

array

Indicator of whether the company is a manufacturer,
distributor, or service provider.

search_details.keyword_match

JSON object

An object that provides insight into why a particular keyword query was matched against the Veridion database.
[Note: present only for Keyword Search][Note: present only for Keyword Search]

  • *search_details.keyword_match
    .context**

JSON object

An object that provides additional context on the keywords matched through the Keyword Search query.

  • *search_details.keyword_match
    .context.snippets**

array

A list of text snippets that best match the search terms.

veridion_id

string

Veridion internal company ID.

company_name

string

The most commonly used name when referring to this entity; may either be its legal or commercial name (in some cases, the commercial name is an abbreviation of the company name).

company_commercial_names

array

Commercial names by which the company is known,
which might differ from its legal name.
For example, while the legal name could be "The Acme Inc.", the company is commonly referred to using the commercial name: "Acme".

company_legal_names

array

The main legal name of the company, including its
historical variations and past legal names are the names employed in documents such as the Privacy Policy and other legal records.

main_address

JSON object

The address where the company's HQ is located.

main_address.country_code

string

The two-digit ISO code of the country in which
the company's HQ is located.

main_address.country

string

The name of the country in which the company's HQ is located.

main_address.region

string

The name of the region in which the company's HQ is located.

main_address.city

string

The name of the city in which the company's HQ is located.

main_address.street

string

The name of the street on which the company's HQ is located.

main_address.street_number

string

The street number associated with the HQ street name.

main_address.postcode

string

Postcode associated with the company's HQ.

main_address.latitude

decimal

The company's HQ latitude coordinates.

main_address.longitude

decimal

The company's HQ longitude coordinates.

locations

array

Top 10 company locations (includes HQ and all secondary locations).

locations.country_code

string

The two-digit ISO code of the country for
the company location(s).

locations.country

string

Full country name of the company location(s).

locations.region

string

State, geographical region or province for the company
location(s) (where applicable).

locations.city

string

The city associated with the location.

locations.street

string

The street name associated with the location.

locations.street_number

string

The street number associated with the street name.

locations.postcode

string

Postcode associated with the location.

locations.latitude

decimal

The location's latitude coordinates.

locations.longitude

decimal

The location's longitude coordinates.

num_locations

integer

The count of physical locations attributed to the company. Includes offices, retail locations, manufacturing plants and other location types.

Depending on the company, this number might not necessarily match the "Number of offices".

company_type

string

  • "Public" for companies listed on the stock exchange.
  • "Private" for privately held companies.

year_founded

integer

Founding year for the company. If the company is a component of a larger or older organization, the founding year corresponds to that of the parent organization.

employee_count

JSON object

The number of people employed by the company, as communicated by the company or modelled by Veridion's AI.

employee_count.value

integer

The number of people employed by the company

employee_count.type

string

  • "Extracted" for published values in sources used by Veridion
  • "Modelled" for values modelled by Veridion's AI using official digital content published by the company.

revenue

JSON object

Company yearly revenue.
For companies that publish their revenue numbers (e.g. public companies, Inc 5000 companies etc.), the value is the officially declared one.
For other companies, the revenue is estimated based on publicly available numbers or modelled by Veridion's proprietary AI models.

revenue.value

integer

Company yearly revenue value

revenue.type

string

  • "Extracted" for values published in sources used by Veridion
  • "Modelled" for values modelled by Veridion's AI

main_business_category

string

Primary business category for the company, based on
Veridion's ML classification model.

main_industry

string

Primary industry of activity for the company, based on
Veridion's ML classification model.

main_sector

string

Primary sector of activity of the company, based on
Veridion's ML classification model.

naics_2022

JSON object

The NAICS 2022 classification for the company (6-digit code).

naics_2022.primary

JSON object

Primary NAICS 2022 classification for the company.

naics_2022.primary.code

string

Primary NAICS 2022 code for the company.

naics_2022.primary.label

string

Primary NAICS 2022 label for the company.

naics_2022.secondary

array

Secondary NAICS 2022 classifications for the company.

naics_2022.secondary.code

string

Secondary NAICS 2022 code for the company.

naics_2022.secondary.label

string

Secondary NAICS 2022 label for the company.

nace_rev2

array

NACE classification for the company.

nace_rev2.code

string

NACE classification code for the company.

nace_rev2.label

string

NACE classification label for the company.

ncci_codes_28_1

array

NCCI classification codes for the company (4-digit code).

sic

array

SIC classification for the company (4-digit code).

sic.code

string

SIC classification code for the company (4-digit code).

sic.label

string

SIC classification label for the company (4-digit label).

isic_v4

array

ISIC classifications for the company (4-digit).

isic_v4.code

string

ISIC classification code for the company (4-digit code).

isic_v4.label

string

ISIC classification label for the company (4-digit label).

ibc_insurance

array

The company's IBC Mapping (5 levels deep).

ibc_insurance.code

string

The company's IBC Mapping code (5 levels deep).

ibc_insurance.label

string

The company's IBC Mapping label (5 levels deep).

sics_industry

JSON object

The SASB Sustainable Industry Classification Scheme (SICS)
Industry of the company.

sics_industry.code

string

The SASB SICS Industry code of the company.

sics_industry.label

string

The SASB SICS Industry label of the company.

sics_subsector

JSON object

The SASB SICS subsector of the company.

sics_subsector.code

string

The SASB SICS subsector code of the company.

sics_subsector.label

string

The SASB SICS subsector label of the company.

sics_sector

JSON object

The SASB SICS sector of the company.

sics_sector.code

string

The SASB SICS sector code of the company.

sics_sector.label

string

The SASB SICS sector label of the company.

short_description

string

A short description of the business activities of the company. Value is extracted as presented in the digital source.

long_description_extracted

string

A longer description of the business activities of the company. Value is extracted as presented in the digital source.

long_description_generated

string

LLM generated description of the business activities of the company. Veridion developed LLMs use various digital sources to aggregate information and generate a structured description that includes information such as company name, founded year, parent information, stock information, product/services information, when available.

business_tags_extracted

array

Company attributes related to the company's activities.
For example, a tech company may contain tags such as
"startup", "SaaS", or "Artificial Intelligence". Values are extracted exactly as presented in the digital source.

business_tags_generated

array

LLM generated attributes related to the company's activities. Veridion developed LLMs use various digital sources to aggregate information and infer activities based on raw content. Generated tags can capture niche activities, business models, products, services and differentiators / unique traits of the company.

primary_phone

string

The primary phone number associated with the company.

phone_numbers

array

Additional phone numbers linked to the company,
generally front-office phone numbers
or departmental contact numbers.

primary_email

string

The primary email address associated with the company.

emails

array

Generic company email addresses linked to the company domain, such as "info@company" or "contact@company".

website_url

string

The URL of the main company website.

website_domain

string

The domain name of the main company website.

website_tld

string

Top-level domain of the company domain.

website_language_code

string

Primary language identified on the company website.

facebook_url

string

The company's Facebook URL.

twitter_url

string

The company's Twitter URL.

instagram_url

string

The company's Instagram URL.

linkedin_url

string

The company's LinkedIn URL.

ios_app_url

string

The company's iOS App Store URL.

android_app_url

string

The company's Google Play URL.

youtube_url

string

The company's YouTube channel URL.

technologies

array

Types of web technologies used by the company website and public assets, such as: Content Management System, Programming Language, or Other web components.

created_at

string

The UTC date and time when the company profile was initially added to the Veridion database.

last_updated_at

string

The UTC date and time when the information about the company was last extracted and verified for updates by Veridion.