Figma icon

Figma

Use the Figma API

Library Analytic → List Component Usages

AI-generated

Summary

List component usages in a Figma design system library by retrieving data on how components are used across different files and teams.

Inputs

  • Library File Key (required) — The unique key of the Figma file that represents the design system library to analyze.
  • Query Parameters — Optional parameters to filter, paginate, and control the response, including cursors, limits, date filters, order, version, and others.

Output shape

A JSON object containing a list of component usage data records.

Supports pagination via query parameters such as cursor, limit, and page_size. Additional filtering and ordering options can be applied through the Query Parameters collection.

Examples

Example 1: Retrieve component usage data for a specific library file with default pagination and ordering.

Set 'Library File Key' to the target library file identifier, leave Query Parameters empty or with defaults (limit=50, order=asc).

Discussion