Overview

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:

1
"fields": {
2
    "title": "Playsam Streamliner",
3
    "file": {
4
      "fileName": "quwowooybuqbl6ntboz3.jpg",
5
      "contentType": "image/jpg",
6
      "details": {
7
        "image": {
8
          "width": 600,
9
          "height": 446
10
        },
11
        "size": 27187
12
      },
13
      "url": "//images.ctfassets.net/yadj1kx9rmg0/wtrHxeu3zEoEce2MokCSi/cf6f68efdcf625fdc060607df0f3baef/quwowooybuqbl6ntboz3.jpg"
14
    }
15
  }

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 100MB. Images exceeding the size limit are treated as assets and the transformation features offered by the API are not applicable.

Basic API information

API Base URL https://images.ctfassets.net This is a read-only API