Help & support

Getting started

Four steps from 'my listings don't rank' to fixed.

1. 1. Audit your shop

   Type your shop name on the Shop audit page. Every active listing gets a score and a plain-language list of what holds it back. Free, no connection to Etsy needed.

2. 2. Fix the weak ones

   Open a listing and press Rewrite. We fetch its photos from Etsy, write a new title, 13 tags, description and attributes, and show old vs new side by side.

3. 3. Paste into Etsy

   Copy each field (or the whole listing, or a CSV) into your Etsy listing editor. Nothing is published by Listwright — you stay in control.

4. 4. Protect what you built

   Add your shop to the Vault for a backup of every listing and photo, and keep the Appeal Kit handy in case Etsy removes something.

Frequently asked

Contact support

A human reads every message. We reply within one business day, usually within hours.

API (Pro)

Everything the app does is available over HTTPS with your API key — for scripts, spreadsheets or a bulk tool.

Create a key on Account & billing (Pro plan). Send it as the X-API-Key header; the key has the same rights and listing balance as your account. Base URL https://listwright.shop. Limits: 5 photos per listing, 10 MB each; 1 listing credit per generation or rewrite.

# Generate a listing from photos (1 credit) — returns {"id": 123, "status": "queued"}
curl -X POST https://listwright.shop/api/listings \
  -H "X-API-Key: lw_..." \
  -F "images[]=@front.jpg" -F "images[]=@detail.jpg" \
  -F 'input={"category":{"taxonomy_id":2078,"path":"Art & Collectibles > Prints > Digital Prints"},
             "facts":{"product_name":"Frog Witch Print","what_it_is":"watercolor art print of a frog witch",
                      "materials":["PNG","PDF"],"kind":"digital","made_with_ai":true,"tone":"warm",
                      "target_keywords":["frog witch print"]}}'

# Poll until status is "done", then read the result (title, tags, description, attributes, alt_texts, policy_risk…)
curl -H "X-API-Key: lw_..." https://listwright.shop/api/listings/123

# CSV of one listing (Vela / eRank style columns)
curl -H "X-API-Key: lw_..." -o listing-123.csv https://listwright.shop/api/listings/123/export.csv

# Audit any shop — returns {"id": 7}; then GET /api/audits/7 for scores and issues per listing
curl -X POST https://listwright.shop/api/audits -H "X-API-Key: lw_..." -H "Content-Type: application/json" -d '{"shop":"YourShopName"}'

# Rewrite an audited listing using its own Etsy photos (1 credit)
curl -X POST https://listwright.shop/api/listings/rewrite -H "X-API-Key: lw_..." -H "Content-Type: application/json" \
  -d '{"audit_id":7,"etsy_listing_id":1234567890,"made_with_ai":false}'

# Find a category id
curl -H "X-API-Key: lw_..." "https://listwright.shop/api/taxonomy/search?q=mugs"

Also available: GET /api/listings (your listings), PUT /api/listings/:id (save edits), GET /api/me (balance), Vault and Appeal endpoints mirror the app. Errors come back as {"error": "message"} with the usual HTTP codes (402 = out of listings).