Website Visitor Lookup
| Product | D&B Data Exchange |
| Data Provider | Profound Networks |
| Product Code(s) | n/a |
| Level(s) | n/a |
| Monitoring Available | No |
| Interface | REST |
| Method | GET |
| Format(s) | JSON |
| Service | DataExchange |
| {version} | 1.0 |
| Initial Release | October 3, 2013 |
In partnership with Dun & Bradstreet, Profound developed a proprietary technology to assign domains to D&B D-U-N-S Numbers. Once a domain has a D-U-N-S Number, a Digital Business Intelligence (DBI) profile can be appended to that domain with 45 technology attributes useful for segmentation, modeling, analytics, etc. Information is available only on IPv4 (version) addresses.
IMPORTANT: Please note this operation is decommissioned effective July 10th, 2020.
Update History
No modifications have been made to this data layer since the initial release.
Feature Request
IMPORTANT: Please see the new Online Services Security Enhancement Release, effective November 09, 2020.
Overview
When requesting this D&B Data Exchange feature, one of the following will be required: email address, domain name, IPv4 address or valid D-U-N-S Number for a company. An optional parameter is available to control the amount of information returned in the response.
The data is for US only; however, global records without a D-U-N-S Number can be obtained using the domain name.
Global Availability
This data layer is only available for businesses domiciled in the United States.
Data Layer Entitlement
For customers in U.S. and Canadian markets, the API is provisioned for specific collections of products, reports, and/or features (collectively referred to as data layers) for production and trial usage. Entitlement is not required for testing in the sandbox environment.
- This feature is entitled as "Data Exchange" for D&B Direct 2.0 customers.
For customers in the UK, Ireland, Belgium, Netherlands and Luxembourg markets, the API is provisioned as a specific set of data layers for production, trial, and sandbox usage.
- This particular data layer is NOT included in the D&B Direct Onboard suite.
Data Exchange Request Setup
D&B Direct specific request parameters are submitted to D&B Data Exchange service requests in the HTTP Header. Partner specific request parameters are submitted in the URL (GET) or body (POST).
GET/POST/PUT/DELETE https://direct.dnb.com/dataexchange/{PartnerIndentifier}/{Partners’s URI}?{Partner’s Query Parameters}
ApplicationTransactionID: <Transaction ID assigned by the customer>
Accept: application/json
Authorization: <Customer’s Authentication Token>
ArchiveProductOptOutIndicator: <true/false>
ExtendArchivePeriodIndicator: <true/false>
Content-Type: application/json
[BODY]
<Partner Request (POST only)>GET https://direct.dnb.com/dataexchange/profound/domain/abbott.com Authorization: <MyToken> ApplicationTransactionID: ID_001 ArchiveProductOptOutIndicator: false ExtendArchivePeriodIndicator: false CustomerReferenceText: Order placed by Joe CustomerBillingEndorsementText: Order placed by Joe for abbot.com
Specification
GET https://direct.dnb.com/dataexchange/profound/domain?email=ecyclenow@4thbin.com&view=premium Authorization: <MyToken> Accept: application/json ApplicationTransactionID: ID_001 ArchiveProductOptOutIndicator: false ExtendArchivePeriodIndicator: false CustomerReferenceText: Order placed by Joe CustomerBillingEndorsementText: Order placed by Joe
GET https://direct.dnb.com/dataexchange/profound/domain/accenture.com?view=enterprise Authorization: <MyToken> Accept: application/json ApplicationTransactionID: ID_001 ArchiveProductOptOutIndicator: false ExtendArchivePeriodIndicator: false CustomerReferenceText: Order placed by Joe CustomerBillingEndorsementText: Order placed by Joe for accenture.com
GET https://direct.dnb.com/dataexchange/profound/domain?ip=158.151.240.118&view=premium Authorization: <MyToken> Accept: application/json ApplicationTransactionID: ID_001 ArchiveProductOptOutIndicator: false ExtendArchivePeriodIndicator: false CustomerReferenceText: Order placed by Joe CustomerBillingEndorsementText: Order placed by Joe
GET https://direct.dnb.com/dataexchange/profound/domain?duns=001307602&view=premium Authorization: <MyToken> Accept: application/json ApplicationTransactionID: ID_001 ArchiveProductOptOutIndicator: false ExtendArchivePeriodIndicator: false CustomerReferenceText: Order placed by Joe CustomerBillingEndorsementText: Order placed by Joe
| EMA | DOM | IP | DUNS | Name | Characteristics |
|---|---|---|---|---|---|
| Y | string, required, embedded in endpoint | ||||
| Y | domain_name | string, required, embedded in endpoint Note: (excluding "http://" and "www.") | |||
| Y | IP | string, required, embedded in endpoint | |||
| Y | duns | string, required, embedded in endpoint | |||
| Y | Y | Y | Y | view | string, optional Possible values: basic, premium, enterprise |
Endpoint
For each D&B Data Exchange partner operations, a partner identifier and URI are appended to a standard Data Exchange REST URL. As a result of this approach, there may be instances where a partner URI contains version information that is different from the D&B Data Exchange version.
Use the following endpoint for requesting this feature.
| EMA | DOM | IP | DUNS | REST (DataExchange) |
|---|---|---|---|---|
| Y | GET https://direct.dnb.com/dataexchange/profound/domain?email={EMAIL}&view={basic|premium|enterprise} | |||
| Y | GET https://direct.dnb.com/dataexchange/profound/domain/{domain_name}?view={basic|premium|enterprise} | |||
| Y | GET https://direct.dnb.com/dataexchange/profound/domain?ip={IP}&view={basic|premium|enterprise} | |||
| Y | GET https://direct.dnb.com/dataexchange/profound/domain?duns={DUNS}&view={basic|premium|enterprise} |
Testing
The following suggested parameters may be used for test environment (sandbox) requests to retrieve successful responses.
| Test Parameter(s) |
|---|
| abbott.com |
Feature Response
Specification
NOTE: The information returned from this Data Exchange feature will not be presented in the product canonical model used by other D&B Direct services.
The following is a list of the possible data fields returned by this operation.
NOTE: The D-U-N-S Number returned in the response will be a nine-digit zero-padded, numeric value.
HTTP/1.1 200 OK
ApplicationTransactionID: ID_001
CustomerBillingEndorsementText: Order placed by Joe
CustomerReferenceText: Order placed by Joe
Date: Tue, 12 Nov 2013 15:54:00 GMT
DNB-PortfolioAssetID: 36590291
DNB-ResultID: CM000
DNB-ResultText: success
DNB-ServiceTransactionID: Id-4d7cd8c752824f1822fb470b
{"domain":"4thbin.com","duns":"032580457","external_links_level2_count":"42","mail_server":"4thbin-com.mail.protection.outlook.com","country_code":"US","domain_classification_score":"7.172","mail_server_ip":"207.46.163.138;207.46.163.247;207.46.163.215","url":"http://4thbin.com/","mail_server_domain":"outlook.com","web_technology_widgets":"Viewport Meta;Yoast Plugins;Cascading Style Sheets;Meta Description;Canonical Content Tag;Atom Introspection;HTML5 DocType;Really Simple Discovery;Pingback Support;boldchat.com;Conditional Comments;FlexSlider;Open Graph Protocol;IFrame","hosting_range_domain":"secureserver.net","company_name":"4th Bin","mail_server_provider":"Microsoft","domain_classification":"Business","web_server_count":"1","advertising":"Adroll","cms":"WordPress;Wordpress Plugins","hosting_domain":"secureserver.net","website_ip":"50.63.40.43","ip_block_owner_domain":"godaddy.com","local_links_homepage_count":"28","local_links_level2_count":"26","external_links_homepage_count":"38","subdomain_count":"2","unique_email_user_count":"2","web_analytics":"Google Analytics","web_server_type":"Apache","ssl_certificate_issuer":"GoDaddy.com, Inc.","hosting_company":"Go Daddy","ip_block_owner":"Go Daddy Software, Inc.","subdomain_networks":"4thbin.com;secureserver.net","social_networks":"LinkedIn;Twitter Platform;Twitter Widget","datestamp":"20140829","view":"enterprise"}
HTTP/1.1 200 OK
ApplicationTransactionID: ID_001
CustomerBillingEndorsementText: Order placed by Joe for abbot.com
CustomerReferenceText: Order placed by Joe
Date: Tue, 12 Nov 2013 15:54:00 GMT
DNB-PortfolioAssetID: 36590291
DNB-ResultID: CM000
DNB-ResultText: success
DNB-ServiceTransactionID: Id-4d7cd8c752824f1822fb470b
{"domain":"accenture.com","duns":"985015354","external_links_level2_count":"490","mail_server":"accenture-com.mail.protection.outlook.com","country_code":"US","domain_classification_score":"2.129","mail_server_ip":"207.46.163.138;207.46.163.247;207.46.163.215","url":"http://www.accenture.com/us-en/pages/index.aspx","mail_server_domain":"outlook.com","company_name":"Accenture","mail_server_provider":"Microsoft","domain_classification":"Business","web_server_count":"1","website_ip":"199.200.17.56","local_links_level2_count":"1868","local_links_homepage_count":"207","external_links_homepage_count":"14","unique_email_user_count":"86173","ssl_certificate_issuer":"Cybertrust Inc","datestamp":"20140820","view":"premium"}
HTTP/1.1 200 OK
ApplicationTransactionID: ID_001
CustomerBillingEndorsementText: Order placed by Joe for abbot.com
CustomerReferenceText: Order placed by Joe
Date: Tue, 12 Nov 2013 15:54:00 GMT
DNB-PortfolioAssetID: 36590291
DNB-ResultID: CM000
DNB-ResultText: success
DNB-ServiceTransactionID: Id-4d7cd8c752824f1822fb470b
{"domain":"dnb.com","external_links_level2_count":"194","mail_server":"dbpwirnap01.dnb.com;dbpwirnap02.dnb.com;dbrwirnap01.dnb.com;dbrwirnap02.dnb.com","domain_classification_score":"7.086","mail_server_ip":"158.151.208.121;158.151.208.120;158.151.214.66;158.151.214.67","url":"http://www.dnb.com/","mail_server_domain":"dnb.com","hosting_range_domain":"dnb.com","company_name":"Dun and Bradstreet Inc.","domain_classification":"Business","web_server_count":"1","website_ip":"159.137.136.250","hosting_domain":"dunandbradstreet.com","local_links_level2_count":"234","local_links_homepage_count":"62","external_links_homepage_count":"43","unique_email_user_count":"6147","web_server_type":"Apache","ssl_certificate_issuer":"DigiCert Inc","datestamp":"20140820","country_code":"US","duns":"150483782","view":"premium"}
HTTP/1.1 200 OK
ApplicationTransactionID: ID_001
CustomerBillingEndorsementText: Order placed by Joe for abbot.com
CustomerReferenceText: Order placed by Joe
Date: Tue, 12 Nov 2013 15:54:00 GMT
DNB-PortfolioAssetID: 36590291
DNB-ResultID: CM000
DNB-ResultText: success
DNB-ServiceTransactionID: Id-4d7cd8c752824f1822fb470b
{"domain":"abbott.com","duns":"001307602","external_links_level2_count":"100","mail_server":"abtmx21i.abbott.com;abtmx10i.abbott.com;abtmx11i.abbott.com;abtmx20i.abbott.com","country_code":"US","domain_classification_score":"1.474","mail_server_ip":"130.36.44.102;130.36.31.47;130.36.44.101;130.36.31.53","url":"http://www.abbott.com/","mail_server_domain":"abbott.com","hosting_range_domain":"abbott.com","company_name":"Abbott Laboratories","domain_classification":"Business","web_server_count":"1","website_ip":"130.36.62.17","hosting_domain":"messagesofhopephotos.com","local_links_level2_count":"50","local_links_homepage_count":"24","external_links_homepage_count":"3","unique_email_user_count":"29120","web_server_type":"Apache","ssl_certificate_issuer":"GeoTrust Inc.","datestamp":"20140829","view":"premium"}
| Name | Characteristics |
|---|---|
| duns | int 9 DUNS Number |
| domain | varchar 67 The domain of business website |
| company_name | varchar 88 The name of the company published on their website |
| country | varchar 2 The country of the company's HQ published on their website |
| url | varchar 300 The URL of the Website |
| redirect | varchar 77 The Domain redirect to this Domain |
| domain_classification | varchar 18 High level classification for a Domain: Business, Non-Business, Under Construction, etc |
| domain_classification_score | float 6 The level of accuracy of the Domain Classification |
| web_server | varchar 329 The type of web server |
| web_server_count | int 4 The number of webservers |
| website_ip | varchar 15 The IP address of the website |
| hosting_domain | varchar 73 The Domain of the hosting provider |
| hosting_company | varchar 47 The web hosting company name |
| hosting_range_domain | varchar 75 The domain of the IP range that hosts the website |
| subdomain_networks | varchar 40 The networks of the various subdomains found on the website. |
| subdomain_counts | int 3 The total number of unique subdomains on the website |
| cloud_provider | varchar 13 The name of the cloud provider |
| ip_block_owner | varchar 136 The owner of the IP block of the website's IP address |
| ip_block_owner_domain | varchar 35 The domain of the IP block owner |
| mail_server | varchar 153 The email server hostname |
| unique_email_user_count | int 8 The number of unique email addresses tied to the domain |
| mail_server_domain | varchar 66 The Domain of the email service provider |
| mail_server_ip | varchar 15 The IP address of the email service provider |
| mail_server_provider | varchar 46 The name of the email service provider |
| ssl_certificate_issuer | varchar 138 The SSL certificate vendor |
| device_count_current_qtr | int 5 The total # of public IPs tied to the domain in most recent qtr |
| device_count_previous_qtr | int 5 The total # of public IPs tied to the domain in previous qtr |
| device_count_previous_qtr_-1 | int 5 The total # of public IPs tied to the domain in previous qtr |
| device_count_previous_qtr_-2 | int 5 The total # of public IPs tied to the domain in previous qtr |
| device_count_previous_qtr_-3 | int 5 The total # of public IPs tied to the domain in previous qtr |
| device_count_previous_qtr_-4 | int 5 The total # of public IPs tied to the domain in previous qtr |
| device_count_previous_qtr_-5 | int 5 The total # of public IPs tied to the domain in previous qtr |
| device_count_previous_qtr_-6 | int 5 The total # of public IPs tied to the domain in previous qtr |
| network_growth_% | float 10 The rate of network growth over the last year |
| ecommerce | varchar 36 The eCommerce vendor |
| web_analytics | varchar 36 The Web Analytics and tracking vendor |
| social_networks | varchar 24 The Social Network providers |
| cms | varchar 35 Content Management System |
| advertising | varchar 26 Website Advertising partner |
| web_technology_widgets | varchar 23 Website tools |
| local_links_homepage_count | int 4 Number of links to Domain on homepage |
| local_links_level_2 | int 5 Number of links to Domain on second level |
| external_links_homepage_count | int 4 Number of links to other Domains on homepage |
| external_links_level_2 | int 5 Number of links to other Domains in second level |
Data Exchange Response Delivery
D&B Direct specific fields are returned in D&B Data Exchange service responses via the HTTP Header. D&B Direct error information will be returned in case of the following scenarios – Failure to connect to Partner; Authentication / entitlement failure for the user -- and the Partner response will not be returned.
ApplicationTransactionID: <ID passed in request> DNB-ServiceTransactionID: <ID assigned by the Service> DNB-ResultID: <PCM Result Code> DNB-ResultText: <PCM Result Text> DNB-PortfolioAssetID: <Portfolio Asset ID> [BODY] <Partner Response (JSON/XML/SOAP)>
HTTP/1.1 200 OK
ApplicationTransactionID: ID_001
CustomerBillingEndorsementText: Order placed by Joe for abbot.com
CustomerReferenceText: Order placed by Joe
Date: Tue, 12 Nov 2013 15:54:00 GMT
DNB-PortfolioAssetID: 36590291
DNB-ResultID: CM000
DNB-ResultText: success
DNB-ServiceTransactionID: Id-4d7cd8c752824f1822fb470b
{"domain":"abbott.com","country_code":"US","datestamp":20130303,"company_name":"Abbott Laboratories","duns":"001307602","url":"http://www.abbott.com/","view":"basic"}
Response Codes & Error Handling
Responses from this Data Exchange feature will return a D&B response code, along with a partner response code, unless the partner service is not accessible at the time of the request.
Successful service requests will return a CM000 response code in the DNB-ResultID header field. Otherwise, one of the D&B Direct standard response codes will be returned.
This operation may return the following response codes: CM004, SC001-SC009.
NOTE: When a CM004 response code is received, the HTTP status code will be the value returned by the Data Exchange partner.
D&B Direct 2.0 API requests are provided on a metered basis; and may require entitlement prior to use in the production environment. In addition, a concurrency limit (QPS) is monitored to ensure that it is not exceeded. An error code will be returned in the event that a transaction is throttled.
Qualified usage (e.g., a successful response) is tracked and billed according to the terms & conditions of the customer's contract. The response code CM000 is considered successful. A built-in feature exists to prevent duplicate billing when multiple successful feature requests with the same D-U-N-S Number are submitted on the same calendar day (which is based on Eastern Standard Time [GMT-5]).
Feature Notes
This D&B Data Exchange feature will pass-thru the partner HTTP status code whenever a CM004 error is delivered in the DNB-ResultID header field. The following are the possible values from this partner.
- 400 -
MissingParameter- request is missing a required parameter - 401 -
InvalidCredentials- request has missing or invalid credentials - 404 -
ResourceNotFound- no matching resource found for the request - 409 -
InvalidArgument- request includes an invalid argument - 412 -
PreconditionFailedError- resource found, but did not satisfy request conditions - 500 -
InternalError- request produced an internal system error
- © Dun & Bradstreet, Inc. 2019 – 2024. All rights reserved.