Skip to content

Match Companies

Request

Batch match up to 10 companies by name, domain, and/or country.

Each company in the request must include at least one of: name, domain, country. Results are returned in the same order as the input, with each entry containing the matched HG company records sorted by relevance.

Security
authorization
Bodyapplication/jsonrequired

Match Request

companiesArray of objects, [ 1 .. 10 ] itemsrequired

Array of companies to match (1-10)

Example:
[
  {
    "country": "US",
    "domain": "ford.com",
    "name": "Ford Motor Company"
  },
  {
    "domain": "google.com"
  }
]
limitinteger, [ 1 .. 10 ]

Maximum number of matches to return per company

Default:1
Example:3
POST
/data-api/v2/companies/match
curl -i -X POST \
  https://api.hginsights.com/data-api/v2/companies/match \
  -H 'Authorization: Bearer <YOUR_API_KEY_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "companies": [
      {
        "country": "US",
        "domain": "ford.com",
        "name": "Ford Motor Company"
      },
      {
        "domain": "google.com"
      }
    ],
    "limit": 3
  }'

Responses

Match Response

Bodyapplication/json
companiesArray of objectsrequired
Example:
[
  {
    "country": "US",
    "domain": "ford.com",
    "matches": [ … ],
    "name": "Ford Motor Company"
  },
  {
    "domain": "lehlvksjbdvsdf.com",
    "matches": []
  }
]
Response
{
  "companies": [
    { … },
    { … }
  ]
}