Business Coder:Notice
New Feature Available: Contacts
With the latest update 1.3.6 live for Business Coder a new feature is available: Contacts. Contacts offers information on the employees of a business. Contacts by default returns up to 5 contacts per business, depending on how many our databases has access to. This number can be changed by use of our new option: MaxContacts. This will allow you to change the number of contacts potentially returned. Each contact will return a JSON Array containing: First Name, Last Name, Title, Gender, and Email. It’s worth noting, that we included the response to have an output available for “Email”. This will not return anything – yet. We included this now in preparation for a future update.
Using Contacts
The Contacts array can be returned by adding “Contacts” to your requests. In a REST request, you will want to add “Contacts” to the “&cols=” part of your request.
Contacts REST Request Example
An example REST Request for columns may look like:
http://businesscoder.melissadata.net/WEB/BusinessCoder/doBusinessCoderUS?comp=melissa%20data&a1=&a2=&city=&state=&postal=92688&ctry=US&id=<YourLicenseKeyHere>&rec=69&cols=Contacts&t=1234&mak=&opt=ReturnDominantBusiness:yes
Contacts JSON Request Example
A valid JSON Request may look similar to:
{
"t":"Business Coder Tester",
"id":"",
"cols":"LocationType,Phone,StockTicker,WebAddress,EmployeesEstimate,SalesEstimate,Contacts",
"opt":"ReturnDominantBusiness:yes",
"Records":[
{
"rec":"",
"comp":"",
"a1":"22382 Avenida Empresa",
"a2":"",
"city":"Rancho Santa Margarita",
"state":"CA",
"postal":"92688",
"ctry":"",
"phone":"",
"mak":"",
"stock":"",
"web":"",
}
]
}
MaxContacts Option
To utilize our new option MaxContacts, just add MaxContacts:## into the request style of your choice.
MaxContacts REST Request Example
http://businesscoder.melissadata.net/WEB/BusinessCoder/doBusinessCoderUS?comp=melissa%20data&a1=&a2=&city=&state=&postal=92688&ctry=US&id=<YourLicenseKeyHere>&rec=69&cols=Contacts&t=1234&mak=&opt=ReturnDominantBusiness:yes,MaxContacts:3
MaxContacts JSON Request Example
{
"t":"Business Coder Tester",
"id":"",
"cols":"LocationType,Phone,StockTicker,WebAddress,EmployeesEstimate,SalesEstimate,Contacts",
"opt":"ReturnDominantBusiness:yes,MaxContacts:3",
"Records":[
{
"rec":"",
"comp":"",
"a1":"22382 Avenida Empresa",
"a2":"",
"city":"Rancho Santa Margarita",
"state":"CA",
"postal":"92688",
"ctry":"",
"phone":"",
"mak":"",
"stock":"",
"web":"",
}
]
}
MaxContacts JSON Response Example
A JSON Response looks like this:
{
"TransmissionResults": "",
"TransmissionReference": "Business Coder Tester",
"Version": "1.3.6",
"TotalRecords": "1",
"Records": [
{
"AddressLine1": "22382 Avenida Empresa",
"City": "Rancho Santa Margarita",
"CompanyName": "Melissa Data",
"PostalCode": "92688",
"RecordID": "1",
"Results": "FS01,FS02,FS03,FS04,FS06,FS07,AS01",
"State": "CA",
"Suite": "",
"TotalContacts": "49",
"Contacts": [
{
"NameFirst": "Raymond",
"NameLast": "Melissa",
"Gender": "M",
"Title": "Owner",
"Email": ""
},
{
"NameFirst": "Chris",
"NameLast": "Rowe",
"Gender": "N",
"Title": "",
"Email": ""
},
{
"NameFirst": "Frank",
"NameLast": "Tran",
"Gender": "M",
"Title": "",
"Email": ""
}
]
}
]
}
For more information on building requests and responses, please see the following pages: