Library Analytics API cannot return information that is available in the web UI
Hi all, I'm using the Figma Library Analytics REST API to collect usage data for components in our design library, but I've encountered a limitation that prevents me from getting per-component file breakdowns.
What I'm Trying to Achieve
I need to identify which specific files use each component in my library, along with the instance count per file. For example:
- Component A is used in:
- File 1 from Team A: 50 instances
- File 2 from Team B: 25 instances
- File 3 from Team C: 10 instances
I know this information is visible through the Figma library analytics window,
What I've Tried
I've tested the following API endpoints extensively:
1. GET /v1/analytics/libraries/{key}/component/usages?group_by=component
- ✅ Returns total usages, file count, and team count per component
- ❌ Does not provide list of which files
2. GET /v1/analytics/libraries/{key}/component/usages?group_by=file
- ✅ Returns list of all files using the library
- ❌ Shows total library usages per file (all components combined)
- ❌ Does not break down by individual component
My Question
Is there a different API endpoint, parameter, or authentication scope that enables per-component file-level breakdowns via the REST API? Or is this data only available through the Figma web interface?
I've reviewed the documentation at https://developers.figma.com/docs/rest-api/library-analytics-endpoints/ but haven't found a solution.
Any guidance would be greatly appreciated, thanks yall!