Skip to content

Firmographic

Request

Returns detailed information about the specified company, including firmographics, installed technologies, and more.

Results are internally sorted by revenue (descending).

It's also possible to specify what fields from the API should be returned. By default, only some fields are returned.

Security
authorization
Bodyapplication/jsonrequired

Company Info Request

company_idstring or integer(Id)required
Example:"1698C53EBC888758570396E0334965C1"
One of:

A unique hexadecimal identifier for the desired field.

string
fieldsArray of strings(CompanyDataFields)

A list of data points to be returned in the API response.

Default:["company_id","company_name","domain_name","domain_name_normalized"]
Example:
[ "company_id", "company_name", "domain_name", "domain_name_normalized", "company_level", "city_name", "state_name", "postal_code", "country_name", "country_code", "continent_name", "subcontinent_name", "geopolitical_name", "industry_id", "industry_name", "naics_code", "naics_name", "sic_codes", "sic_names", "revenue_total", "revenue_band", "employees_total", "employees_band", "it_spend", "forbes_2000_rank", "fortune_500_rank", "global_hq_company_name", "global_hq_domain_name", "global_hq_domain_name_normalized", "global_hq_hg_id", "global_hq_city_name", "global_hq_state_name", "global_hq_postal_code", "global_hq_country_name", "global_hq_country_code", "global_hq_subcontinent_name", "global_hq_continent_name", "global_hq_geopolitical_name", "global_hq_employees_band", "global_hq_revenue_band", "global_hq_industry_id", "global_hq_industry_name", "global_hq_naics_code", "global_hq_naics_name", "global_hq_sic_codes", "global_hq_sic_names", "global_hq_forbes_2000_rank", "global_hq_fortune_500_rank" ]
POST
/data-api/v1/company/firmographic
curl -i -X POST \
  https://api.hginsights.com/data-api/v1/company/firmographic \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "company_id": "1698C53EBC888758570396E0334965C1",
    "fields": [
      "company_id",
      "company_name",
      "domain_name",
      "domain_name_normalized",
      "company_level",
      "city_name",
      "state_name",
      "postal_code",
      "country_name",
      "country_code",
      "continent_name",
      "subcontinent_name",
      "geopolitical_name",
      "industry_id",
      "industry_name",
      "naics_code",
      "naics_name",
      "sic_codes",
      "sic_names",
      "revenue_total",
      "revenue_band",
      "employees_total",
      "employees_band",
      "it_spend",
      "forbes_2000_rank",
      "fortune_500_rank",
      "global_hq_company_name",
      "global_hq_domain_name",
      "global_hq_domain_name_normalized",
      "global_hq_hg_id",
      "global_hq_city_name",
      "global_hq_state_name",
      "global_hq_postal_code",
      "global_hq_country_name",
      "global_hq_country_code",
      "global_hq_subcontinent_name",
      "global_hq_continent_name",
      "global_hq_geopolitical_name",
      "global_hq_employees_band",
      "global_hq_revenue_band",
      "global_hq_industry_id",
      "global_hq_industry_name",
      "global_hq_naics_code",
      "global_hq_naics_name",
      "global_hq_sic_codes",
      "global_hq_sic_names",
      "global_hq_forbes_2000_rank",
      "global_hq_fortune_500_rank"
    ]
  }'

Responses

Company Info Response

Bodyapplication/json
company_namestring
domain_namestring
domain_name_normalizedstring
hg_idstring
naics_namestring
global_hq_sic_codesArray of strings
global_hq_country_codestring
naics_codestring
revenue_totalinteger or null

Revenue in USD

fortune_500_rankinteger or null, >= 1
global_hq_country_namestring
global_hq_industry_namestring
global_hq_city_namestring
subcontinent_namestring
state_namestring
company_levelstring
country_codestring
global_hq_continent_namestring
global_hq_domain_namestring
employees_bandstring

Employees band

global_hq_employees_bandstring
global_hq_revenue_bandstring
sic_codesArray of strings
global_hq_state_namestring
industry_idinteger
global_hq_fortune_500_rankinteger or null, >= 1
industry_namestring
global_hq_naics_namestring
postal_codestring
global_hq_geopolitical_namestring
employees_totalinteger or null

Number of employees

geopolitical_namestring
global_hq_hg_idstring
global_hq_industry_idinteger
global_hq_subcontinent_namestring
revenue_bandstring

Revenue band

country_namestring
forbes_2000_rankinteger or null, >= 1
global_hq_domain_name_normalizedstring
it_spendinteger or null
global_hq_sic_namesArray of strings
global_hq_forbes_2000_rankinteger or null, >= 1
global_hq_company_namestring
continent_namestring
sic_namesArray of strings
global_hq_naics_codestring
global_hq_postal_codeinteger
city_namestring
Response
{ "company_name": "string", "domain_name": "string", "domain_name_normalized": "string", "hg_id": "string", "naics_name": "string", "global_hq_sic_codes": [ "string" ], "global_hq_country_code": "string", "naics_code": "string", "revenue_total": 0, "fortune_500_rank": 1, "global_hq_country_name": "string", "global_hq_industry_name": "string", "global_hq_city_name": "string", "subcontinent_name": "string", "state_name": "string", "company_level": "string", "country_code": "string", "global_hq_continent_name": "string", "global_hq_domain_name": "string", "employees_band": "string", "global_hq_employees_band": "string", "global_hq_revenue_band": "string", "sic_codes": [ "string" ], "global_hq_state_name": "string", "industry_id": 0, "global_hq_fortune_500_rank": 1, "industry_name": "string", "global_hq_naics_name": "string", "postal_code": "string", "global_hq_geopolitical_name": "string", "employees_total": 0, "geopolitical_name": "string", "global_hq_hg_id": "string", "global_hq_industry_id": 0, "global_hq_subcontinent_name": "string", "revenue_band": "string", "country_name": "string", "forbes_2000_rank": 1, "global_hq_domain_name_normalized": "string", "it_spend": 0, "global_hq_sic_names": [ "string" ], "global_hq_forbes_2000_rank": 1, "global_hq_company_name": "string", "continent_name": "string", "sic_names": [ "string" ], "global_hq_naics_code": "string", "global_hq_postal_code": 0, "city_name": "string" }