Cension API

POST

/api/CreateText

Create perfect descriptions, titles, and metadata in any language, all at once. Fully SEO-optimized for each product in your inventory.

Authentication

We are using bearer token authorization.

You will need your API key. Your API key will be provided to you once you have an active paying account.

Add a new header to your request, called authorization, with the value: Bearer {{your_access_token}} - where your_access_token is your API key.

Was this section helpful?

Header Parameters

AuthorizationstringREQUIRED

Body Parameters

user_idinteger (int32)REQUIRED

This is your user ID provided to you within the Cension platform.

Default value: 0
titlestringREQUIRED

The name/title of the product.

imagestringREQUIRED

An image URL for the product.

field_idsarrayREQUIRED

An output field is the entity that determines the nature of your text output. You can create as many output fields as you need on the Cension platform. Each field has its own unique ID, which can be found within the platform. You can send in one or several field IDs. Ensure that you set the languages you want to work with when creating your field.

Default value: string
languagestringREQUIRED

The language you want the output in. Use standard language prefixes. If you want it to write it all the languages for this field, send in "all".

enable_external_specificationinteger (int32)OPTIONAL

Enables Cension's web scraping for richer product data. 0 = inactive (default), 1 = active.

Default value: 0
og_idstringOPTIONAL

The unique ID of the product. Used when uploading products to a specific workspace.

project_idinteger (int32)OPTIONAL

The unique ID of the project. Can be found under workspace settings in the app. Used when uploading products to a specific workspace.

Default value: 0
brandstringOPTIONAL

Product brand.

article_numberstringOPTIONAL

Article number, EAN, GTIN, etc.

internal_specificationarrayOPTIONAL

Any extra product data (e.g. specs/features) for the AI to use.

pdf_filestringOPTIONAL

URL to a PDF for Cension to scrape (e.g. product brochure).

tagsstringOPTIONAL

Optional tags. Comma-separated if multiple.

Example Request

CURL
1 curl --location 'https://cension-endpoint-container.ambitiousmushroom-5bf5cb04.swedencentral.azurecontainerapps.io/api/CreateText' \
2 --header 'Authorization: Bearer <your_access_token>' \
3 --form 'user_id="0"' \
4 --form 'field_ids[]=""' \
5 --form 'language=""' \
6 --form 'enable_external_specification=""' \
7 --form 'title=""' \
8 --form 'image=""' \
9 --form 'brand=""' \
10 --form 'article_number=""' \
11 --form 'internal_specification[]=""' \
12 --form 'pdf_file=""' \
13 --form 'og_id=""' \
14 --form 'project_id="0"'

Response

200Success
{
  "apiResponses": [
    {
      "success": true,
      "data": {
        "fieldId": "field-123",
        "text": "Your generated text content here"
      },
      "error": null
    },
    {
      "success": true,
      "data": {
        "fieldId": "field-456",
        "text": "Another generated text content"
      },
      "error": null
    }
  ],
  "specification": "Detailed product specification text here",
  "keywords": [
    "keyword1", 
    "keyword2", 
    "keyword3"
  ]
}