npm package: @sharpapi/sharpapi-node-product-description
Description: SharpAPI.com Node.js SDK for generating product descriptions
Author: Dawid Makowski
Latest version: 1.0.2

![SharpAPI GitHub cover](https://sharpapi.com/sharpapi-github-php-bg.jpg "SharpAPI Node.js Client")

# Product Description Generator API for Node.js

## Generate professional e-commerce product descriptions -- powered by SharpAPI AI.

[![npm version](https://img.shields.io/npm/v/@sharpapi/sharpapi-node-product-description.svg)](https://www.npmjs.com/package/@sharpapi/sharpapi-node-product-description)
[![License](https://img.shields.io/npm/l/@sharpapi/sharpapi-node-product-description.svg)](https://github.com/sharpapi/sharpapi-node-product-description/blob/master/LICENSE.md)

**SharpAPI Product Description Generator** creates compelling, SEO-optimized product descriptions from raw product data. Supports multiple languages, customizable tone of voice, and length control. Perfect for e-commerce platforms, product catalogs, and marketplace listings.

---

## Table of Contents

1. [Requirements](#requirements)
2. [Installation](#installation)
3. [Usage](#usage)
4. [API Documentation](#api-documentation)
7. [Use Cases](#use-cases)
10. [License](#license)

---

## Requirements

- Node.js >= 16.x
- npm or yarn

---

## Installation

### Step 1. Install the package via npm:

```bash
npm install @sharpapi/sharpapi-node-product-description
```

### Step 2. Get your API key

Visit [SharpAPI.com](https://sharpapi.com/) to get your API key.

---

## Usage

```javascript
const { SharpApiProductDescriptionService } = require('@sharpapi/sharpapi-node-product-description');

const apiKey = process.env.SHARP_API_KEY; // Store your API key in environment variables
const service = new SharpApiProductDescriptionService(apiKey);

const productData = 'Wireless Bluetooth Headphones, 40mm drivers, active noise cancellation, 30-hour battery, foldable design, USB-C charging';

async function generateDescription() {
  try {
    // Submit processing job
    const statusUrl = await service.generateProductDescription(productData);
    console.log('Job submitted. Status URL:', statusUrl);

    // Fetch results (polls automatically until complete)
    const result = await service.fetchResults(statusUrl);
    console.log('Result:', result.getResultJson());
  } catch (error) {
    console.error('Error:', error.message);
  }
}

generateDescription();
```

---

## API Documentation

### Methods

#### `generateProductDescription(productData, language?, maxLength?, voiceTone?, context?)`

Generates a professional product description from the provided product data.

**Parameters:**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `productData` | string | Yes | Product details, features, and key information |
| `language` | string | No | Output language (default: English) |
| `maxLength` | number | No | Maximum character length of the description |
| `voiceTone` | string | No | Tone of the description (e.g., "Professional", "Casual", "Luxury") |
| `context` | string | No | Additional context for the AI (e.g., target audience, platform) |

**Returns:** Promise<string> - Status URL for polling results

---

## Use Cases

- **Product Listings**: Create detailed, persuasive descriptions for online stores
- **Bulk Catalog Upload**: Generate descriptions for large product catalogs
- **SEO Optimization**: Create keyword-rich descriptions for better search rankings
- **Marketplace Adaptation**: Generate platform-specific descriptions (Amazon, Shopify, eBay)
- **Multi-language Stores**: Generate descriptions in multiple languages from a single source
- **A/B Testing**: Create description variations for conversion optimization
- **Content Localization**: Adapt product messaging for different markets and audiences

---

## API Endpoint

**POST** `/ecommerce/product_description`

**Request Body:**
```json
{
  "content": "Product details and features...",
  "language": "English",
  "max_length": 500,
  "voice_tone": "Professional",
  "context": "Additional context for the AI..."
}
```


## License

This project is licensed under the MIT License. See the [LICENSE.md](LICENSE.md) file for details.

---

## Support

- **Documentation**: [SharpAPI.com Documentation](https://sharpapi.com/documentation)
- **Issues**: [GitHub Issues](https://github.com/sharpapi/sharpapi-node-product-description/issues)
- **Email**: contact@sharpapi.com