List clicked links
GET/v1/broadcasts/{id}/links
Every link recipients clicked in a broadcast, most clicked first. Each link is counted once per recipient, the same as in the stats (which show only the top ten). Clicks only exist when click tracking is on for the sending domain.
Required scope: broadcasts:manage
Parameters
| Name | In | Description |
|---|---|---|
idrequired | path | The broadcast id. |
limitoptional | query | Page size, 1 to 100. Default 20. |
cursoroptional | query | The next_cursor from a previous page. |
Example
curl -X GET 'https://api.sendsend.email/v1/broadcasts/ID/links' \
-H "Authorization: Bearer $SENDSEND_API_KEY"Response 200
{
"object": "list",
"broadcast_id": "bcast_Tz8…",
"has_more": false,
"data": [
{
"object": "broadcast_link",
"url": "https://acme.com/changelog",
"clicks": 61
}
],
"next_cursor": null
}Errors
| Status | Code | When |
|---|---|---|
| 404 | not_found | No such resource in this project. |
| 401 | unauthorized | The API key is missing, invalid or revoked. |
| 403 | forbidden | The key does not have the scope this endpoint needs. |
Every error has the same shape. See Errors.