Resources

The Data.com Match API is a REST API with two resources: DatacloudContact and DatacloudCompany. Use these resources to return contact and company information, respectively, from Data.comand identify and flag differences between fields in the request and fields from the matching Data.com record. Use POST requests with this API.

When your Data.com Prospector or Data.com Clean contract expires, Data.com features, objects, and fields will be removed from your org. To support customers’ needs around compliance and to remain a leader in trust and privacy, Salesforce removed all contact data from the Data.com service on February 1, 2021.

For more information, see Data.com Prospector and Clean Retirement.

There is a 24–hour rolling quota on the number of API calls you can make. Your organization gets 1,000 daily calls for every license purchased. Call quotas are implemented at the Salesforce organization level. For example, an organization with 10 Data.com Clean licenses would have a daily limit of 10,000 Match API calls (1,000 x 10 = 10,000).

Usage

The Data.com Match API DatacloudContact resource does two basic things.

  • Matches requested contacts with contacts in the Data.com database.
  • Identifies and flags differences between fields in the request and fields in the Data.com database.
URLs

Short URL: services/data/vXX.X/match/

Long URL: services/data/vXX.X/match/DatacloudMatchEngine/DatacloudContact/

Availability

API version 30.0 and later.

Formats

JSON, XML

HTTP methods

POST

Minimum Required Fields

No required fields. For the best results, include a standard email address in the request.

Maximum Request Size

30

Key Request Fields

The key request fields are:

  • Email
  • First Name
  • Last Name
  • Phone
  • Title
Usage

The Data.com Match API DatacloudCompany resource does two things.

  • Matches the requested company information with companies in the Data.com database.
  • Identifies and flags differences between requested fields and fields in the Data.com database.
URLs

Short URL: services/data/vXX.X/match/
Long URL: services/data/vXX.X/match/DatacloudMatchEngine/DatacloudCompany/

Availability

API version 30.0 and later.

Formats

JSON, XML

HTTP methods

POST

Minimum required fields

No required fields. For best results, include company name, website, and city in the request. For companies with multiple locations, add the city where the company is located to narrow your search.

Key request fields

The key request fields are:

  • Name
  • Street
  • Phone
  • Website