---
title: "GET /v1/designs/{designId}/analytics/links"
method: GET
path: "/v1/designs/{designId}/analytics/links"
tags: ["analytics"]
---

# GET /v1/designs/{designId}/analytics/links

`GET /v1/designs/{designId}/analytics/links`

<Warning>

This API is currently provided as a preview. Be aware of the following:

- There might be unannounced breaking changes.
- Any breaking changes to preview APIs won't produce a new [API version](https://www.canva.dev/docs/connect/versions/).
- Public integrations that use preview APIs will not pass the review process, and can't be made available to all Canva users.

</Warning>

<Availability>
To use this API, your integration must act on behalf of a user who is a member of a [Canva Enterprise](https://www.canva.com/enterprise/) organization.
</Availability>

Lists trackable links and their metrics for a design.

## Path parameters

- `designId` string, required

## Query parameters

- `limit` integer
- `continuation` string

## Response `200`

OK

- GetDesignAnalyticsLinksResponse — Successful response from a `getDesignAnalyticsLinks` request.
  - `items` TrackableLink[], required — The list of trackable links.
    - `link_id` string, required — The ID of the trackable link.
    - `name` string — The user-visible name of the trackable link.
    - `total_view_count` integer — The total number of views for this link.
    - `unique_view_count` integer — The number of unique viewers for this link.
    - `total_view_duration_seconds` integer — The total time this link has been viewed, in seconds.
    - `average_view_duration_seconds` integer — The average time this link has been viewed, in seconds.
    - `last_viewed_at` integer — When this link was most recently viewed, as a Unix timestamp (in seconds since the Unix Epoch).
  - `continuation` string — If the success response contains a continuation token, there are more links you can list. You can use this token as a query parameter and retrieve more links from the list, for example `/v1/designs/{designId}/analytics/links?continuation={continuation}`. To retrieve all links, you might need to make multiple requests.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Too Many Requests
- `default` — Error Response

---

[API](https://skmtc.net/canva/apis/canva-connect-api.md) · [All operations](https://skmtc.net/canva/apis/canva-connect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/canva/canva-connect-api/versions/499c392c7720/schema)