E-Commerce Product Description Rewriter

E-Commerce Product Description Rewriter scrapes public product pages, extracts the current description, grades it from 0 to 100 against SEO copywriting criteria, and rewrites it with AI. Each result includes the original text, rewritten text, score breakdown, score improvement, keyword, tone, language, and source URL.

Use it for Shopify, WooCommerce, Magento, BigCommerce, custom storefronts, marketplace listings, SEO audits, or catalogue content refreshes.

Why use the E-Commerce Product Description Rewriter?

Most AI copywriting tools require pasted text. This actor starts from product page URLs, renders the page with Playwright, extracts the product name and description, scores the original copy, rewrites it with Llama 3.3 70B through Groq, then scores the rewritten version with the same rubric.

Capability	Generic AI copy tool	E-Commerce Product Description Rewriter
Input needed	Manual product text	Product page URLs
Page scraping	No	Yes, with browser rendering
SEO score before rewrite	Usually no	Yes, 0-100 with breakdown
SEO score after rewrite	Usually no	Yes, with score delta
Keyword handling	Prompt-dependent	Natural keyword placement
Batch runs	Manual	Multiple URLs per run
API access	Varies	Apify API, schedules, datasets

product URLs -> scrape product copy -> score original -> AI rewrite -> score rewrite -> Apify dataset/API

What data does the E-Commerce Product Description Rewriter return?

Each dataset item represents one processed product page. Pages without a usable description are skipped and logged.

Field	What it means
url	Source product page URL
productName	Product name extracted from the page, or null
originalDescription	Description scraped from the product page
originalSeoScore, rewrittenSeoScore	Before and after scores from 0 to 100
originalSeoBreakdown, rewrittenSeoBreakdown	Scores for word count, benefits, uniqueness, keyword use, and readability
originalSeoIssues, rewrittenSeoImprovements	Problems found and improvements detected
rewrittenDescription	AI-rewritten product description
scoreImprovement	Difference between rewritten and original score
wordCount	Word count of the rewritten description
targetKeyword	Keyword supplied in input, or null
tone	Tone used for the rewrite
language	Output language selected in input
runId	Optional parent workflow run ID copied from input
scrapedAt	ISO timestamp when the page was processed

What can you do with rewritten product descriptions?

• Refresh duplicate manufacturer copy by rewriting supplier-provided descriptions into more original, benefit-led product copy.
• Audit SEO quality at scale with before and after scores for each product page.
• Prepare catalogue updates for Shopify, WooCommerce, Magento, BigCommerce, custom CMSs, or marketplaces.
• Support SEO agency deliverables with CSV or JSON exports showing score deltas and rewritten text.
• Localize product copy by outputting descriptions in English, Spanish, French, German, Portuguese, Italian, or Dutch.
• Connect content workflows by sending output to Apify datasets, API clients, webhooks, Zapier, Make, n8n, or downstream actors.

How do I rewrite product descriptions?

1. Add one or more product page URLs in startUrls.
2. Optionally set targetKeyword, such as men's running shoes or organic cotton hoodie.
3. Choose a tone: Professional, Casual, Enthusiastic, or Minimalist.
4. Set targetWordCount. Use 150-250 words for most product pages.
5. Choose the output language.
6. Set maxProducts to limit the batch size, then start the actor.
7. Export the dataset as JSON, CSV, Excel, or fetch it through the Apify API.

What input does the E-Commerce Product Description Rewriter need?

{
  "startUrls": [
    { "url": "https://www.allbirds.com/products/mens-tree-runners" }
  ],
  "targetKeyword": "men's running shoes",
  "tone": "Enthusiastic",
  "targetWordCount": 200,
  "language": "English",
  "maxProducts": 1
}

Field	Type	Default	Description
startUrls	Array	required	Direct product pages. Do not use category pages, homepages, search results, or carts.
targetKeyword	String	blank	Main SEO keyword to integrate naturally. If blank, the AI chooses relevant product terms from the page.
tone	String	Professional	Rewrite style. Options: Professional, Casual, Enthusiastic, Minimalist.
targetWordCount	Integer	200	Approximate rewrite length. Allowed range: 80-500 words.
language	String	English	Output language for the rewritten description.
maxProducts	Integer	5	Maximum URLs to process in one run. Allowed range: 1-100.
datasetId	String	blank	Optional existing Apify dataset that also receives each row.
runId	String	blank	Optional parent workflow run ID copied into each output row.

