BQ Business Identity API
This API is a powerful tool that delivers Company Firmographic and Legal Entity level data for 102M Organizations doing business in the US.
- This API allows businesses to leverage up-to-date company information using various valuable data points, such as company name, address (including HQ address, Legal Entity address, and any other address), headcount, or industry, and generate business opportunities, discover industry trends, and unlock market insights.
- The API provides information related to corporate family tree structure and compliance checks that help businesses with identity as well as verification of the legal status of the company.
This API enables a client to search for a Company or Legal Entity using input parameters such as:
- BQ ID
- Company Name
- Company Address
- Website URL
- Ticker
- CIK
Output parameters include Organization
- Firmographics with Revenue and Employment Ranges
- Legal Entity details, BQ Credit Score, Taxliens etc.
BQʼs proprietary search algorithms utilize multiple match methods and sorts the results using a combination of proximity and company size with a preference towards larger companies.
Authentication
The API supports the following authentication method
- API Key
Method: POST
You can use the API Endpoint to supply your API Key.
Postman Setup
Below is the step-by-step process to implement the authentication
- Select Method as POST and add Endpoint URL.
- Click the Authorization tab below Select Basic Auth.
- Supply your API Key.
BQ Organizations Search API
Organization: An organization is a company, which represents a collection of legal entities that are under common control; this table contains basic identifying information on the organization, and how it links to its component legal entities; type of hierarchy.
API Endpoint
https://apigw.brightquery.com/search/identity/org
| Parameter | Data Type | Description / Example |
|---|---|---|
| bq_id | String | Unique BQ identifier for the Organization. |
| ticker | String | TICKER of the Organization if it is public. Example: bq_ticker=FLO |
| ticker_parent | String | TICKER of the Organization's parent holding company if the parent is publicly listed. Example: bq_ticker_parent = ‘FLO’ |
| ticker_related | String | All TICKERs associated with the Organization if it is publicly listed Example: bq_ticker_related = ‘FLO’ |
| cik | String | CIK of Organization Example: bq_cik=0001128928 |
| linkedin_url | String | Organization Linkedin URL Example: bq_company_linkedin_url=https://www.linkedin.com/company/flowers-foods |
| company_name | String | Organization Name Example: bq_company_name=FLOWERS FOODS INC |
| address | String | Address of Organization Example: bq_company_address1_line_1=1919 Flowers Cir Thomasville, GA 31757 |
| website | String | Website of Organization Example: bq_website=https://www.flowersfoods.com |
| String | Email of the contact |
Name + Address
{
"company_name":"Flower",
"address":"1919 Flowers Cir Thomasville"
}
Name + Website
{
"company_name":"Flower",
"website":"www.flowersfoods.com"
}
Name only
{
"company_name":"Flower"
}
Website only
{
"website":"www.flowersfoods.com"
}
Ticker only
{
"ticker":"FLO"
}
LinkedIn URL
{
"linkedin_url":"www.linkedin.com/company/flowers-foods"
}
CIK only
{
"cik":"0001128928"
}
Email only
{
"email":"john@flowersfoods.com"
}
BQ ID only
{
"bq_id":"100003273517"
}
Ticker Parent only
{
"ticker_parent": "FLO"
}
Related Ticker only
{
"ticker_related": "MSBIP"
}
Number of records per hit: 10.
Records are sorted by revenue and employee headcount.
BQ Legal Entities API
API EndPoint
https://apigw.brightquery.com/search/identity/le
| Parameters | Data Type | Description |
|---|---|---|
| company_name | String | Legal name of the Legal Entity |
| address | String | Address of Legal Entity |
| website | String | Website of Organization |
| String |
{
"company_name": "Flower",
"address": "1919 Flowers Cir Thomasville"
}
{
"company_name": "Flower",
"website": "www.flowersfoods.com"
}
{
"company_name": "Flower"
}
{
"website": "www.flowersfoods.com"
}
{
"email": "joe@flowersfoods.com"
}
Number of records per hit is 10.
Records are sorted by revenue and employees headcount
BQ Locations API
Business locations (address, industry category) associated with an organization; these are typically stores, offices, distribution centers, and branches.
API Endpoint
https://apigw.brightquery.com/search/identity/location
| Parameter | Data Type | Description |
|---|---|---|
| location_name | String | Name of the Location, often a DBA. |
| address | String | Address of Location |
| city | String | City of Location |
| state | String | State of Location |
Location Name + Address
{
"location_name":"Flower",
"address":"2250 Highmoor Rd"
}
Location Name + State + City
{
"location_name":"Flowers",
"state":"Massachusetts",
"city":"Cambridge"
}
Location Name only
{
"location_name":"Flower"
}
Address only
{
"address":"2250 Highmoor Rd"
}Number of records per hit is 10.
Records are sorted by revenue and employees headcount
Table of Contents
Overview
Authentication
Organization Search API
Legal Entity API
Locations API