Business Coder:Notice

From Melissa Data Wiki
Jump to navigation Jump to search

← Business Coder


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: