List Clicked Links API

Today we are releasing a new API endpoint to retrieve the links clicked in a broadcast. It returns every link clicked in a broadcast, ranked by total clicks.

What you can build with it

• Your own dashboard: connect other sources of data to understand how your subscribers interact with your emails
• Cross-campaign reports: identify which URLs and CTAs drive the most engagement across your broadcasts
• Optimized content strategies: surface your top-performing links to inform future email design and messaging

Retrieving link clicks

Use the ID of any broadcast. The API returns a list of every link in the broadcast that was clicked and their total and unique clicks, sorted by total clicks.

import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.broadcasts.clickedLinks(
  '559ac32e-9ef5-46fb-82a1-b76b840c0f7b',
  { limit: 20 },
);

The response looks like this:

{
  "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
    }
  ]
}

You can also retrieve the link clicks in the Resend CLI and through the MCP server, so your agents can help you understand how your emails are performing.