Get overall email analytics

Prev Next

If you are currently using this API, please migrate to V2 by January 15, 2026, to ensure uninterrupted access, enhanced performance, and continued support.

This API enables you to get the overall email analytics from your back-end without using Insider's InOne platform.

Your title goes here
The email campaigns sent through Architect journeys are not included in Email Analytics. You can get insights about your journey emails via Architect Email Channel Analytics.
Your title goes here
The campaigns on the Draft and Scheduled statuses are not listed in the response.

Endpoint and Headers

GET https://analytics.api.useinsider.com/email/v1/overall

Visit our Postman collection to test this request.

Headers

HeaderSample ValueDescription
X-INS-AUTH-KEY1a2b3c4d5e6fThis key is required to authorize your request. Refer to API Authentication Tokens to generate your token.

Query Parameters

ParameterData TypeDescriptionRequired
startTimeint64The time campaign is being launched. Specifies a 10-digit epoch start time.Yes
endTimeint64The current date (today’s date on the payload). It can be customizable according to your case. Specifies a 10-digit epoch start time.No

Sample Example

Sample Query

Before sending the request, make sure:

  • To replace the authorization value with your own API key.
  • To replace the sample values in start_date and end_date with your own values in the required data type.
curl --location --request GET 'https://analytics.api.useinsider.com/email/v1/overall?startTime=1635714000&endTime=1646502400' \
2--header 'X-INS-AUTH-KEY: 1a2b3c4d5e6f'

Sample Responses

  • 200 OK

Refer to Email Metrics on further explanations on the metrics in the response.

{
    "data": {
        "summary": {
            "blocks": 0,
            "bounceDrop": 0,
            "bounces": 0,
            "clickRate": 5.88,
            "conversion": 0,
            "conversionRate": 0,
            "delivered": 17,
            "frequencyDrop": 0,
            "invalid": 0,
            "invalidDrop": 0,
            "machineOpen": 0,
            "openRate": 47.05,
            "revenue": 0,
            "sendingDrop": 0,
            "sent": 27,
            "spamDrop": 0,
            "spams": 0,
            "systemDrop": 0,
            "totalClick": 1,
            "totalOpen": 15,
            "unsubscribeDrop": 0,
            "unsubscribes": 0
        },
        "linkActivities": [
            {
                "totalClick": 1,
                "uniqueClick": 1,
                "url": "https://google.com"
            }
        ]
    }
}
  • 400 - Bad Request: Sorry, we’ve received an invalid request from your side. You can try again later.
  • 400 - Bad Request: Sorry, we couldn’t validate the request at the moment. You can try again later.
  • 429 - Rate Limited: Rate limited
  • 500 - Internal Server Error: Sorry, we couldn’t receive any response from our server. You can try again later.

Limitations

  • All functions must be executed with an HTTPS GET request.
  • The x-ins-auth-key should be provided as the authorization key on the request header. If the key is incorrect, the operation will not be executed and an authorization error will return in the response.
  • This API provides data for a 1-year range.
  • You can send 100 requests per minute with the same API Key. If you exceed the rate limit, you will receive a 429 error.
  • The perPage value should be between 1-100.

The default limit shown here is a standard baseline. If your use case requires higher capacity, feel free to reach out to the Insider One team — we can adjust it to fit your needs.