Public APIs
Contentful Images favicon

Contentful Images

Development

Used to retrieve and apply transformations to images.

Contentful Images's website screenshot

About Contentful Images

The Contentful Images API retrieves and manipulates image files referenced from Contentful assets. Requests are made by appending parameters to the URL found in an asset's file.url field, allowing transformation and conversion of images. The base API URL is https://images.ctfassets.net, with a separate base URL for EU data residency customers. It is a read-only API.

Images uploaded to Contentful must not exceed 100MB in size; images over this limit are treated as plain assets and the transformation features do not apply to them.

This API is intended for developers building on Contentful who need to manipulate and serve images referenced in their content, such as resizing or converting images at the URL level rather than pre-processing files before upload.

Key features

  • Retrieve and manipulate image files referenced from Contentful assets
  • Append URL parameters to an asset's file.url to transform images
  • Read-only API served from images.ctfassets.net
  • Dedicated base URL for EU data residency customers

Frequently asked questions

What does the Images API do?

It allows retrieval and manipulation of image files referenced from Contentful assets by appending parameters to the asset's file.url.

Is the Images API read-only?

Yes, it is documented as a read-only API.

Is there a size limit on images that can be transformed?

Images must not exceed 100MB; images exceeding this limit are treated as assets and the transformation features are not applicable.

What is the API base URL, and does it differ for EU customers?

The base URL is https://images.ctfassets.net, while EU data residency customers use https://images.eu.ctfassets.net.

Advertise here

Featured products

  • SerpApi - Search API favicon
  • Screenshot Scout favicon
  • TalorData favicon
  • CoreClaw favicon

Show your product to thousands of developers

· 100k monthly pageviews
· 7k newsletter subscribers

Advertise your product