How do I authenticate?

Send your secret key as a Bearer token in the Authorization header on every request, over HTTPS. You can create and revoke keys in Settings → API.

Is there a bulk endpoint?

Yes. Submit many products in a single batch job and collect the results together, instead of making one request per product.

Do you support webhooks?

Yes. Register a callback URL and we POST the finished result when a job completes, so you do not have to poll. Every webhook is signed.

What formats can I send and receive?

Requests and responses are JSON. You send product titles and attributes and choose which outputs you want — description, bullets, pros and cons, SEO metadata, or translations.

REST API

Put product copy generation behind one API call

Send a product, get back a finished description, bullets, and SEO metadata. A straightforward REST API for teams who would rather wire it into their own stack than click around a dashboard.

What you get

Built for developers, not just dashboards

Everything the app does — descriptions, images, enrichment, translation — available over HTTP.

Simple REST endpoints

JSON in, JSON out

Predictable resources and standard HTTP verbs. If you have called an API before, you already know how this one works.

Bulk jobs

Thousands per request

Submit a whole catalog as one batch job and collect the results when it finishes — no looping one product at a time.

Webhooks

No polling required

Full control of output

Your voice, your fields

Pass tone, language, length, and which fields to generate on every request, so the output matches your store.

Setup

From key to first description in four steps

Authenticate, send a product, and read the result.

1
Create an API key
Open Settings → API in your StartDescribe account and generate a secret key. Treat it like a password and keep it server-side.
2
Authenticate your requests
Send the key as a Bearer token in the Authorization header on every request. All traffic is over HTTPS.
3
Submit a product
POST the product title and attributes to the enhancements endpoint. You get back a job id right away.
4
Collect the result
Poll the job by id, or register a webhook and we will POST the finished description, bullets, and SEO metadata to you.

API Reference

A few example requests

Replace YOUR_API_KEY with the key from your dashboard. Base URL: https://api.startdescribe.com/v1

Authenticatebash

curl https://api.startdescribe.com/v1/me \
  -H "Authorization: Bearer YOUR_API_KEY"

Enhance a productbash

curl https://api.startdescribe.com/v1/enhancements \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product": {
      "title": "Merino Wool Crew Sock",
      "attributes": { "material": "merino wool", "sizes": ["S", "M", "L"] }
    },
    "outputs": ["description", "bullets", "seo"],
    "tone": "friendly",
    "language": "en"
  }'

Retrieve the resultbash

curl https://api.startdescribe.com/v1/enhancements/enh_123 \
  -H "Authorization: Bearer YOUR_API_KEY"

Example responsejson

{
  "id": "enh_123",
  "status": "completed",
  "result": {
    "description": "Soft, breathable merino crew socks built for all-day wear...",
    "bullets": ["Temperature-regulating merino wool", "Cushioned footbed", "Reinforced heel and toe"],
    "seo": { "title": "Merino Wool Crew Socks", "metaDescription": "Stay comfortable in soft merino crew socks..." }
  }
}

Production-ready

The details you need before you ship

Built to sit in a real pipeline, not just a demo.

Predictable rate limits

Clear per-key limits, with the current usage returned in headers on every response.

Idempotent requests

Send an idempotency key to safely retry a request without creating duplicate jobs.

Signed webhooks

Every webhook is signed so you can verify it came from us before trusting the payload.

Same engine as the app

The API uses the same models and settings as the dashboard, so output is consistent everywhere.

Compatibility