Enrich Records - Individual
Get signals for an individual business entity to a specified callback URL.
https://apis.buzzboard.com/v5.0/records/enrich
Parameters
| Field | Type | Description |
|---|---|---|
| business_name |
String |
Name of the business record |
| website |
String |
Business website URL |
| phone |
String |
Business phone number |
| business_email |
String |
Business email address |
| address |
String |
Business street number, street, suite, or apartment number |
| city |
String |
Business city name |
| state |
String |
Business state name |
| zip |
String |
Business zip/postal code |
| country |
String |
Business country name |
| external_document_id |
String |
Unique identifier for the record by API consumer |
| callback_url Required |
String |
Call back URL to receive the enriched data once BuzzBoard enrichment is completed |
Creates a new record 'David Weinstein Dmd' with the reference job id.
curl -X POST "https://apis.buzzboard.com/v5.0/records/enrich"
-H "authorization: Bearer ACCESS_TOKEN"
-H "X-Authorization: Bearer ACCESS_TOKEN"
-H "Content-Type: application/json"
-d '{ "business_name": "David Weinstein Dmd", "website": "http://newyorkperiodontist.com", "phone": "(212) 980-2800", "business_email": "contactus@newyorkperiodontist.com", "address": "136 E 64Th St", "city": "New York", "zip": "10065", "state": "NY", "country": "United States", "external_document_id": "dec06202101", "callback_url": "https://webhook.site/2deda3be-0baa-404a-be47-024c865b2fbe" }'
var request = require('request');
var options = {
method: 'POST',
url: 'https://apis.buzzboard.com/v5.0/records/enrich',
headers: {
'cache-control': 'no-cache',
'authorization': 'Bearer ACCESS_TOKEN',
'X-Authorization': 'Bearer ACCESS_TOKEN',
'content-type': 'application/json'
},
body: {
{
business_name: 'David Weinstein Dmd',
website: http: //newyorkperiodontist.com,
phone: (212) 980 - 2800,
business_email: contactus @newyorkperiodontist.com,
address: 136 E 64 Th St,
city: New York,
zip: 10065,
state: NY,
country: United States,
external_document_id: dec06202101,
callback_url: https: //webhook.site/2deda3be-0baa-404a-be47-024c865b2fbe
},
json: true
};
request(options, function(error, response, body) {
if (error) throw new Error(error);
});
$request = new HttpRequest();
$request->setUrl("https://apis.buzzboard.com/v5.0/records/enrich");
$request->setMethod(HTTP_METH_POST);
$request->setHeaders(array("cache-control" => "no-cache",
"authorization" => "Bearer ACCESS_TOKEN",
"X-Authorization": "Bearer ACCESS_TOKEN"
"content-type" => "application/json"
));
$request->setBody(
"{
"business_name": "David Weinstein Dmd",
"website": "http://newyorkperiodontist.com",
"phone": "(212) 980-2800",
"business_email": "contactus@newyorkperiodontist.com",
"address": "136 E 64Th St",
"city": "New York",
"zip": "10065",
"state": "NY",
"country": "United States",
"external_document_id": "dec06202101",
"callback_url": "https://webhook.site/2deda3be-0baa-404a-be47-024c865b2fbe"
}"
);
try {
$response = $request->send();
echo $response->getBody();
} catch (HttpException $ex) {
echo $ex;
}
require "uri"
require "net/http"
url = URI("https://apis.buzzboard.com/v5.0/records/enrich")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Post.new(url)
request["content-type"] = "application/json"
request["authorization"] = "Bearer ACCESS_TOKEN"
request["X-Authorization"] = "Bearer ACCESS_TOKEN"
request["cache-control"] = "no-cache"
request.body = "{\r\n \"business_name\":\r\n \"Cutboard Studio\",\r\n \"website\":\r\n \"cutboardstudio.com\",\r\n \"address\":\r\n \"1521 E Illinois Ave #205\",\r\n \"city\":\r\n \"Spokane\",\r\n \"state\":\r\n \"WA\",\r\n \"zip\":\r\n \"99207\",\r\n \"business_email\":\r\n \"contactus@cutboardstudio.com\",\r\n \"phone\":\r\n \"(786) 633-1533\",\r\n \"country\":\r\n \"United States\",\r\n \"external_document_id\":\r\n \"dec0120210355\",\r\n \"external_document_id\":\r\n \"dec0120210354\",\r\n \"callback_url\":\r\n \"https://webhook.site/2deda3be-0baa-404a-be47-024c865b2fbe\"}"
response = http.request(request)
puts response.read_body
import requests
url = "https://apis.buzzboard.com/v5.0/records/enrich"
payload = "{\r\n \"business_name\":\r\n \"Cutboard Studio\",\r\n \"website\":\r\n \"cutboardstudio.com\",\r\n \"address\":\r\n \"1521 E Illinois Ave #205\",\r\n \"city\":\r\n \"Spokane\",\r\n \"state\":\r\n \"WA\",\r\n \"zip\":\r\n \"99207\",\r\n \"business_email\":\r\n \"contactus@cutboardstudio.com\",\r\n \"phone\":\r\n \"(786) 633-1533\",\r\n \"country\":\r\n \"United States\",\r\n \"external_document_id\":\r\n \"dec0120210355\",\r\n \"external_document_id\":\r\n \"dec0120210354\",\r\n \"callback_url\":\r\n \"https://webhook.site/2deda3be-0baa-404a-be47-024c865b2fbe\"}"
headers = {
"content-type": "application/json",
"authorization": "Bearer ACCESS_TOKEN",
"X-Authorization": "Bearer ACCESS_TOKEN",
"cache-control": "no-cache"
}
response = requests.request("POST", url, data=payload, headers=headers)
package main
import (
"fmt"
"strings"
"net/http"
"io/ioutil"
)
func main() {
url := "https://apis.buzzboard.com/v5.0/records/enrich"
payload := strings.NewReader("{\r\n \"business_name\":\r\n \"Cutboard Studio\",\r\n \"website\":\r\n \"cutboardstudio.com\",\r\n \"address\":\r\n \"1521 E Illinois Ave #205\",\r\n \"city\":\r\n \"Spokane\",\r\n \"state\":\r\n \"WA\",\r\n \"zip\":\r\n \"99207\",\r\n \"business_email\":\r\n \"contactus@cutboardstudio.com\",\r\n \"phone\":\r\n \"(786) 633-1533\",\r\n \"country\":\r\n \"United States\",\r\n \"external_document_id\":\r\n \"dec0120210355\",\r\n \"external_document_id\":\r\n \"dec0120210354\",\r\n \"callback_url\":\r\n \"https://webhook.site/2deda3be-0baa-404a-be47-024c865b2fbe\"}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("content-type", "application/json")
req.Header.Add("authorization", "Bearer ACCESS_TOKEN")
req.Header.Add("X-Authorization", "Bearer ACCESS_TOKEN")
req.Header.Add("cache-control", "no-cache")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}
HttpResponseresponse = Unirest.post("https://apis.buzzboard.com/v5.0/records/enrich") .header("content-type", "application/json") .header("authorization", "Bearer ACCESS_TOKEN") .header("X-Authorization", "Bearer ACCESS_TOKEN") .header("cache-control", "no-cache") .body("{\r\n \"business_name\":\r\n \"Cutboard Studio\",\r\n \"website\":\r\n \"cutboardstudio.com\",\r\n \"address\":\r\n \"1521 E Illinois Ave #205\",\r\n \"city\":\r\n \"Spokane\",\r\n \"state\":\r\n \"WA\",\r\n \"zip\":\r\n \"99207\",\r\n \"business_email\":\r\n \"contactus@cutboardstudio.com\",\r\n \"phone\":\r\n \"(786) 633-1533\",\r\n \"country\":\r\n \"United States\",\r\n \"external_document_id\":\r\n \"dec0120210355\",\r\n \"external_document_id\":\r\n \"dec0120210354\",\r\n \"callback_url\":\r\n \"https://webhook.site/2deda3be-0baa-404a-be47-024c865b2fbe\"}") .asString();
{
"success": true,
"ref_job_id": "ugyLHAXoc0N6mGG8fbFU5Xss"
}
Response Parameters
| Key | Data type | Description |
|---|---|---|
| success |
String |
Status of the API |
| ref_job_id |
String |
Reference Job Id for the set records or the request |
{
"data": [
[
{
"sections": [
{
"section_key": "business_section",
"section_title": "BUSINESS INFO",
"signals": {
"business_name": "Trico Graphics And Marketing Communications",
"website_formatted": "-",
"website": "trico.com",
"is_favorite": "-",
"phone": [
{
"value": "3124215680",
"is_default": true
}
],
"default_email": "-",
"email_list": "-",
"status": 1,
"geo_lat": 41.8868118,
"geo_lng": -87.6811172,
"is_verified": "-",
"report_type": "-",
"address": {
"line1": "2140 W Fulton St",
"city": "Chicago",
"zip": "60612",
"state": "IL",
"country": "us"
},
"dscore": 31,
"additional_url": "-"
}
},
{
"section_key": "firmographics_section",
"section_title": "FIRMOGRAPHICS",
"signals": {
"locations_count": 2,
"location_type": "Commercial",
"annual_revenue": "$5M - $10M",
"monthly_technology_spend": "$0 - $1K",
"business_age": "> 10 Y",
"model": "B2B & B2C",
"revenue_seasonality": "-",
"remote_only_business": "No"
}
},
{
"section_key": "social_media_channels",
"section_title": "Social",
"signals": {
"social_score": {
"value": 18
},
"facebook_page_presence": {
"value": "No",
"facebook_likes": "-",
"facebook_checkins": "-",
"fp_page_url": "-"
},
"twitter_page_presence": {
"value": "No",
"twitter_followers": "-",
"twitter_tweets": "-",
"twitter_page_url": "-"
},
"youtube_page_presence": {
"value": "No",
"youtube_page_url": "-"
},
"linkedin_page_presence": {
"value": "Yes",
"linkedin_page_url": "https://www.linkedin.com/company/trico"
},
"pinterest_page_presence": {
"value": "No",
"pinterest_follower_count": "-",
"pinterest_following_count": "-",
"pinterest_pin_count": "-",
"pinterest_board_count": "-",
"pinterest_domain_verified": "-",
"pinterest_is_verified_merchant": "-"
},
"instagram_page_presence": {
"value": "No",
"insta_no_of_posts": "-",
"insta_follower_count": "-",
"insta_following_count": "-",
"insta_page_url": "-"
}
}
}
],
"meta": {
"record_id": "61b73eaf951ab42b495c4362",
"external_document_id": "13dec202102",
"ref_job_id": "Svj5q9S4Qul2tFslAcJ42eze",
"status_code": [
200
]
}
}
]
]
}