Resources

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.

Company by query

GET/api/v2/search/companyRun in your dashboard →

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

Required attributes
  • qstringCompany name or number
Optional attributes
  • countryCodestringCountry code as ISO (e.g. be)
  • perPageintegerNumber of items per page
  • pageintegerCurrent page
cURL
curl -G https://b2bhint.com/api/v2/search/company \
  -H "apiKey: {apiKey}" \
  -d q=lukoil \
  -d perPage=10
Response · 200
{
  "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",
      //..
    },
  ]
}

Company by email

GET/api/v1/company/search-by-emailRun in your dashboard →

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

Required attributes
  • emailstringEmail address
cURL
curl -G https://b2bhint.com/api/v1/company/search-by-email \
  -H "apiKey: {apiKey}" \
  -d email="[email protected]"
Response · 200
[
  {
      "name": "Sabiedrība ar ierobežotu atbildību \"Tet\"",
      "shortName": null,
      "brandName": "Tet",
      "internationalNumber": "40003052786",
      "countryCode": "lv"
  },
  //..
]

Person by parameters

GET/api/v1/person/searchRun in your dashboard →

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

Required attributes
  • qstringPerson name or company name or company number
Optional attributes
  • countryCodestringCountry code as ISO (e.g. be)
cURL
curl -G https://b2bhint.com/api/v1/person/search \
  -H "apiKey: {apiKey}" \
  -d q="John"
Response · 200
[
   {
       "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"
       //..
   }
]