<img height="1" width="1" alt="" style="display:none" src="https://www.facebook.com/tr?id=799187456795375&amp;ev=PixelInitialized">

EAM API Documentation

The Email Activity Metrics (EAM) API fields are used to evaluate the legitimacy of an email address based on when and how often it has passed through our database. Need to query multiple people in a single request? Check out the EAM API, Bulk Version.

Usage

Refer to the Personalization API documentation for instructions on general usage.

Note: The zip field can be used to supply both a standard 5-digit zip, as well as a 9-digit "zip+4".

Overview of Response Fields

The following table provides an overview of the EAM API response fields. Further details for each field are provided below.

Field KeyDescription
date_first_seen The date (YYYY-MM-DD) that TowerData first encountered the email address.
longevity A score (0-3) describing when TowerData first encountered the email address.
velocity A score (0-10) reflecting the activity of the email over the last 3 months as viewed by TowerData.
popularity A score (0-10) reflecting the popularity of the email as viewed by TowerData in the past 12 months.
month_last_open The month (YYYY-MM) that TowerData last detected an open by the email address.

Field Details

This section provides more detailed explanation of each of the EAM API response fields.

date_first_seen

This field gives the date that TowerData first encountered the given email address, in the format YYYY-MM-DD, e.g. "2010-02-18". The field will return "now" if the email address has not been encountered before.

longevity

This field returns a score indicating when TowerData first encountered the given email address. It is directly correlated with date_first_seen.

Field ValueDescription
0 TowerData has not encountered this email address before.
1 TowerData first encountered this email within the last month.
2 TowerData first encountered this email within the last year.
3 TowerData first encountered this email over a year ago.

velocity

This field returns the score describing the activity of the given email address over the past 3 months, from 0 (no activity) to 10 (most active).

popularity

This field returns the score describing the popularity of the email based on the number of sources from whom TowerData has seen the email in the past 12 months, from 0 (no partner queries) to 10 (most popular).

month_last_open

This field gives the month that TowerData last saw this email address open an email message sent to it, in the format YYYY-MM, e.g. "2013-11". The field will not be returned if an open has not been detected.

Examples

Request

Client queries the API with the following parameters:

ParameterValue
email customer@gmail.com
Responses

The following table shows sample responses given varying data associated with the provided customer@gmail.com email address ("TowerData Data" in the table).

TowerData DataJSON ResponseExplanation
[none]
{"date_first_seen": "now",
"velocity": "0",
"popularity": "0",
"longevity": "0"}
TowerData does not have a record of this email, or the user has explicitly opted out of TowerData services.
John Smith
{"date_first_seen": "2010-05-22",
"month_last_open": "2014-08",
"velocity": "3",
"popularity": "5",
"longevity": "3"}
TowerData has a record of this email.
We can set you up with an API Key. Sign up