EmailOctopus logo

API > Campaigns > Get Campaign Report: Links

GET https://emailoctopus.com/api/1.6/campaigns/:campaignId/reports/links

Get information on the performance of links in the campaign.

Parameters
api_key (string) Your API key.
200 (success) returns
data (array of structs)

Details of each link:

link (struct)

Details of the link:

url (string) The URL of the link.
clicked_total (int) The number of total clicks.
clicked_unique (object) The number of unique clicks.
paging (struct/array)

If there is more data available, an object is returned in the following format:

next (string) A link for the immediate next page of results.

If there is no more data to page, an empty array is returned.

Non-200 (error) returns

Details of the error:

code (string) The error code.
message (string) A description of the error.
Method-specific error codes
CAMPAIGN_NOT_FOUND The campaign could not be found.
CAMPAIGN_NOT_SENT The campaign does not have a status of 'SENT'.
CAMPAIGN_FEATURE_DISABLED The campaign does not have link tracking enabled.
API-wide error codes
INVALID_PARAMETERS Parameters are missing or invalid.
API_KEY_INVALID Your API key is invalid.
UNAUTHORISED You're not authorised to perform that action.
NOT_FOUND The requested endpoint does not exist.
UNKNOWN An unknown error has occurred.
Example request
/api/1.6/campaigns/00000000-0000-0000-0000-000000000000/reports/links?api_key=00000000-0000-0000-0000-000000000000
Example response
                        
                            {
                                "data": [
                                    {
                                        "url": "https://example.com/promo-1",
                                        "clicked_total": 90,
                                        "clicked_unique": 73
                                    },
                                    {
                                        "url": "https://example.com/promo-2",
                                        "clicked_total": 0,
                                        "clicked_unique": 0
                                    },
                                    {
                                        "url": "https://example.com/promo-3",
                                        "clicked_total": 10,
                                        "clicked_unique": 4
                                    }
                                ],
                                "paging": []
                            }
                        
                    
Code sample
copy