List Clicked Links

curl -X GET 'https://api.resend.com/broadcasts/559ac32e-9ef5-46fb-82a1-b76b840c0f7b/clicked-links?limit=20' \
     -H 'Authorization: Bearer re_xxxxxxxxx'

{
  "object": "list",
  "has_more": true,
  "data": [
    {
      "id": "b2Zmc2V0OjA",
      "url": "https://resend.com/pricing",
      "clicks": 42,
      "unique_clicks": 30
    },
    {
      "id": "b2Zmc2V0OjE",
      "url": "https://resend.com/docs",
      "clicks": 17,
      "unique_clicks": 15
    }
  ]
}

GET

broadcasts

:broadcast_id

clicked-links

curl -X GET 'https://api.resend.com/broadcasts/559ac32e-9ef5-46fb-82a1-b76b840c0f7b/clicked-links?limit=20' \
     -H 'Authorization: Bearer re_xxxxxxxxx'

{
  "object": "list",
  "has_more": true,
  "data": [
    {
      "id": "b2Zmc2V0OjA",
      "url": "https://resend.com/pricing",
      "clicks": 42,
      "unique_clicks": 30
    },
    {
      "id": "b2Zmc2V0OjE",
      "url": "https://resend.com/docs",
      "clicks": 17,
      "unique_clicks": 15
    }
  ]
}

Broadcast metrics and recipients are currently in private beta and only available to a limited number of users. APIs might change before it is generally available. Get in touch if you’re interested in testing this feature.Once you have access, upgrade your Resend SDK to use the methods on this page:

npm install resend@6.19.0-preview-headless-dashboard.3

Retrieve every link clicked in a broadcast, ranked by total clicks. Results are paginated with cursors. See Pagination for how after and before work.

Responses are cached for up to 15 minutes, so requesting the same page again may return slightly stale data within that window.

Path Parameters

Query Parameters

Response Fields

string

Always list.

boolean

Whether more links exist beyond this page.

array

The clicked links, ordered by total clicks, descending.

Hide properties

string

An opaque cursor for this row, used only for pagination. It does not identify any entity in Resend.

string

The URL that was clicked.

number

Total clicks on this link, including repeat clicks by the same recipient.

number

The number of distinct recipients who clicked this link.

curl -X GET 'https://api.resend.com/broadcasts/559ac32e-9ef5-46fb-82a1-b76b840c0f7b/clicked-links?limit=20' \
     -H 'Authorization: Bearer re_xxxxxxxxx'

{
  "object": "list",
  "has_more": true,
  "data": [
    {
      "id": "b2Zmc2V0OjA",
      "url": "https://resend.com/pricing",
      "clicks": 42,
      "unique_clicks": 30
    },
    {
      "id": "b2Zmc2V0OjE",
      "url": "https://resend.com/docs",
      "clicks": 17,
      "unique_clicks": 15
    }
  ]
}

⌘I

API Reference

Sending

Receiving

Broadcasts

Automations

Events

Templates

Contacts

Contact Properties

Contact Imports

Segments

Topics

Audiences

Domains

Logs

Usage

API Keys

Suppressions

Authorized Apps

Webhooks

OAuth

List Clicked Links

Path Parameters

Query Parameters

Response Fields

​Path Parameters

​Query Parameters

​Response Fields

Path Parameters

Query Parameters

Response Fields