---
title: "Generate Ad Description Endpoint"
method: POST
path: "/api/generate-ad-description"
tags: ["AI Website Generator - Protected"]
---

# Generate Ad Description Endpoint

`POST /api/generate-ad-description`

Generate AI-powered vehicle ad description using Claude Haiku (cheapest model).

Option 1: Provide listing_id to fetch vehicle data from ViaturasEasyDataGreen
Option 2: Provide vehicle data directly (marca, modelo, ano, kms, combustivel, etc.)

Parameters:
    - listing_id: ID from ViaturasEasyDataGreen (optional)
    - marca, modelo, ano, kms, combustivel: Direct vehicle data (optional)
    - potencia, cor, mes: Additional vehicle data (optional)
    - max_words: Maximum word count (default 50)
    - tone: Desired tone (default "profissional mas apelativo")
    - language: Output language (default "Portugues de Portugal")

## Headers

- `x-api-token` string, nullable

## Request body

- AdDescriptionRequest — Request to generate vehicle ad description.
  - `listing_id` integer, nullable
  - `marca` string, nullable
  - `modelo` string, nullable
  - `versao` string, nullable
  - `ano` integer, nullable
  - `kms` integer, nullable
  - `combustivel` string, nullable
  - `potencia` string, nullable
  - `cor` string, nullable
  - `mes` integer, nullable
  - `portas` integer, nullable
  - `transmissao` string, nullable
  - `lugares` integer, nullable
  - `cilindrada` integer, nullable
  - `pv_id` integer, nullable
  - `max_words` integer
  - `tone` string
  - `language` string

## Response `200`

Successful Response

- AdDescriptionResponse — Response with generated ad description.
  - `description` string, required
  - `model_used` string

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/multigest/apis/multigest-protected-api.md) · [All operations](https://skmtc.dev/multigest/apis/multigest-protected-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/multigest/multigest-protected-api/revisions/4b44eb76b3ee/schema)