This page provides you information about how to get email statistics by message and by recipient.
...
Please note that the full list of message recipients is kept inside MailUp only for 15 days after message sending, after that period COUNT returns zero and LIST returns an empty array.
Description | Get recipients whom the specified message was sent | ||||
---|---|---|---|---|---|
HTTP Method | GET | ||||
URL | Get recipients whom the specified message was sent (COUNT)
Get a list of email addresses whom the specified message was sent (LIST, paging is set as default with pageSize=20)
| ||||
JSON request (example) | none | ||||
JSON response (example) | COUNT method simply return the number of sent messages (e.g. 103) LIST method returns a paged list
| ||||
Paging and filtering (example) | If you want to change the paging size you can take advantage of the "PageSize" option.
|
Read message opens
Full details about opens are kept for at least 90 days, this period is longer if your console account has activated the "Detailed Statistics Extension" option.
Description | Get opens for the specified message | ||||
---|---|---|---|---|---|
HTTP Method | GET | ||||
URL | Get the number of opens for the specified message (COUNT)
Get a list of recipients that opened the specified message (LIST, paging is set as default with pageSize=20)
| ||||
JSON request (example) | none | ||||
JSON response (example) | COUNT method simply return the number of opens (e.g. 13) LIST method returns a list of recipients that opened the message (each recipient could have opened the message more than once, see "Count" parameter for each recipient). The list is paged by default if the number of returned items is higher than 20
| ||||
Paging and filtering (example) | If you want to change the paging size you can take advantage of the "PageSize" option.
|
Read clicks by message
Full details about clicks are kept for at least 90 days, this period is longer if your console account has activated the "Detailed Statistics Extension" option.
Description | Get clicks for the specified message | ||||
---|---|---|---|---|---|
HTTP Method | GET | ||||
URL | Get the number of clicks for the specified message (COUNT)
Get a list of recipients that clicked at least a link in the specified message (LIST, paging is set as default with pageSize=20)
| ||||
JSON request (example) | none | ||||
JSON response (example) | COUNT method simply return the number of clicks (e.g. 13) LIST method returns a list of recipients that clicked in the message (each recipient could have clicked the message more than once, see "Count" parameter for each recipient). The list is paged by default if the number of returned items is higher than 20
| ||||
Paging and filtering (example) | If you want to change the paging size you can take advantage of the "PageSize" option.
|
Read details about clicked links
Full details about clicks are kept for at least 90 days, this period is longer if your console account has activated the "Detailed Statistics Extension" option.
Description | Get distribution of clicks for the specified message | ||||||||
---|---|---|---|---|---|---|---|---|---|
HTTP Method | GET | ||||||||
URL | Count the number of clicks on each link of specified message
Get a list of recipients that clicked at least a link in the specified message (LIST, paging is set as default with pageSize=20)
| ||||||||
JSON request (example) | none | ||||||||
JSON response (example) | UrlClicks returns a paged list of message links with at least one click. For each link both the URL and the number of clicks are provided
LIST method returns a list of recipients that clicked in the message (each recipient could have clicked the message more than once, see "Count" parameter for each recipient). The list is paged by default if the number of returned items is higher than 20
| ||||||||
Paging and filtering (example) | If you want to change the paging size you can take advantage of the "PageSize" option.
|
Read bounces by message
Description | Get recipients for whom a bounce occurred when the specified message was sent | ||||
---|---|---|---|---|---|
HTTP Method | GET | ||||
URL | Get the number of bounces related to the specified message (COUNT)
Get a list of email addresses that originated a bounce when the specified message was sent (LIST, paging is set as default with pageSize=20)
| ||||
JSON request (example) | none | ||||
JSON response (example) | COUNT method simply return the number of bounces (e.g. 103) LIST method returns a paged list
| ||||
Paging and filtering (example) | If you want to change the paging size you can take advantage of the "PageSize" option.
|
Read unsubscribed recipients by message
This feature allows to extract either the number or the full list of the recipients whose unsubscription is related to specified message.
Description | Get recipients whose unsubscription is related to the specified message | ||||
---|---|---|---|---|---|
HTTP Method | GET | ||||
URL | Get the number of unsubscribed (COUNT)
Get a detailed list of unsubscribed (LIST, paging is set as default with pageSize=20).
| ||||
JSON request (example) | none | ||||
JSON response (example) | COUNT method simply return the number of unsubscribed recipients (e.g. 103) LIST method returns a paged list
| ||||
Paging and filtering (example) | If you want to change the paging size you can take advantage of the "PageSize" option.
|
...
Get Statistics by Recipient
...
Please note that delivery details are kept inside MailUp only for 15 days, after that period COUNT returns zero and LIST returns an empty array.
Description | Get the email messages sent to the specified recipient | ||||
---|---|---|---|---|---|
HTTP Method | GET | ||||
URL | Get the email messages sent to the specified recipient (COUNT)
Get the email messages sent to the specified recipient (LIST, paging is set as default with pageSize=20)
| ||||
JSON request (example) | none | ||||
JSON response (example) | COUNT method simply return the number of delivered messages (e.g. 2) LIST method returns a paged list (default page size = 20)
| ||||
Paging and filtering (example) | If you want to change the paging size you can take advantage of the "PageSize" option.
If you want to retreive only the messages that are related to a particular list you can specify the "FilterBy" option (e.g. only messages that belong to list 51
|
Read opens by recipient
Full details about opens are kept for at least 90 days, this period is longer if your console account has activated the "Detailed Statistics Extension" option.
Description | Get opens for the specified recipient | ||||
---|---|---|---|---|---|
HTTP Method | GET | ||||
URL | Get the number of opens for the specified recipient (COUNT)
Get a list of messages that were opened by the specified recipient (LIST, paging is set as default with pageSize=20)
| ||||
JSON request (example) | none | ||||
JSON response (example) | COUNT method simply return the number of opens (e.g. 13) LIST method returns a detailed list of opened messages (each message could have been opened the message more than once by the same recipient, see "Count" parameter for each recipient). The list is paged by default if the number of returned items is higher than 20
| ||||
Paging and filtering (example) | If you want to change the paging size you can take advantage of the "PageSize" option.
If you want to retreive only the messages that are related to a particular list you can specify the "FilterBy" option (e.g. only messages that belong to list 51)
If you want to retreive only the messages that have been opened more than once by specified recipient you can specify the "FilterBy" option (e.g. Count >=2) |
Read clicks by recipient
Full details about clicks are kept for at least 90 days, this period is longer if your console account has activated the "Detailed Statistics Extension" option.
Description | Get clicks performed by the specified recipient | ||||
---|---|---|---|---|---|
HTTP Method | GET | ||||
URL | Get the number of clicks for the specified message (COUNT)
Get a list messages in which the specified recipients has performed at least one click (LIST, paging is set as default with pageSize=20)
| ||||
JSON request (example) | none | ||||
JSON response (example) | COUNT method simply return the number of clicks (e.g. 13) LIST method returns a list of clicked messages (the specified recipient could have clicked the message more than once, see "Count" parameter for each message). The list is paged by default if the number of returned items is higher than 20
| ||||
Paging and filtering (example) | If you want to change the paging size you can take advantage of the "PageSize" option.
|
Read details by recipient about clicked links
Full details about clicks are kept for at least 90 days, this period is longer if your console account has activated the "Detailed Statistics Extension" option.
Description | Get the distribution of clicks done by the specified recipient | ||||
---|---|---|---|---|---|
HTTP Method | GET | ||||
URL | Get a list of links, grouped by message, that the specified recipient has clicked (LIST, paging is set as default with pageSize=20). For each link a click counter is provided.
| ||||
JSON request (example) | none | ||||
JSON response (example) | ClicksDetails returns a paged list of message links with at least one click. For each message both the clicked URL and the number of clicks are provided. The list is paged by default if the number of returned items is higher than 20
| ||||
Paging and filtering (example) | If you want to change the paging size you can take advantage of the "PageSize" option.
|
Read bounces by recipient
Description | Get bounces that have been reported for the specified recipient | ||||||||
---|---|---|---|---|---|---|---|---|---|
HTTP Method | GET | ||||||||
URL | Get the number of bounces related to the specified recipient (COUNT)
Get a list of messages in which a bounce condition occurred for specified recipient (LIST, paging is set as default with pageSize=20)
Get a detailed list of messages in which a bounce condition occurred for specified recipient (DETAILED LIST, paging is set as default with pageSize=20)
| ||||||||
JSON request (example) | none | ||||||||
JSON response (example) | COUNT method simply return the number of bounces (e.g. 4) LIST method returns a paged list
DETAILED LIST method returns a paged list that includes also the message details (subject and notes)
| ||||||||
Paging and filtering (example) | If you want to change the paging size you can take advantage of the "PageSize" option.
|
Read clicks on unsubscription link by recipient
This feature allows to extract either the unsubscriptions made by specified recipient
Description | Get information about the unsubscriptions by the specified recipient | ||||
---|---|---|---|---|---|
HTTP Method | GET | ||||
URL | Get the number of clicks on any "Unsubscribe" link by the specified recipient (COUNT)
Get a detailed list of clicks on "Unsubscribe" link by the specified recipient (LIST, paging is set as default with pageSize=20).
| ||||
JSON request (example) | none | ||||
JSON response (example) | COUNT method simply return the number of recipients who clicked on Unsubsribe link (e.g. 1) LIST method returns a paged list
| ||||
Paging and filtering (example) | If you want to change the paging size you can take advantage of the "PageSize" option.
|
Access to built-in pages for email statistics
MailUp also provides some public pages that display some of the available statistics. These pages do not provide all the details you can obtain by properly combining the methods listed above, but in some cases it could be an acceptable tradeoff. (Note: you may also use the returned URL to extract the account URL)
Description | Get a list of public pages | |||||||||
---|---|---|---|---|---|---|---|---|---|---|
HTTP Method | GET | |||||||||
URL | Get a list of URLs
| |||||||||
JSON request (example) | none | |||||||||
JSON response (example) |
| |||||||||
Paging and filtering (example) |
message