API

Get clicks

This example shows how you can retrieve the clicks of one or more statistics.

Parameters

Parameters
Field	Type	Description	Required / Optional
`statids`	string	Comma-separated IDs of statistics.	Required
`order_by`	string	The order in which the clicks in the array must be sorted (emailaddress, opentime).	Optional
`order_dir`	string	Whether sorting must be from low to high or the other way around (ASC or DESC).	Optional
`count_only`	string	Whether only the count must be returned. Default: false.	Optional
`linkid`	string	The ID of the specific link whose number of clicks you want to know. Default: a (all).	Optional
linkid.`DateClickedSearch`		The parameter for searching by date.	Required
linkid.DateClickedSearch.`filter`	string	This must be 1 in order to filter	Optional
linkid.DateClickedSearch.`type`	string	This can be before, after, exact(ly), between, notbetween and not.	Optional
linkid.DateClickedSearch.`StartDate`	string	The unix timestamp of the start date to search on.	Optional
linkid.DateClickedSearch.`EndDate`	string	The unix timestamp of the end date to search on. You only specify this if between or notbetween was chosen as the type	Optional
`start`	int	Enter the number from which point the result must be returned. Default: 0 (first result).	Optional
`perpage`	string	The number of clicks to return per result. Choose 'all' for all clicks. Default: 10	Optional

Successful response

Successful response
Field	Type	Description
`status`	string	The value of the status field is returned as “SUCCESS” on a successful response.
`data`	array	If the clicks are found, the object is returned.

Error response

Error response
Field	Type	Description
`status`	string	The value of the status field will be “FAILED”.
`errormessage`	string	A text message explaining why the request failed.

Request example

PHP request example

Response Success

Response Failed

Request example

<xmlrequest>
	<username>admin</username>
	<usertoken>0123456789abcdef0123456789abcdef01234567</usertoken>
	<requesttype>stats</requesttype>
	<requestmethod>GetClicks</requestmethod>
	<responsetype>xml</responsetype>
	<details>
		<statids>99</statids>
		<order_by>opentime</order_by>
		<order_dir>desc</order_dir>
		<linkid>a</linkid>
		<count_only>false</count_only>
		<searchinfo>
			<DateClickedSearch>
				<filter>1</filter>
				<type>between</type>
				<StartDate>1662917256</StartDate>
				<EndDate>1726075656</EndDate>
			</DateClickedSearch>
		</searchinfo>
		<start>0</start>
		<perpage>10</perpage>
	</details>
</xmlrequest>