Search Unstructured

This endpoint allows you to search the company database by using an unstructured query. It is suitable when you have incomplete data on companies in your system and you need to complete it.

GET /us/Company/SearchUnstructured

Returns a list of companies matching the search criteria using flexible matching algorithms. Ideal for data enrichment scenarios where you have partial company information.

Response Codes

200 OK 400 Bad Request 401 Unauthorized 429 Too Many Requests

Try in Swagger UI →

Important Note

Default search includes partnerships, corporations, and proprietorships. For other company types or branches, manual selection is required.

Parameters

Parameter	Type	Description
`Name`	string	Name of the company (partial match supported)
`Address`	string	Query to search in company address. This field can contain an English country name at the end – in such case, the search is limited to the given country.
`Ids`	string[]	Array of company IDs to search for. All types of company IDs can be used – HitHorizons number, national ID.
`CompanyTypes`	string[]	Array of company types to return. When not supplied, only types 0, 3, 12, 13 are returned. Refer to Code Lists for values. Can be provided as comma-separated list (e.g., `CompanyTypes=3,13`) or as array (`CompanyTypes=3&CompanyTypes=13`). If set to empty value, all company types are returned.
`ShowBranches`	boolean	When `false` (default), only single-location or headquarters are returned (LocationType = 0 or 1). When `true`, all companies including branches are returned.
`MaxResults`	integer	Maximum number of results to return. Maximum of 100 results is supported. Default: 20

Example Request

GET /us/Company/SearchUnstructured?Name=Acme&Address=Texas&ShowBranches=false&MaxResults=20
Ocp-Apim-Subscription-Key: your-api-key

Example with IDs Array

GET /us/Company/SearchUnstructured?Ids=H-USSD0001234567&Ids=H-USSD0009876543
Ocp-Apim-Subscription-Key: your-api-key

Example Response

{
  "Success": true,
  "Error": null,
  "Result": {
    "Results": [
      {
        "HitHorizonsId": "H-USSD0001234567",
        "CompanyName": "Acme Manufacturing Corp",
        "CompanySecondaryName": null,
        "AddressStreetLine1": "100 Industrial Way",
        "AddressStreetLine2": null,
        "PostalCode": "12345",
        "City": "Springfield",
        "CountyDistrict": "Example County",
        "StateProvince": "Texas",
        "NationalId": "0001234567",
        "SICCode": "2655",
        "IndustryCode": "D",
        "EstablishmentOfOwnership": 1995,
        "SalesEUR": 50000,
        "SalesUSD": 54000,
        "EmployeesNumber": 50,
        "CompanyType": 3,
        "LocationType": 0,
        "Websites": null,
        "Emails": null,
        "Phones": ["555 123 4567"],
        "SocialURLs": null
      }
    ],
    "ResultsCount": 2,
    "TotalCount": 2
  }
}

Use Cases

The unstructured search is particularly useful for:

Data enrichment - When you have partial company data and need to find the complete record
Fuzzy matching - When company names might have variations or typos
CRM integration - When enriching customer records with incomplete information
Deduplication - When identifying potential duplicate entries in your database

Tip

For more precise results when you have structured data available, use the Structured Search endpoint instead.