AI Enrichment

AI Enrichment automatically generates and improves product content — titles, descriptions, attributes, and categories — using large language models.

POST/enrichment/enrich

Enrich a product

Submits a product for AI enrichment. Returns a job ID to track progress.

Body parameters

Name
ean
Type
string
Description
The EAN of the product to enrich.
Name
fields
Type
array
Description
Fields to generate: title, description, attributes, category. Enriches all if omitted.
Name
prompt_id
Type
string
Description
ID of a custom prompt template to use. Uses the default prompt if omitted.
Name
language
Type
string
Description
Target language for generated content (e.g. fr, en, de). Default: your account language.

Request

POST

/enrichment/enrich

curl -X POST https://api.productsmanager.app/api/v1/enrichment/enrich \
  -H "Authorization: Bearer {api_key}" \
  -H "Content-Type: application/json" \
  -d '{
    "ean": "3760000000001",
    "fields": ["description", "attributes"],
    "language": "fr"
  }'

Response

{
  "id": "enr_01HQ...",
  "ean": "3760000000001",
  "status": "pending",
  "fields": ["description", "attributes"],
  "created_at": "2024-03-15T09:00:00Z"
}

GET/enrichment/{id}

Get enrichment status

Returns the status and results of an enrichment job.

Path parameters

Name
id
Type
string
Description
The enrichment job ID.

Request

GET

/enrichment/{id}

curl https://api.productsmanager.app/api/v1/enrichment/enr_01HQ... \
  -H "Authorization: Bearer {api_key}"

Response

{
  "id": "enr_01HQ...",
  "ean": "3760000000001",
  "status": "completed",
  "result": {
    "description": "Ce produit de haute qualité...",
    "attributes": {
      "matière": "Acier inoxydable",
      "dimensions": "20 x 10 x 5 cm"
    }
  },
  "completed_at": "2024-03-15T09:00:08Z"
}

GET/enrichment/prompts

List prompts

Returns the list of available enrichment prompt templates for your account.

Request

GET

/enrichment/prompts

curl https://api.productsmanager.app/api/v1/enrichment/prompts \
  -H "Authorization: Bearer {api_key}"

Response

{
  "data": [
    {
      "id": "prm_default",
      "name": "Default",
      "description": "Standard product enrichment prompt",
      "is_default": true
    },
    {
      "id": "prm_seo",
      "name": "SEO Optimized",
      "description": "Generates SEO-friendly descriptions",
      "is_default": false
    }
  ]
}