Opens And Clicks

When the recipient opens or clicks your email, his address will be added to the list of opens and clicks, in which you can search the address you want.

---

Query

URL

https://api2.sendcloud.net/api/openandclick/list

HTTP Request Method

post    get

Parameter Description

parameter	type	required or not	description
apiUser	string	yes	API_USER
apiKey	string	yes	API_KEY
days	int	*	stats in the past [days] days (days=1 equals to today)
startDate	string	*	format of start date is yyyy-MM-dd
endDate	string	*	format of end date is yyyy-MM-dd
email	string	*	learn more about the address in the list
trackType	string	no	1 means opens，2 means clicks，no parameter included means to search both
apiUserList	string	no	obtain stats of specified API_USER; multiple API_USERs are separated by semicolons, e.g. apiUserList=a; b; c
labelId	string	no	obtain stats of labelled addresses
labelName	string	no	obtain stats of labelName
start	int	no	start position, [0-], defaults to 0
limit	int	no	amount, [0-100],defaults to 100

Tips:

1. With designated time span, your search of opens and clicks should be within the period. Note: start_date and end_date, or [days] is required.
2. Time span cannot be longer than 3 months.
3. With given email address, your search of opens and clicks should provide the details of this email.Note: time span will turn to invalid now.
4. If apiuserlist is not specified, all records will be queried by default

Request Example:

https://api2.sendcloud.net/api/openandclick/list?apiUser=***&apiKey=***&days=100&start=0&limit=3 

Returned Value Description

parameter	description
email	email address
trackType	opens or clicks
url	clicked url
apiUser	apiUser name
currTime	time of opens or clicks
ip	ip of opens or clicks
country	ip of country
province	ip of province
city	ip of city
browser	browser of open or click
device	device of open or click

Returned Value Example:

{
    "result": true,
    "statusCode": 200,
    "message": "success",
    "info": {
        "total": 1,
        "dataList": [
            {
                "trackType": 1,
                "apiUser": "sendcloud_op**s",
                "email": "op**s@sendcloud.im",
                "url": "",
                "currTime": "2021-06-09 09:49:30",
                "emailId": "162320******_143833_116562_2325.sc-10_9_13_213-inbound0$ops@sendcloud.im",
                "requestTime": "2021-06-09 09:01:13",
                "ip": "47.190.78.5",
                "country": "United States",
                "province": "Texas",
                "city": "Southlake",
                "browser": "google",
                "device": ""
            }
        ],
        "count": 1
    }
}

---