Buttondown logo

IntroductionStatusesSourcesAudiencesAnalyticsTemplatesCommenting modesSuppression reason

Audience filters

IntroductionFilteringOperators

Routes

Creating an emailListing emailsRetrieving emailUpdating an emailDeleting an emailRetrieving email analyticsSending a draft emailListing email eventsRetrieving email historyRetrieving an email's historical body

Buttondown logo

Retrieving email analytics

Sample requests

These sample requests are autogenerated by the OpenAPI spec. This endpoint requires one or more parameters in the URL: those are offset in curly-braces.

import requests

url = "https://api.buttondown.com/v1/emails/{id}/analytics"
headers = {
  "Authorization": "Token $BUTTONDOWN_API_KEY"
}

response = requests.request("GET", url, headers=headers)
print(response.text)

Sample responses

The IDs and values referenced in these responses are fake; please only rely on these responses for overall structure.

{
    "recipients": 100,
    "deliveries": 99,
    "opens": 50,
    "clicks": 25,
    "temporary_failures": 1,
    "permanent_failures": 2,
    "unsubscriptions": 3,
    "complaints": 1,
    "survey_responses": 0,
    "webmentions": 0,
    "page_views_lifetime": 0,
    "page_views_30": 0,
    "page_views_7": 0,
    "subscriptions": 0,
    "paid_subscriptions": 0,
    "replies": 0,
    "comments": 0,
    "social_mentions": 0,
    "temporary_failure_breakdown": [],
    "permanent_failure_breakdown": []
}