Get Images

Exports rendered images of specified nodes from a file. Returns temporary URLs to the rendered images.

GET https://api.figma.com/v1/images/:file_key

Authentication

Requires a valid access token with file_content:read scope. Pass via X-Figma-Token header (personal access token) or Authorization: Bearer header (OAuth).

Parameters

Path parameters

The key of the file containing the nodes to render.

Query parameters

Comma-separated list of node IDs to render as images.

Show Optional query parameters

Export scale factor. Range: 0.01 to 4. Default: 1.

Image format: png, jpg, svg, or pdf. Default: png.

Whether to include node IDs as attributes in SVG output. Default: false.

Whether to simplify strokes in SVG output for smaller file sizes. Default: true.

Whether to convert text to outlines in SVG output. Default: false.

Use the full dimensions of the node regardless of cropping. Default: false.

A specific file version to render from.

Example Request

curl -X GET "https://api.figma.com/v1/images/YOUR_FILE_KEY?ids=1:2,3:4&format=png&scale=2" \
  -H "X-Figma-Token: YOUR_TOKEN"

Response

{
  "err": null,
  "images": {
    "1:2": "https://figma-alpha-api.s3.us-west-2.amazonaws.com/images/abc...",
    "3:4": "https://figma-alpha-api.s3.us-west-2.amazonaws.com/images/def..."
  }
}

Response Fields

Field	Type	Description
`err`	`string` or `null`	Error message, or `null` on success
`images`	`object`	Map of node IDs to their rendered image URLs

Rendered image URLs are temporary and expire after 14 days. Download and cache them if you need persistent access.

For batch exports, include multiple node IDs in a single request rather than making separate calls for each node. This is faster and more efficient with your rate limit.