Figma icon

Figma

Use the Figma API

Library Analytic → List Styles Usages

AI-generated

Summary

Retrieve data on how styles from a specified Figma library are used across different files and teams, including filtering and pagination options.

Inputs

  • Library File Key (required) — The unique key of the Figma library file whose styles usage data you want to fetch.
  • Query Parameters — Optional parameters to filter, paginate, and tailor the styles usage data. Supports parameters such as 'limit' (max number of results), 'cursor' (pagination cursor), 'order' (asc or desc by timestamp), 'start_date', 'end_date', and others to control the scope and format of the response.

Output shape

a JSON object containing styles usage analytics for the specified library file

The response data structure depends on the Figma API analytics endpoint and may support pagination via cursor parameters. If no data is found, the response might be empty or have a 204 status. Be sure to provide a valid Library File Key; otherwise, the operation will fail with an error.

Examples

Example 1: Fetch styles usage data for a specific Figma library file with a limit of 100 results ordered descending by timestamp.

Provide the 'Library File Key' of the target library and set 'limit' to 100 and 'order' to 'desc' in query parameters.

Discussion