What does the output look like?

{
  "url": "https://www.allbirds.com/products/mens-tree-runners",
  "productName": "Men's Tree Runners",
  "originalDescription": "Lightweight sneakers made with breathable eucalyptus fiber.",
  "originalSeoScore": 52,
  "rewrittenDescription": "Move through warm days in men's running shoes designed around cool comfort...",
  "rewrittenSeoScore": 84,
  "originalSeoIssues": ["Description is too short for an SEO product page"],
  "rewrittenSeoImprovements": ["Target keyword appears naturally"],
  "scoreImprovement": 32,
  "wordCount": 198,
  "targetKeyword": "men's running shoes",
  "tone": "Enthusiastic",
  "language": "English",
  "runId": "optional-parent-run-id",
  "scrapedAt": "2026-07-18T20:00:00.000Z"
}

How do I run the E-Commerce Product Description Rewriter via API?

Trigger a run with curl:

curl -X POST "https://api.apify.com/v2/acts/trovevault~ecommerce-product-description-rewriter/runs" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"startUrls":[{"url":"https://www.allbirds.com/products/mens-tree-runners"}],"targetKeyword":"mens running shoes","tone":"Professional","targetWordCount":200,"language":"English","maxProducts":1}'

After the run finishes, read results from the default dataset or from the datasetId you supplied. You can also call the actor from MCP-compatible AI assistants through the Apify MCP server.

How do I fix common product rewrite issues?

Issue	Solution
No result for a URL	Use a direct product page where the description is visible without login. Avoid category pages and search pages.
Description is missing or too short	Check that the product page exposes real description text. The actor skips pages with less than 40 usable characters.
Page fails to load	Test fewer URLs and use public pages that do not require authentication.
Rewrite uses the wrong keyword	Set targetKeyword explicitly instead of leaving it blank. Use one precise search phrase, not a list of keywords.
Output is too long or too short	Adjust targetWordCount. The AI aims for the target length with normal variation.
Score does not improve	Review originalSeoIssues; some original descriptions are already strong or contain limited source detail.
Groq API key error	Configure GROQ_API_KEY in the actor environment variables before running.

Need help? Open the Issues tab with the run ID, URL, and log lines.

FAQ

Does it work on every e-commerce platform? It works on public product pages where the description is visible in the rendered page. It can handle Shopify, WooCommerce, Magento, BigCommerce, Prestashop, OpenCart, Wix Stores, custom storefronts, and similar sites, but restricted or highly customized pages may fail.

Does it rewrite variant-level content? No. Each dataset item represents one product page. Variant details may influence the scraped description only if they are visible on the page.

What is the SEO score? The score is 0-100 across five 20-point dimensions: word count, benefit-focused language, uniqueness, keyword use, and readability. The same rubric is used before and after the rewrite.

Can I process a full catalogue? Yes, if you provide product page URLs. Start with 1-5 URLs for testing, then increase maxProducts.

Can I append output to an existing dataset? Yes. Pass datasetId to write each result to an existing dataset as well as the run's default dataset. Pass runId to label rows from a parent workflow.

Can I use the output directly in my store? Yes, but review the rewritten text before publishing. Product copy should still be checked against your brand, compliance, and merchandising rules.

Is scraping and rewriting product descriptions legal? The actor reads public product pages. Accessing public data is generally lawful, but review the target site's terms, copyright considerations, and your use case.

What are the limitations of the E-Commerce Product Description Rewriter?

• It needs direct product page URLs; it does not discover every product in a store by itself.
• Pages that require login, block browser automation, hide descriptions, or expose less than 40 characters of usable copy may be skipped.
• Rewrites depend on source text. The actor is instructed not to invent specifications or claims.
• The GROQ_API_KEY environment variable must be configured for scoring and rewriting.
• The score is an SEO copywriting heuristic, not a guarantee of ranking improvement.
• Output should be reviewed before publishing to a live store or marketplace.