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

Bulk Email Activity Metrics API Documentation

This API will allow you to query TowerData's EAM API in bulk, for up to 10,000 people at a time. Note: This API supports one concurrent request per customer. A second request for a given customer may only execute once the first has finished.

Requests

This API can be queried with HTTP POST requests with a JSON array as the Body. Make sure to set the Content-Type header to “application/json”.

Request URL

The API key must be supplied as part of the Request URL.

https://api.towerdata.com/v5/ei/bulk?api_key=78ad9ddc21e3c220cc5da024b6dbe13c

Request Body

The API input is a JSON array of the email-based Personalization API Parameters used in the EVP API, namely email, md5_email, or sha1_email. This array can have up to 10,000 elements.

For example, here's an array with two elements:

 

[
  {"email":"pete@rapleafdemo.com"},
  {"md5_email":"5003bd7a456bdcc37e4f51984de9efcb"}
]

The first element asks whether we've seen the email and whether it matches the name in our records. The second element doesn't include an email, so it just asks whether the name matches the postal address.

Responses

Successful responses are returned as a JSON array of EAM Response Fields guaranteed to be in the same order as the input data. If there is an error for a specific record, we return {“error_code”:XXX, “error_msg”:”The error message”}. For example, if the email is not a valid email address, we return {“error_code”:400, “error_msg”:”Invalid identifier”}.

HTTP Status Codes

General errors are provided via HTTP Status Code, as in the Personalization API HTTP Status Codes. In addition, bulk API error messages for 400 Bad Request include:

  • 1. “Invalid JSON.”: Common cause is not setting the content type to “application/json”.
  • 2. “Too many records requested. Limit is 10000 and you requested 10001.”
  • 3. "Duplicate identfiers": The data sent in the body must be unique.

Example Response

Post Body:

 

[
  {"email":"pete@rapleafdemo.com"},
  {"email":"NOT_AN_EMAIL_ADDRESS"} 
]

Rapleaf Response:

[
  {"velocity":4, "date_first_seen":"2011-07-28","popularity":4},
  {"error_code":400, "error_msg":"Value of parameter 'email' is invalid."}
]

Example Using Curl

Using Curl will require you to set content type to “application/json”.

Curl Request for two people:

 

curl -H "Content-Type: application/json" -d '[{"email":"pete@rapleafdemo.com"},  {"email":”NOT_AN_EMAIL_ADDRESS”}]' https://api.towerdata.com/v5/ei/bulk?api_key=78ad9ddc21e3c220cc5da024b6dbe13c

Curl Response:

[
{"velocity":4, "date_first_seen":"2011-07-28","popularity":4},
{"error_code":400, "error_msg":"Value of parameter 'email' is invalid."}
]

Please email questions to TowerData Developer Support.

We can set you up with an API Key. Sign up