Get Single Send Click Tracking Stats by ID
As a Marketing Campaigns customer, you have access to rich statistics about your Single Sends and Automations. The Marketing Campaigns Statistics API allows you to retrieve these statistics programmatically. for detailed information about the statistics available, see the Marketing Campaigns Stats Overview.
Note
These endpoints provide stats for Marketing Campaigns only. For stats related to event tracking, please see the Stats API.
GET/v3/marketing/stats/singlesends/{id}/links
Base url: https://api.sendgrid.com (The Twilio SendGrid v3 API)
This endpoint lets you retrieve click-tracking stats for one Single Send.
The stats returned list the URLs embedded in the specified Single Send and the number of clicks each one received.
Bearer <<YOUR_API_KEY_HERE>>The ID of Single Send for which you want to retrieve link stats.
Optional
The number of elements you want returned on each page.
25Minimum: 1Maximum: 50Optional
The stats endpoints are paginated. To get the next page, call the passed _metadata.next URL. If _metadata.prev doesn't exist, you're at the first page. Similarly, if _metadata.next is not present, you're at the last page.
Optional
A/B Single Sends have multiple variation IDs and phase IDs. Including these additional fields allows further granularity of stats by these fields.
ab_variationab_phaseOptional
Optional
testsendOptional
This is the index of the link's location in the email contents.
Optional
Optional
1const client = require("@sendgrid/client");2client.setApiKey(process.env.SENDGRID_API_KEY);34const id = "id";5const queryParams = { page_size: 25 };67const request = {8url: `/v3/marketing/stats/singlesends/${id}/links`,9method: "GET",10qs: queryParams,11};1213client14.request(request)15.then(([response, body]) => {16console.log(response.statusCode);17console.log(response.body);18})19.catch((error) => {20console.error(error);21});
