Use this endpoint to search and standardize Business Demographics data (USA).
US Business Coder//
- Validate and retrieve businesses information
Validate and retrieve business information
Validate and retrieve bus...
US Business Coder
The Business Coder Cloud API provides in-depth firmographic information for over 25 million U.S. enterprises. This data encompasses standardized company names, job titles, contact details (including names, addresses, phone numbers, and email addresses), SIC/NAICS codes, workforce sizes, stock ticker symbols, revenue figures, and more. This API offers a wealth of valuable insights into businesses, serving a wide range of purposes such as market analysis, lead generation, and customer profiling.
You can use Business Coder to:
- Search for businesses using the phone number, stock ticker, and web address.
- Discover business SIC codes, sales volumes, employee sizes, phone numbers, etc.
Documentation
Useful Resources
Product Page
Support Center
Download OpenAPI description
Languages
Servers
US Business Coder Server
https://businesscoder.melissadata.net/WEB/BusinessCoder/
Request
Uses HTTPS GET to accept one input record and returns the response in JSON format. This is useful for browser level or quick single queries.
Note: A request to the Business Coder Cloud Service must consist of the License Key and Either Address, MAK and Company, Stock Ticker, Web Address, or Phone to verify.
Query
Transmission Reference - Serves as a unique identifier for this set of records. This allows you to match a response to a request.
Example: t=Business Coder Test
Columns - The column names or groups to be output.
Entering the column name will return the column. Specifying a group name will return all columns in the group.
Delimit multiple columns with a ,.
For example: ColumnName,ColumnName.
- [DEFAULT] These columns are returned by default.
AddressLine1CityCompanyNameCurrentCompanyNameMelissaEnterpriseKeyPostalCodeRecordIDRecordsStateSuiteTotalContactsTransmissionReferenceTransmissionResults
- [NO GROUP] These columns must be requested individually.
ContactsEmployeesEstimateLocationTypePhoneSalesEstimateStockTickerWebAddress
GrpAddressDetailsCountryCodeCountryNameDeliveryIndicatorMelissaAddressKeyMelissaAddressKeyBasePlus4
GrpBusinessCodesEINNAICSCode1NAICSCode2NAICSCode3SICCode1SICCode2SICCode3
GrpBusinessDescriptionNAICSDescription1NAICSDescription2NAICSDescription3SICDescription1SICDescription2SICDescription3
GrpGeoCodeLatitudeLongitude
GrpCensusCensusBlockCensusTractCountyFIPSCountyNamePlaceCodePlaceName
Options - Pass in options you want to set for the request.
List options in the format OptionName:Parameter, with multiple options delimited with a ,. For example: OptionName:Parameter,OptionName:Parameter
CentricHint:< company | address | phone >- This option allows you to choose what the service will center the search around.MaxContacts:< 1 | 5 | 10 >- This option changes the upper limit on the number of contacts returned. Default is5.ReturnDominantBusiness:< yes | no >- This option handles the returning of the dominant business name and demographics for a particular site when the company information is missing or does not match. Default isyes.SICNAICSConfidence:< strict | loose >- This option handles how SIC Codes are returned, depending on our SIC Code confidence level. Default isloose.
Example: opt=CentrictHint:company,MaxContacts:5
- US Business Coder Serverhttps://businesscoder.melissadata.net/WEB/BusinessCoder/doBusinessCoderUS
- curl
- C#
- Python
- Java
- JavaScript
- Node.js
- PHP
- Go
- Ruby
- R
- C#+Newtonsoft
- Java8+Apache
- Payload
curl -i -X GET \
'https://businesscoder.melissadata.net/WEB/BusinessCoder/doBusinessCoderUS?id={REPLACE-WITH-YOUR-LICENSE-KEY}&comp=Melissa+Data&phone=8006354772&a1=22382+Avenida+Empresa&city=Rancho+Santa+Margarita&state=California&postal=92688'A response is the result of a request. This consists of returned results codes and parsed, corrected, and/or appended request elements, depending on the options selected.
Returns the generic service level result/error codes. For more information, see Business Coder Result Codes.
The returned array of records.
The company name in our reference data. You can use this to easily compare your input company name against Melissa records for that address.
Code denoting the business location type. 0 - Headquarters, 1 - Branches, 2 - Subsidiary Headquarters, 3 - Single Location.
A unique key assigned to the base address of a complex with apartments or suites.
North American Industry Classification System code. This is related to SICCode1.
This is a string value containing a unique identifier for the current record. Use this to match the record submitted with the record returned. It will return what is inputted.
Returns record specific result codes. For more information, see Business Coder Result Codes.
Response
application/json
{ "TransmissionResults": " ", "TransmissionReference": "Business Coder Test", "Version": "9.0.1.1091", "TotalRecords": "1", "Records": [ { … } ] }
Request
An HTTPS POST is issued with the "ContentType" header specifying the format of the request and the "Accept" header specifying the format of the response.
Note: A request to the Business Coder Cloud Service must consist of the License Key and either Address, MAK and Company, Stock Ticker, Web Address, or Phone to verify.
Columns - The column names or groups to be output.
Entering the column name will return the column. Specifying a group name will return all columns in the group.
Delimit multiple columns with a ,.
For example: ColumnName,ColumnName.
- [DEFAULT] These columns are returned by default.
AddressLine1CityCompanyNameCurrentCompanyNameMelissaEnterpriseKeyPostalCodeRecordIDRecordsStateSuiteTotalContactsTransmissionReferenceTransmissionResults
- [NO GROUP] These columns must be requested individually.
ContactsEmployeesEstimateLocationTypePhoneSalesEstimateStockTickerWebAddress
GrpAddressDetailsCountryCodeCountryNameDeliveryIndicatorMelissaAddressKeyMelissaAddressKeyBasePlus4
GrpBusinessCodesEINNAICSCode1NAICSCode2NAICSCode3SICCode1SICCode2SICCode3
GrpBusinessDescriptionNAICSDescription1NAICSDescription2NAICSDescription3SICDescription1SICDescription2SICDescription3
GrpGeoCodeLatitudeLongitude
GrpCensusCensusBlockCensusTractCountyFIPSCountyNamePlaceCodePlaceName
Example: "GrpAddressDetails,GrpBusinessCodes"
The License Key issued by Melissa.
Options - Pass in options you want to set for the request.
List options in the format OptionName:Parameter, with multiple options delimited with a ,. For example: OptionName:Parameter,OptionName:Parameter
CentricHint:< company | address | phone >- This option allows you to choose what the service will center the search around.MaxContacts:< 1 | 5 | 10 >- This option changes the upper limit on the number of contacts returned. Default is5.ReturnDominantBusiness:< yes | no >- This option handles the returning of the dominant business name and demographics for a particular site when the company information is missing or does not match. Default isyes.SICNAICSConfidence:< strict | loose >- This option handles how SIC Codes are returned, depending on our SIC Code confidence level. Default isloose.
Example: "CentrictHint:company,MaxContacts:5"
- US Business Coder Serverhttps://businesscoder.melissadata.net/WEB/BusinessCoder/doBusinessCoderUS
- curl
- C#
- Python
- Java
- JavaScript
- Node.js
- PHP
- Go
- Ruby
- R
- C#+Newtonsoft
- Java8+Apache
- Payload
curl -i -X POST \
https://businesscoder.melissadata.net/WEB/BusinessCoder/doBusinessCoderUS \
-H 'Content-Type: application/json' \
-d '{
"cols": "",
"id": "{REPLACE-WITH-YOUR-LICENSE-KEY}",
"opt": "",
"Records": [
{
"a1": "22382 Avenida Empresa",
"a2": " ",
"city": "Rancho Santa Margarita",
"comp": " ",
"ctry": "US",
"freeform": " ",
"mak": " ",
"mek": " ",
"phone": "8006354772",
"postal": "92688",
"rec": "1",
"state": "California",
"stock": " ",
"suite": " ",
"web": " "
}
],
"t": "Business Coder Test"
}'A response is the result of a request. This consists of returned results codes and parsed, corrected, and/or appended request elements, depending on the options selected.
Returns the generic service level result/error codes. For more information, see Business Coder Result Codes.
The returned array of records.
The company name in our reference data. You can use this to easily compare your input company name against Melissa records for that address.
Code denoting the business location type. 0 - Headquarters, 1 - Branches, 2 - Subsidiary Headquarters, 3 - Single Location.
A unique key assigned to the base address of a complex with apartments or suites.
North American Industry Classification System code. This is related to SICCode1.
This is a string value containing a unique identifier for the current record. Use this to match the record submitted with the record returned. It will return what is inputted.
Returns record specific result codes. For more information, see Business Coder Result Codes.
Response
application/json
{ "TransmissionResults": " ", "TransmissionReference": "Business Coder Test", "Version": "9.0.1.1091", "TotalRecords": "1", "Records": [ { … } ] }