Roaring logo

Company Search

Search for companies with names and filters.

Company Search

[se]
Requires addon

Documentation

The Company Search API lets you find specific companies or create targeted company lists using free text or search filters like geography, company type, and number of employees — perfect for prospecting, onboarding, or market analysis. You can also use the fuzzy search query parameter for performing searches that are less targeted to a specific name or allowing a mistake when searching for a company name in free text.

With this API you can:

  • Find individual companies
  • Build prospect lists based on filters like location, size, and business type
  • Search in our sandbox environment using test companies

Note:

Using placeholder company IDs keeps the service free of charge. (Learn more here https://help.roaring.io/en/articles/154766-company-search.)

Use case:

A financial institution onboarding a new B2B customer uses the Company Search API to quickly identify and shortlist potential business customers in a specific region and employee size range, helping sales teams prioritize outreach and onboarding efforts.

Endpoints

Search companies

Search companies matching query string parameters.

gethttps://api.roaring.io/se/company/search/2.1/search

Parameters query

requestKey
string
Used when paging in a previous searched result
pageSize
integer
Number of results to return per pagination page
from
integer
first result to return from the resultset that is being paged through
address
array
Company address
freeText
string
Company name or company id to search for
companyRegistrationDate
string
The date the company searched for should have been registered, range input with : between is accepted
county
string
County the searched for company should be registered in
industryCode
array
The primary industry code the company to search for belongs to
legalGroupCode
array
The legal group code for the type of company to search for
legalGroupText
array
The legal group text for the type of company to search for
numberEmployeesInterval
array
Employees interval
statusCode
array
Status code that the searched for company should be referenced as
town
array
Town the searched for company should be registered in
vatReg
boolean
Vat registered
zipCode
array
Zip code the searched for company should be registered in
plNetOperatingIncome
integer
Net operating income, range type, tkr
showInactiveCompanies
boolean
Include inactive companies when true; false by default.
fuzzy
boolean
Enable fuzzy matching when true; false by default. Must be supplied once with value true or false.
fuzzyDistance
integer
Requires fuzzy=true. 0, 1 or 2 (default by term length: 1-4 = 0, 5-8 = 1, 9+ = 2)
Response schema: application/json
  • hitCount
    integer <int32>
    Total hit count
  • next
    string
    url for fetching the next page of search data
  • previous
    string
    url for fetching the previous page of search data
  • requestKey
    string
    Request key