Figma
Get Figma Nodes
Read specific frames or layers from a Figma file as JSON.
Endpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| identifieraccount · required | account | required | — |
| fileKeystring · required | string | required | Paste a Figma file link or the file key from the URL. Example: |
| nodeIdsstring · required | string | required | Node IDs, comma-separated, or links to the layers. Get them from Get Figma File Structure or by right-clicking a layer → Copy link to selection. Example: |
| depthnumber · optional | number | optional | Levels below each node to include: 1 the node itself, 2 its children (default), up to 10. Default: |
| versionstring · optional | string | optional | A version ID from List Figma File Versions. Leave blank for the current version. |
Response schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Open in Figma"
},
"nodes": {
"type": "array",
"description": "One entry per node found, each with nodeId, name, type, url and document"
},
"fileKey": {
"type": "string"
},
"version": {
"type": "string"
},
"fileName": {
"type": "string"
},
"lastModified": {
"type": "string"
},
"totalReturned": {
"type": "number"
},
"missingNodeIds": {
"type": "array",
"description": "Node IDs that are not in this file — Figma reports these inside a success"
}
}
}