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!