List a broadcast's link clicks

Clicks per link in a sent broadcast, most clicked first: every click (clicks) and how many people clicked it (people).

GEThttps://app.usenotix.dev/api/v1/broadcasts/{broadcastId}/links

Full access and read only keys can call this. Sending access keys cannot. Key permissions lists the extra rules some calls have.

Clicks per link in a sent broadcast, most clicked first: every click (clicks) and how many people clicked it (people). At most 50 links. Notix's own unsubscribe link is left out. Click tracking must be on for the sending domain.

The team can read broadcast activity 60 times a minute.

Who can call it

Any key that reads broadcasts: full access, read only and live AI keys. A send-only key answers 403 SCOPE_DENIED. A key limited to one domain sees only broadcasts that send from its domain; any other answers 404.

Path parameters

broadcastIdstringrequired

Headers

Authorizationstringrequired

Bearer followed by your API key.

Errors

403

The key is not FULL, or is limited to one domain (DOMAIN_PINNED). These show contacts and their addresses.

404

No campaign with this id for the calling team (or, for a key limited to one domain, on its domain).

429

The team read campaign activity 60 times in the last minute.

503

The call could not be counted just now, or the read took too long. Try again shortly.

Every error has the same shape. See all error codes.

curl -X GET "https://app.usenotix.dev/api/v1/broadcasts/<broadcastId>/links" \
  -H "Authorization: Bearer $NOTIX_API_KEY"
Response200
{
  "data": [
    {
      "url": "string",
      "clicks": 1,
      "people": 1
    }
  ]
}
Open in ClaudeOpen in ChatGPT