Skip to content
/
Firmographics

Firmographics

Request

Returns detailed information about the specified companies, 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 List Request

company_idsArray of any, [ 1 .. 1000 ] items(Id)required

Array of company IDs to retrieve

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"
]
limitinteger, <= 1000(Limit)

The number of records to return in the request.

Default:10
offsetinteger, >= 0(Offset)

Used for paginating records.

Default:0
POST
/data-api/v1/company/firmographics
curl -i -X POST \
  https://api.hginsights.com/data-api/v1/company/firmographics \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "company_ids": [
      "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"
    ],
    "limit": 10,
    "offset": 0
  }'

Responses

Company Info List Response

Bodyapplication/json
countinteger

The number of companies returned.

dataArray of objects(CompanyObject)
Response
{
  "count": 0,
  "data": [
    { … }
  ]
}