Copy and dialects | Lahjty API

Generate Arabic or English ad copy and headlines, or convert approved Arabic copy into one of seven dialects.

POST/copy-generations

Arabic ad copy in Saudi dialect

Use output_language with market and dialect for explicit market and dialect control.

curl --request POST \
  --url https://www.lahjty.com/api/v1/copy-generations \
  --header "Authorization: Bearer $LAHJTY_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: copy-ar-sa-1842" \
  --data '{
  "type": "ad_copy",
  "description": "Weekend offer: 20% off specialty coffee subscriptions",
  "output_language": "ar",
  "market": "SA",
  "dialect": "saudi",
  "platform": "whatsapp",
  "tone": "warm",
  "framework": "aida",
  "audience": "specific",
  "specific_audience": "Young professionals in Riyadh",
  "required_keywords": [
    "قهوة مختصة"
  ],
  "excluded_keywords": [
    "مجاني"
  ],
  "call_to_action": "اطلب الآن",
  "external_customer_id": "merchant-91"
}'

Example response

response.json

{
  "id": "cpy_01jexample",
  "object": "copy_generation",
  "request_id": "req_01jexample",
  "status": "completed",
  "type": "ad_copy",
  "output_language": "ar",
  "market": "SA",
  "dialect": "saudi",
  "dialect_source": "explicit",
  "variants": [
    {
      "index": 1,
      "content": "خصم 20٪ على اشتراك القهوة المختصة لنهاية الأسبوع. اطلب الآن.",
      "keyword_compliance": {
        "passed": true,
        "missing_required": [],
        "matched_excluded": []
      }
    }
  ],
  "usage": {
    "credits_used": 2,
    "balance_after": 498
  }
}

POST/copy-generations

English campaign copy

English is supported for copy and headlines. Send market context and omit dialect.

curl --request POST \
  --url https://www.lahjty.com/api/v1/copy-generations \
  --header "Authorization: Bearer $LAHJTY_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: copy-en-ae-1843" \
  --data '{
  "type": "ad_copy",
  "description": "Launch offer for a same-day flower delivery service",
  "output_language": "en",
  "market": "AE",
  "platform": "instagram",
  "tone": "warm",
  "framework": "pas",
  "call_to_action": "Order today",
  "external_customer_id": "merchant-92"
}'

Example response

response.json

{
  "id": "cpy_01jenglishexample",
  "object": "copy_generation",
  "request_id": "req_01jenglishexample",
  "status": "completed",
  "type": "ad_copy",
  "output_language": "en",
  "market": "AE",
  "dialect": "none",
  "dialect_source": null,
  "variants": [
    {
      "index": 1,
      "content": "Fresh flowers, delivered across Dubai today. Order now.",
      "keyword_compliance": {
        "passed": true,
        "missing_required": [],
        "matched_excluded": []
      }
    }
  ],
  "usage": {
    "credits_used": 2,
    "balance_after": 496
  }
}

POST/copy-generations

Campaign headlines

Set type to headlines when the merchant needs short headline variants instead of body copy.

curl --request POST \
  --url https://www.lahjty.com/api/v1/copy-generations \
  --header "Authorization: Bearer $LAHJTY_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: headlines-ar-ae-1844" \
  --data '{
  "type": "headlines",
  "description": "New premium date gift boxes for Ramadan",
  "output_language": "ar",
  "market": "AE",
  "dialect": "emirati",
  "platform": "instagram",
  "tone": "premium",
  "required_keywords": [
    "تمور فاخرة"
  ]
}'

POST/copy-generations

Convert approved copy to Iraqi Arabic

Dialect conversion preserves the commercial intent of supplied Arabic copy and costs one credit.

curl --request POST \
  --url https://www.lahjty.com/api/v1/copy-generations \
  --header "Authorization: Bearer $LAHJTY_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: convert-iq-1845" \
  --data '{
  "type": "dialect_conversion",
  "description": "قهوتك المفضلة توصلك لين باب البيت. اطلب الآن.",
  "output_language": "ar",
  "market": "IQ",
  "source_dialect": "saudi",
  "target_dialect": "iraqi",
  "platform": "whatsapp",
  "tone": "friendly"
}'

Keyword rules

keywords: preferred phrases used naturally when useful.
required_keywords: must appear in every returned variant.
excluded_keywords: must not appear in any variant.

Lahjty validates every variant, attempts one repair, then returns content_rejected with a refund instead of returning copy that violates a hard rule.