Search

The Search endpoint is the core of the B2BHint API, enabling you to look up businesses in the database. It is designed to help you find company profiles quickly and efficiently using various search parameters like company name, registration number, or location.

On this page, we’ll explore how to use the Search endpoint to retrieve relevant company data, filter your results, and integrate search capabilities into your application.

GET/api/v2/search/company

Company by query

Searching for a company by parameters will display a list of companies that match your criteria.

Required attributes

Name
q
Type
string
Description
Company name or number

Optional attributes

Name
countryCode
Type
string
Description
Country code as ISO (e.g. be)
Name
perPage
Type
integer
Description
Number of items per page
Name
page
Type
integer
Description
Current page

Request

GET

/api/v2/search/company

curl -G https://b2bhint.com/api/v2/search/company \
  -H "apiKey: {apiKey}" \
  -d q=lukoil \
  -d perPage=10

Response

{
"totalPages": 83,
"perPage": 10,
"page": 1,
"list": [
    {
        "name": "LUKOIL PAN AMERICAS, LLC",
        "shortName": null,
        "brandName": null,
        "internationalNumber": "3490601",
        "countryCode": "us-de"
    },
    {
        "name": "LUKOIL Netherlands B.V.",
        "shortName": null,
        "brandName": null,
        "internationalNumber": "14621973",
        "countryCode": "nl"
    },
    {
        "name": "LUKOIL Hamburg GmbH",
        //..
    },
]
}

GET/api/v1/company/search-by-email

Company by email

Searching for a company by email will show a list of companies that match the chosen email.

Required attributes

Name
email
Type
string
Description
Email address

Request

GET

/api/v1/company/search-by-email

curl -G https://b2bhint.com/api/v1/company/search-by-email \
  -H "apiKey: {apiKey}" \
  -d email="[email protected]"

Response

[
  {
      "name": "Sabiedrība ar ierobežotu atbildību \"Tet\"",
      "shortName": null,
      "brandName": "Tet",
      "internationalNumber": "40003052786",
      "countryCode": "lv"
  },
  //..
]

GET/api/v1/person/search

Person by parameters

Searching for a person by parameters will display a list of individuals that match your query.

Required attributes

Name
q
Type
string
Description
Person name or company name or company number

Optional attributes

Name
countryCode
Type
string
Description
Country code as ISO (e.g. be)

Request

GET

/api/v1/person/search

curl -G https://b2bhint.com/api/v1/person/search \
  -H "apiKey: {apiKey}" \
  -d q="John"

Response

[
   {
       "id": 77885895,
       "name": "john erwin konrad",
       "countryId": 26,
       "occupation": null,
       "nationality": null,
       //..
       "countryCode": "ch",
       "companies": [
           {
               "name": "Syngenta Crop Protection AG",
               "shortName": null,
               //..
           }
       ]
   },
   {
       "id": 80197414,
       "name": "john hickey"
       //..
   }
]