Clicks
Track and analyze clicks on your shortened links with detailed attribution and audience data.
Every link shared through Oktopost is shortened with the okt.to link shortener, and each click is tracked with detailed attribution data. Click records capture information about the user who clicked the link, including their browser, device, location, and the originating post and campaign. Use these endpoints to retrieve click data, analyze link performance, and understand audience engagement with your shared content.
Click records include both link clicks and associated conversion data, providing a complete view of the user journey from click to conversion. For aggregated click analytics, use the Exports endpoint.
Example Request
curl -i https://api.oktopost.com/v2/clickParameters
The following parameters can be used to filter data. We strongly recommend using filters to get the desired results.
| Param | Default | Description |
|---|---|---|
| _order | created | Options: created, campaignName and credentialName |
| _count | 25 | Options: 25, 50, 100 and 200 |
| _page | 0 | Current page |
| convertsOnly | 0 | Get only clicks that resulted in a conversion. See Conversion Tracking |
| messageId | - | See Messages API |
| leadId | - | See Leads API |
| campaignId | - | See Campaigns API |
| visitorId | - | Id assigned per unique visitor |
| before | - | Date time string. E.g. 2019-06-30T00:00:00 |
| after | - | Date time string. E.g. 2019-06-30T00:00:00 |
Example Result
{
"Result":true,
"Items":[
{
"Id":"009000000000000",
"Created":"2015-11-19 17:24:29",
"CampaignId":"002000000000000",
"MessageId":"005000000000000",
"PostId":"004000000000000",
"PostlogId":"007000000000000",
"LeadId":"",
"ConversionTagId":null,
"CredentialId":"003-001000000000000-xxxxxx-xxx",
"CampaignName":"2015-11 General Campaign",
"CredentialName":"John Doe's Twitter",
"Message":"Oktopost Rocks! http:\/\/www.oktopost.com\/",
"LinkUrl":"",
"LinkTitle":"",
"ImageUrl":"",
"Picture":0,
"RemoteUrl":"",
"ConvertedDate":"0000-00-00 00:00:00",
"Network":"Twitter",
"UserAgent":"Mozilla\/5.0 (Macintosh; Intel Mac OS X 10_10_4) AppleWebKit\/537.36 (KHTML, like Gecko) Chrome\/46.0.2490.71 Safari\/537.36",
"GeoCountry":"",
"GeoCity":"",
"GeoOrganization":"",
"GeoLongitude":0,
"GeoLatitude":0
}
],
"Total":91709
}