Overview

The ProductPolish API lets you programmatically create SEO-optimised product texts and AI-generated product images. Ideal for e-commerce teams who want to fill their product pages automatically or integrate their own software.

Authentication

All API requests are authenticated via a personal API key.

1. 1

   Generate API key

   Open the API Access section in the dashboard and generate your personal key. The key is shown only once — store it securely.

2. 2

   Send header with every request

   Authorization: Bearer pp_live_...

POST /api/v1/generate

Starts a new product text generation and returns a generationId. The actual generation runs asynchronously.

{
  "generationId": "550e8400-e29b-41d4-a716-446655440000"
}

GET /api/generation/{id}

Retrieves the current status and result of a generation. The same Bearer token as for the POST is required.

{
  "status": "delivered",
  "seo_title": "SEO-optimised product title",
  "meta_description": "Short meta description for search engines...",
  "long_description_html": "<p>Detailed product text in HTML...</p>",
  "bulletpoints": [
    "Ergonomic backrest with lumbar support",
    "Height-adjustable from 42 to 52 cm"
  ],
  "tags": ["office chair", "ergonomic", "height-adjustable"],
  "faq": [
    {
      "question": "Is the chair suitable for long working hours?",
      "answer": "Yes, the lumbar support..."
    }
  ],
  "generated_images": [
    "https://...",
    "https://...",
    "https://..."
  ]
}

Asynchronous Flow

Generation takes 2–10 seconds depending on load. The recommended flow:

1. 1.POST /api/v1/generate → you receive a generationId
2. 2.Wait 3 seconds
3. 3.Call GET /api/generation/{id}
4. 4.If status === "pending" → back to step 2
5. 5.If status === "delivered" → done ✓

POST /generate → { generationId }
       ↓
   wait (3 sec)
       ↓
GET /generation/{id} → status: "pending"  → wait again
       ↓
GET /generation/{id} → status: "delivered" → done ✓

Recommendation: poll every 3 sec, trigger timeout after 60 sec (20 attempts).

Code Examples

# Step 1: Start generation
curl -X POST https://www.productpolish.ai/api/v1/generate \
  -H "Authorization: Bearer pp_live_..." \
  -H "Content-Type: application/json" \
  -d '{"title":"Ergonomic Office Chair","description":"Height-adjustable, lumbar support","language":"en","imageUrl":"https://example.com/image.jpg"}'

# Step 2: Retrieve result (poll)
curl https://www.productpolish.ai/api/generation/GENERATION_ID \
  -H "Authorization: Bearer pp_live_..."

Error Codes

Plans & Limits

API access is exclusively included in the Business plan.