{"id":3725,"date":"2023-08-31T07:07:12","date_gmt":"2023-08-31T06:07:12","guid":{"rendered":"https:\/\/help.expertsender.com\/?post_type=es&p=3725"},"modified":"2024-06-25T13:02:17","modified_gmt":"2024-06-25T12:02:17","slug":"get-subscriber-statistics","status":"publish","type":"es","link":"https:\/\/help.expertsender.com\/pl\/emp\/api\/methods\/sms-mms-statistics\/get-subscriber-statistics\/","title":{"rendered":"Get subscriber statistics"},"content":{"rendered":"\n

SmsMmsSubscriberStatistics collection allows retrieving data about performance of subscriber lists. This means current list size, number of subscribers that subscribed to or unsubscribed from the list in specified time period and so on.<\/p>\n\n\n\n

<\/a><\/a>Request data format<\/strong><\/h3>\n\n\n\n

Request URL parameters:<\/p>\n\n\n\n

Element\/attribute<\/th>Type<\/th>Notes<\/th><\/tr><\/thead>
apiKey<\/td>string<\/td>Your API key, required for authentication. Required.<\/td><\/tr>
startDate<\/td>date <\/td>Start date. Optional. If not specified, business unit creation date will be taken. YYYY-MM-DD format.<\/td><\/tr>
endDate<\/td>date<\/td>End date. Optional. If not specified, current date will be taken. YYYY-MM-DD format.<\/td><\/tr>
scope<\/td>string<\/td>Filtering scope. Optional. If not specified, no filtering will be applied (data for the whole business unit will be returned).

Available scopes are:
List – only results for specific subscriber list
SmsMmsMessageType – only results for specific SMS\/MMS message type*
Vendor – only results for specific vendor
Tag – only results for messages marked with a tag<\/td><\/tr>
scopeValue<\/td>string<\/td>Filtering scope value. Required if scope was specified. This is a mixed value, type depends on selected scope.
List – List ID, int, e.g. 123S
msMmsMessageType – SMS\/MMS message type name, string, e.g. Newsletter*
Vendor – vendor name, string, e.g. foobar
Tag – Tag name, e.g. holidays<\/td><\/tr>
scope2<\/td>string<\/td>Second filtering scope – works just like “scope”.<\/td><\/tr>
scopeValue2<\/td>string<\/td>Filtering scope value for “scope2”.<\/td><\/tr>
grouping<\/td>string<\/td>Results grouping. Optional. If not specified, results will be grouped by whole business unit (one row of data will be returned with all values summed up).
\u00a0
Available groupings are:
Date
Month
List
Vendor
Tag

NOTE: It is impossible to filter and group by the same thing.\u00a0scope<\/code>\u00a0parameter value must be different from\u00a0grouping<\/code>\u00a0parameter value<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

*Available message types: Newsletter, Test, WorkflowMessage.<\/p>\n\n\n\n

Examples:<\/p>\n\n\n\n

<\/path><\/path><\/svg><\/span>
https:\/\/api.esv2.com\/v2\/Api\/SmsMmsSubscriberStatistics?apiKey=YOUR_API_KEY_HERE<\/span><\/span>\n<\/span>\nhttps:\/\/api.esv2.com\/v2\/Api\/SmsMmsSubscriberStatistics?apiKey=YOUR_API_KEY_HERE&scope=List&scopeValue=1&grouping=Vendor<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Response<\/strong><\/h3>\n\n\n\n
Response Data element:<\/p>\n\n\n\n
Element\/attribute<\/th>Type<\/th>Notes<\/th><\/tr><\/thead>
SubscriberStatistics<\/td>array[complex]<\/td>Array of SubscriberStatistic elements.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
SubscriberStatistic element children:<\/p>\n\n\n\n
Element\/attribute<\/th>Type<\/th>Notes<\/th><\/tr><\/thead>
IsSummaryRow<\/td>boolean<\/td>If set to true, marks the summary row of statistic table (values are sums of all other rows).*<\/td><\/tr>
Date<\/td>date<\/td>Date. Returned only if grouping by dates was requested.<\/td><\/tr>
Month<\/td>string<\/td>Month represented as date period. Returned only if grouping by months was requested.
Example: 2018-01-01 : 2018-01-31<\/td><\/tr>
ListId<\/td>int<\/td>Subscriber list ID. Returned only if grouping by lists was requested.<\/td><\/tr>
ListName<\/td>string<\/td>Subscriber list name. Returned only if grouping by lists was requested.<\/td><\/tr>
Vendor<\/td>string<\/td>Vendor name. Returned only if grouping by vendors was requested. If row contains data about subscribers with no vendor, dash (“-“) will be returned.<\/td><\/tr>
Tag<\/td>string<\/td>Tag name. Returned only if grouping by tags was requested.<\/td><\/tr>
ListSize<\/td>int<\/td>Current list size.<\/td><\/tr>
Growth<\/td>int<\/td>List size increase\/decrease.<\/td><\/tr>
Added<\/td>int <\/td>Overall number of subscribers that were added to the list.<\/td><\/tr>
AddedUi<\/td>int<\/td>Number of subscribers added manually using ExpertSender web panel.<\/td><\/tr>
AddedImport<\/td>int<\/td>Number of subscribers added using manual or automatic imports.<\/td><\/tr>
AddedApi<\/td>int<\/td>Number of subscribers added using API.<\/td><\/tr>
AddedWeb<\/td>int<\/td>Number of subscribers added using webforms.<\/td><\/tr>
AddedSms<\/td>int<\/td>Number of subscribers added using SMS.<\/td><\/tr>
Removed<\/td>int<\/td>Overall number of subscribers removed from the list.<\/td><\/tr>
RemovedOptOut<\/td>int<\/td>Number of subscribers removed because they clicked unsubscribe link.<\/td><\/tr>
RemovedUser<\/td>int<\/td>Number of subscribers removed manually using web panel.<\/td><\/tr>
RemovedBounceLimit<\/td>int<\/td>Number of subscribers removed because they reached the maximum number of bounces.<\/td><\/tr>
RemovedSpam<\/td>int<\/td>Number of subscribers removed because they sent a spam complaint.<\/td><\/tr>
RemovedUserUnknown<\/td>int<\/td>Number of subscribers removed because their email address bounced with “User Unknown” status.<\/td><\/tr>
RemovedBlacklist<\/td>int<\/td>Number of subscribers removed because they were added to blacklist.<\/td><\/tr>
RemovedApi<\/td>int<\/td>Number of subscribers removed using API.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
*Summary rows do not contain grouping columns (e.g. Date, Month).<\/p>\n\n\n\n
<\/a><\/a>Examples<\/strong><\/h3>\n\n\n\n
Request (ungrouped statistics):<\/p>\n\n\n\n
<\/path><\/path><\/svg><\/span>
GET https:\/\/api.esv2.com\/v2\/Api\/SmsMmsSubscriberStatistics?apiKey=test_api_key1&scope=List&scopeValue=1&scope2=SmsMmsMessageType&scopeValue2=Newsletter HTTP\/1.1<\/span><\/span>\nAccept-Encoding: gzip,deflate<\/span><\/span>\nHost: api.esv2.com<\/span><\/span>\nConnection: Keep-Alive<\/span><\/span>\nUser-Agent: Apache-HttpClient\/4.1.1 (java 1.5)<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
OK response:<\/p>\n\n\n\n
<\/path><\/path><\/svg><\/span>
HTTP\/1.1 200 OK<\/span><\/span>\nCache-Control: private<\/span><\/span>\nContent-Type: text\/xml; charset=utf-8<\/span><\/span>\nServer: Microsoft-IIS\/7.5<\/span><\/span>\nX-AspNetMvc-Version: 5.2<\/span><\/span>\nX-AspNet-Version: 4.0.30319<\/span><\/span>\nSet-Cookie: TEMP_DATA=b8567a11-cbb2-4525-b355-782b8b3ea005; path=\/<\/span><\/span>\nX-Powered-By: ASP.NET<\/span><\/span>\nDate: Wed, 29 Jul 2015 14:44:34 GMT<\/span><\/span>\nContent-Length: 870<\/span><\/span>\n<\/span>\n<<\/span>ApiResponse<\/span> <\/span>xmlns<\/span>:<\/span>xsd<\/span>=<\/span>"<\/span>http:\/\/www.w3.org\/2001\/XMLSchema<\/span>"<\/span> <\/span>xmlns<\/span>:<\/span>xsi<\/span>=<\/span>"<\/span>http:\/\/www.w3.org\/2001\/XMLSchema-instance<\/span>"<\/span>><\/span><\/span>\n  <\/span><<\/span>Data<\/span>><\/span><\/span>\n    <\/span><<\/span>SubscriberStatistics<\/span>><\/span><\/span>\n      <\/span><<\/span>SubscriberStatistic<\/span>><\/span><\/span>\n        <\/span><<\/span>IsSummaryRow<\/span>><\/span>true<\/span><\/<\/span>IsSummaryRow<\/span>><\/span><\/span>\n        <\/span><<\/span>ListSize<\/span>><\/span>469<\/span><\/<\/span>ListSize<\/span>><\/span><\/span>\n        <\/span><<\/span>Growth<\/span>><\/span>469<\/span><\/<\/span>Growth<\/span>><\/span><\/span>\n        <\/span><<\/span>Added<\/span>><\/span>470<\/span><\/<\/span>Added<\/span>><\/span><\/span>\n        <\/span><<\/span>AddedUi<\/span>><\/span>0<\/span><\/<\/span>AddedUi<\/span>><\/span><\/span>\n        <\/span><<\/span>AddedImport<\/span>><\/span>437<\/span><\/<\/span>AddedImport<\/span>><\/span><\/span>\n        <\/span><<\/span>AddedApi<\/span>><\/span>0<\/span><\/<\/span>AddedApi<\/span>><\/span><\/span>\n        <\/span><<\/span>AddedWeb<\/span>><\/span>0<\/span><\/<\/span>AddedWeb<\/span>><\/span><\/span>\n        <\/span><<\/span>AddedSms<\/span>><\/span>0<\/span><\/<\/span>AddedSms<\/span>><\/span><\/span>\n        <\/span><<\/span>Removed<\/span>><\/span>1<\/span><\/<\/span>Removed<\/span>><\/span><\/span>\n        <\/span><<\/span>RemovedOptOut<\/span>><\/span>1<\/span><\/<\/span>RemovedOptOut<\/span>><\/span><\/span>\n        <\/span><<\/span>RemovedUser<\/span>><\/span>0<\/span><\/<\/span>RemovedUser<\/span>><\/span><\/span>\n        <\/span><<\/span>RemovedBounceLimit<\/span>><\/span>0<\/span><\/<\/span>RemovedBounceLimit<\/span>><\/span><\/span>\n        <\/span><<\/span>RemovedSpam<\/span>><\/span>0<\/span><\/<\/span>RemovedSpam<\/span>><\/span><\/span>\n        <\/span><<\/span>RemovedUserUnknown<\/span>><\/span>0<\/span><\/<\/span>RemovedUserUnknown<\/span>><\/span><\/span>\n        <\/span><<\/span>RemovedBlacklist<\/span>><\/span>0<\/span><\/<\/span>RemovedBlacklist<\/span>><\/span><\/span>\n        <\/span><<\/span>RemovedApi<\/span>><\/span>0<\/span><\/<\/span>RemovedApi<\/span>><\/span><\/span>\n      <\/span><\/<\/span>SubscriberStatistic<\/span>><\/span><\/span>\n    <\/span><\/<\/span>SubscriberStatistics<\/span>><\/span><\/span>\n  <\/span><\/<\/span>Data<\/span>><\/span><\/span>\n<\/<\/span>ApiResponse<\/span>><\/span><\/span><\/code><\/pre><\/div>\n","protected":false},"author":5,"featured_media":0,"parent":3719,"menu_order":274,"template":"","format":"standard","emp-category":[],"class_list":["post-3725","es","type-es","status-publish","format-standard","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es\/3725","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es"}],"about":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/types\/es"}],"author":[{"embeddable":true,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/users\/5"}],"version-history":[{"count":3,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es\/3725\/revisions"}],"predecessor-version":[{"id":11019,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es\/3725\/revisions\/11019"}],"up":[{"embeddable":true,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es\/3719"}],"wp:attachment":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/media?parent=3725"}],"wp:term":[{"taxonomy":"emp-category","embeddable":true,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/emp-category?post=3725"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}