Images API (2024)

The Contentful Images API allows the retrieval and manipulation of image files referenced from assets.

The JSON representation of an asset in Contentful looks like this:

"fields": { "title": "Playsam Streamliner", "file": { "fileName": "quwowooybuqbl6ntboz3.jpg", "contentType": "image/jpg", "details": { "image": { "width": 600, "height": 446 }, "size": 27187 }, "url": "//images.ctfassets.net/yadj1kx9rmg0/wtrHxeu3zEoEce2MokCSi/cf6f68efdcf625fdc060607df0f3baef/quwowooybuqbl6ntboz3.jpg" } }

This reference covers the parameters you can append to the URL specified in the file.url field to manipulate and convert images.

To upload images to Contentful, refer here.

Note: As per the Technical Limits specifications, size of an image uploaded must not exceed 20MB. Images exceeding the size limit are treated as assets and the transformation features offered by the API are not applicable.

Note:For EU data residency customers, the Base URL is https://images.eu.ctfassets.net.