Read content from the CMS and import it

Choose the right API to read from Kontent.ai

You can read content from Kontent.ai using either Delivery API or Management API. To update content, you need to use Management API.

A. Read from Management API only

Because Delivery API is designed for displaying data in your application, we recommend using Management API for transforming and translating content. This is because you need to use the API to update content items. Also, using only Management API means you don’t need to transform the rich text format between the APIs as each API deals with rich text differently.

➕ Advantages	➖ Disadvantages
No need to transform between different rich text formats.	Tighter rate limitations. Limited filtering options.

B. Filter with Delivery API and read from Management API

If you need to retrieve specific content items using filters, use Delivery API. Then use the IDs of the content items to also retrieve the items via Management API one by one.

➕ Advantages	➖ Disadvantages
No need to transform between different rich text formats. Use advanced filtering in Delivery API.	Tighter rate limitations of Management API. A combination of two APIs might add extra complexity.

C. Read from Delivery API only

You can also choose to read data just from Delivery API, but the API is primarily designed for displaying data to users.

➕ Advantages	➖ Disadvantages
Use advanced filtering in Delivery API.	The format of responses, rich text elements specifically, is different for Delivery and Management API. Because you can update content only via Management API, you need to convert the content to the Management API format. This adds extra complexity and might break in the future.

Import translated content

The final step in the translation process is importing the translated content. It is the reverse process of the text transformation and a language variant upsert request.After the import is finished, your translation process can move all the source and target variants into the next workflow step. If the variants were protected during the translation, the change of workflow steps lets users know that the translation is done.