API reference

Generate destination-specific product copy from confirmed facts. The six core marketplaces use native copy; Google Merchant Center uses a reviewed manual feed, Facebook Marketplace, Mercado Libre, Newegg, Allegro, Noon, Shopee, Lazada, Flipkart, Temu and Rakuten Japan use reviewed manual-entry sheets, WooCommerce uses a simple draft-only CSV, BigCommerce uses a hidden-product CSV beta, and Meta Shops uses a seller-imported catalog CSV beta after Review. Uses your saved brand voice unless supplied. Consumes 1 listing from your monthly quota.

Generate up to 10 listings in one call (rows of product facts, one platform). Studio tier and up. Consumes one quota listing per row.

Turn a supplier or brand catalog PDF into ready-to-publish listings. Give a public pdf_url (up to 10MB); we read the whole document, extract each product's facts, and generate a platform-optimized listing per product (up to max_products, default 5, max 8). Studio tier and up. Consumes one quota listing per product actually generated.

The Optimlister Roast — a sharp, funny but fair teardown of a listing with a score out of 100, a rebuilt title, and the highest-impact fixes. Give listing_text OR just a public listing_url (we read the page live). FREE — uses no listing quota (fair-use daily cap by tier, 3-100 roasts per 24h shared across text and video; when capped, pass boost:true to spend 1 credit for +10 today). Every roast returns a public shareable link.

The Optimlister VIDEO Roast — we actually watch your product video (TikTok Shop clip, Amazon upload, anywhere) and roast it: score out of 100, hook check on the first 2 seconds, what's killing it, claims and compliance risks, and a rebuilt shot list. Give a direct public video file URL (mp4/mov/webm, max 15MB) or raw base64. FREE — uses no listing quota (shares the roast daily cap with roast_listing; boost:true = 1 credit for +10 today). Returns a public shareable roast link.

Write one piece of seller store copy from supplied facts: packaging insert / thank-you card, storefront About page, influencer outreach pitch, shipping & returns policy starter, or a TikTok creator collab brief. Consumes 1 quota listing.

Image set director: plans the complete marketplace image gallery for one product - hero, lifestyle, infographic, detail, scale, packaging, and trust shots - with per-platform pixel and background rules, a composition brief per shot, and a ready prompt line you can feed straight into platform_image. Built only from your confirmed facts. Consumes 1 quota listing.

Amazon A+ Content generator: a complete module-by-module A+ layout (hero banner, feature modules, brand story - 5 to 7 modules) with publish-ready headlines and body copy PLUS a precise image brief per module you can feed straight into platform_image. Built only from your confirmed facts. Consumes 1 quota listing.

Walmart Pro Seller Badge coach: audits the seller metrics you supply (delivery defects, cancellations, on-time delivery, listing quality, ratings) against Walmart's published badge guidance and returns a readiness score, PASS/AT RISK/FAIL per criterion, the exact Seller Center reports to pull for anything missing, and a prioritized 30-day plan with quick wins. Consumes 1 quota listing.

Etsy seasonal SEO calendar: live-researched 90-day plan for your niche - the occasions and gift moments coming up, the search phrases buyers will start typing, publish-by dates (Etsy needs 5-6 weeks of lead time), and a listing refresh queue with title angles and tag swaps. Consumes 1 quota listing.

Etsy shop audit: an honest, constructive teardown of your whole shop presence - first impressions, listing title patterns, About story, policies and trust gaps - ending with THE REBUILD: a rewritten shop announcement, About opening, and rebuilt titles, all paste-ready and built only from what you supply. Consumes 1 quota listing.

TikTok Shop trend radar: live-researched read on what is trending in your niche RIGHT NOW - angles gaining traction, hashtag and hook patterns, plus READY-TO-SHOOT IDEAS (hook line + 15-second beats + caption) and a ride-or-skip verdict per angle. Consumes 1 quota listing.

Shopify collection-page SEO pack: page title, meta description, buyer-focused collection copy (above and below the product grid), a specific internal-linking plan with anchor text, and an FAQ snippet - collection pages rank for category searches your product pages cannot win. Consumes 1 quota listing.

Google Shopping feed title optimizer for Shopify sellers: rewrites up to 10 product titles for the FEED (not the page), front-loads the first 70 characters, and returns Google's required structured_title AI disclosure fields with reusable rules and policy watch-outs. Consumes 1 quota listing.

Generate 5 alternative titles for A/B testing an existing listing title. Consumes 1 quota listing.

Generate a buyer-facing FAQ section for a product from its details, policies, and the questions buyers actually ask. Consumes 1 quota listing.

Keyword-gap analysis: compares your listing against a competitor's and surfaces the high-priority keywords they use that you don't, with where to add them. Consumes 1 quota listing.

Score a listing 0-100 across five dimensions (returned as structured JSON text) — the Optimlist Optimization Score. Consumes 1 quota listing.

Review-ready field pack for six core channels, Google Merchant Center's AI-disclosed manual feed fields, Facebook Marketplace, Mercado Libre, Newegg, Allegro, Noon, Shopee, Lazada, Flipkart, Temu and Rakuten Japan manual-entry fields, or WooCommerce simple draft fields. BigCommerce and Meta Shops use guided Create so exact seller-entered source values remain bound to Review and export. Returns strict JSON, not a publishing action. Consumes 1 quota listing.

Take your product into a new country: live local-language market research (how buyers actually search, local competitors, price landscape) + a localized title, hook copy, and keyword starter set + that market's regulatory checklist + a 30-day go-to-market plan. Works for the 25 supported markets across all six platforms. Costs 2 credits; uses no listing quota.

Listing SOS - emergency triage for a suppressed, flagged or removed listing. Paste the marketplace notice and the listing it hit; returns the likely cause, a compliant rewrite, and a draft plan of action to send back.

Suppression-risk and compliance lint: checks a listing against the marketplace's real enforcement patterns (banned claims, promo language, trademark traps, title limits) and returns RISK LEVEL, exact violating phrases, gray areas, and paste-ready fixes. Platform-specific for the six core and three expanded Create/Review channels. Consumes 1 quota listing.

Live keyword & trend scout: searches Google RIGHT NOW for how buyers search and talk about your product niche on your platform. Returns primary keyword candidates, long-tail phrases, trending angles, seasonal hooks, and sources. Qualitative live signals (not search-volume data). Free — consumes no quota. Fair-use daily cap by tier (3–100 calls/24h); when capped, pass boost:true to spend 1 credit for +10 calls today.

Turn one product photo into a platform-native listing image. Standard costs 2 credits. Pro costs 4 credits and creates two persisted candidates, compares each with the source for product fidelity and marketplace readiness, then selects the stronger result. Human review is still required. Credit packs: $10 for 50, $25 for 140, $60 for 350.

Real sales analytics from your raw CSV export (works with Amazon, Etsy, eBay, Walmart, Shopify, and TikTok Shop exports): every number is COMPUTED by running code against your data — revenue summary, top products, trends with growth percentages, margins when cost columns exist, restock signals, and ranked actions. Consumes 1 quota listing.

Generate an 8-second platform-native product video with native audio (Veo). Standard is a fast 720p draft at 17 credits; Pro uses premium Veo at 1080p for higher-end production workflows at 75 credits. Optionally start from your product photo. Returns a job_id; failed generation is auto-refunded. Uses no listing quota.

FREE scan: which of your saved marketplace listings still have no photos or no video. Matching is best-effort by product name (media generated from a listing usually carries its name), so treat it as a to-do list, not an audit. Returns per-listing has_photos / has_video flags plus fill costs (photo 2, 8-second spot 17, 16-second film 34). Uses no credits and no listing quota.

Check any video job (product_video / video_pack / long_video): returns generating / completed (with the hosted video URL) / failed (credits auto-refunded). Free — consumes no quota. Pass wait_seconds (up to 120) to long-poll: the call rechecks every 15s and returns as soon as the job finishes or the wait runs out; each check also advances multi-shot films.

Your Optimlister account: tier, monthly usage and limit, credits, badge, and streak. Free — consumes no quota.

Saw a photo or video anywhere - a competitor's listing, a TikTok ad, a Pinterest shot - with a look you want for YOUR product? We watch the reference and reverse-engineer its reproducible aesthetic into an editable style brief: lighting, setting, composition, palette, mood, and for video also hook, pacing, motion, and audio feel. Brands, logos, people, and on-screen text are deliberately excluded - you get the craft, never a copy. Then feed the brief to image_edit (your photo, this look) or product_video / video_pack (your product, this energy) via their style_brief field. Costs 1 credit; uses no listing quota.

Long-form product film: 16, 24, or 32 seconds built from 2-4 continuous 8-second shots, stitched with one voiceover. Standard is 720p at 17 credits per shot; Pro uses premium Veo at 1080p for 75 credits per shot. Refunded in full if generation fails; uses no listing quota.

Edit a hosted product video (any https mp4 — e.g. the URL from video_status): trim, aspect (9:16 / 1:1 / 16:9 crops for TikTok, feeds, and PDPs), speed (0.25x-4x, plus mute or your own licensed music track URL), cover_frame (poster JPEG for the listing), captions (burned-in, timed — your own lines or answer-shaped lines written from your keywords for SEO and AEO), voiceover (studio narration — your own script or one written from your keywords, mixed over the native audio). Edited files are stored under keyword-rich filenames and every text asset (captions, transcript, script) is returned for reuse as page copy. Costs 1-3 credits by action; uses no listing quota.

Per-marketplace 8-second video set with native art direction and one shared voiceover. Standard is 720p at 17 credits per platform; Pro uses premium Veo at 1080p for 75 credits per platform. Each failed generation is auto-refunded; uses no listing quota.

Semantic search over your own saved listings (the Vault): find the listings most similar to a given listing or product description. Free — consumes no quota.

List your recent saved Optimlister outputs (the Vault): generated listings, copy packs, etc. Free — consumes no quota.

Per-unit profit and fee breakdown for a price on any of the six platforms: referral/transaction fees, payment processing, listing fees, optional ads and fulfillment, then margin, breakeven price, and the prices needed for 20/30/40% margin. Deterministic math on published standard rates. Free — consumes no quota.

Turn reviewed listing fields into a safe transfer artifact: an unpublished Shopify draft CSV or a mapping/copy sheet for eBay, Amazon, Walmart, Etsy, or TikTok Shop. Nothing publishes automatically. Pass fields directly, or a same-platform listing_id from your vault. Free — consumes no quota.

Amazon parent/child variation strategist: whether to variate at all, which variation theme to use, and a paste-ready family tree - parent title plus one consistent child title per variant - with per-child differentiation rules, misuse warnings, and migration steps for existing listings. Consumes 1 quota listing.

Generate a clean, consistent SKU scheme: parent SKU plus one SKU per variant combination (brand prefix + product code + variant codes, uppercase, hyphenated). Deterministic - the same inputs always produce the same SKUs. Free - consumes no quota.

Resize and pad a product photo to supported marketplace presets on a white background: Amazon/Walmart 2000x2000, Etsy 3000x2250 (4:3), eBay 1600x1600, Shopify 2048x2048, TikTok Shop 1200x1200. Pass one platform or 'all'. Returns hosted image URLs. Free - consumes no quota or credits.

Edit a product photo with AI: white background, lifestyle staging, cleanup, relight, or custom direction. Standard costs 2 credits. Pro costs 4 credits and selects between two persisted candidates after source-fidelity and technical review. Human review remains required.

Free pre-check of a product photo against a marketplace's image norms: background, product fill, added text or watermarks, sharpness, crop - each PASS or RISK with concrete fixes and the fastest path to ready. Shares the free roast daily cap for your tier. Consumes no quota or credits.

One product photo in, draft listings out: the photo is read for what the product actually is, then draft copy is written for the marketplaces you name - with a real demand check on the draft's own wording. The photo alone is enough; notes add facts. Consumes 1 quota listing.

The roast, but for the photo: what the picture is doing to your conversion - background, angle, light, story - scored honestly with the fixes in order. Pair it with the image rules check before you upload. Shares the free roast daily cap for your tier. Consumes 1 quota listing.

Generate a listing-gallery infographic only from supplied facts. Standard costs 2 credits. Pro costs 4 credits and selects between two persisted candidates after technical and source-fidelity review. Always proof-read rendered text before publishing.

Keywords worth chasing: one seed keyword in, the demand landscape around it out - up to 100 related terms with real monthly volumes, sorted by demand. Amazon mode reads Amazon shopper searches; Google mode (the default) reads Google. Costs 1 credit.

What do they rank for: any domain in, its Google keyword map out - the search terms it ranks for, each with real monthly volume and their position. The fastest honest read of a competitor's search strategy. Costs 2 credits.

Paste your product reviews and get the patterns: what buyers praise, what loses sales, the exact words buyers use - plus measured search demand for that buyer language. Consumes 1 quota listing.

Reviews in one hand, your listing in the other: the exact edits your own buyers have already told you to make - plus measured demand for the listing's wording. Consumes 1 quota listing.

The reply that de-escalates and protects the account: negative reviews, buyer questions, disputes, feedback-revision requests - paste what they wrote, get what to send back. Consumes 1 quota listing.

The silent listing killers: typos, unit mistakes, contradictions, broken formatting - found line by line before buyers find them. Consumes 1 quota listing.

What age does to a listing and the refresh that revives it: paste the listing and how old it is, get the staleness read and the moves - plus live demand for its own keywords. Consumes 1 quota listing.

The same product, rewritten for the season buyers are shopping right now - Christmas, back to school, wedding season, whatever is coming - demand-checked against real searches. Consumes 1 quota listing.

Paste competitor listings, ASINs or URLs and get the read: what they changed, what is working for them, and what to counter. Pair it with What do they rank for to see the keywords behind it. Consumes 1 quota listing.

Raw product description in, nine clean attributes out - material, construction, finish, weight, dimensions, use case, certifications, GTIN - ready for any feed or field pack. If a GTIN is found, its check digit is validated on the spot. Consumes 1 quota listing.

A positioning brief for one product in one category: where to price, what to claim, what to avoid, and how the category actually competes - plus measured demand for the product's own wording. Consumes 1 quota listing.

Will an AI shopping agent pick your listing? Scores it against what agentic buyers parse - structured facts, unambiguous claims, machine-readable completeness - and returns the fixes in priority order, plus a real demand check on your own wording. Consumes 1 quota listing.

Does your listing read as AI-written? Spots the tells - the em-dash chains, the elevate-your openers, the empty superlatives - that make buyers and marketplace filters distrust a listing, with the plain rewrite move for each. Consumes 1 quota listing.

Brand-name risk patterns in your product name and copy - the words that trip trademark-adjacent filters or invite an IP complaint - caught before a marketplace flags them. Pattern spotting, not legal advice. Consumes 1 quota listing.

Paste up to 20 listings (a title per line, or title-plus-description blocks) and get a catalogue-level audit for one marketplace: duplicates and cannibalisation, gaps, weak titles, what to fix first - plus a real demand check on your own top phrases. Consumes 1 quota listing.

The pre-flight check: paste what you know about the product and see what is MISSING before you write the listing - the absent facts (dimensions, materials, compatibility) that cause returns and suppressions later. Consumes 1 quota listing.

Which of the six marketplaces actually fits this product? Fees, audience, category norms and competition weighed per platform, with a verdict and a launch order - plus real search demand for the product's own wording. Consumes 1 quota listing.

UPC / EAN / GTIN lookup: confirms the barcode number is mathematically real (the GS1 check digit), then searches live Google Shopping for what the market already sells under it - so an invalid or recycled code is caught before Amazon or Walmart rejects the listing. Free, with a daily cap by tier.

Where your price really sits: prices retailers show in live Google results for your keyword - how many priced sellers appear, the cheapest, the median, the priciest, and exactly where your price lands among them. Useful across marketplaces because buyers compare across retailers. Costs 1 credit.

The Ambush List: keywords where you already sit on page 2 - positions 11 to 30 in your tracked rank checks - with real search volume attached. One push from page 1, where the clicks live. Free. Track a competitor's domain and their page-2 spots show up as openings too.

The Category Invasion Report: one product niche in, a battle plan out - the demand landscape with real volumes, who owns the category today, the undefended keywords, and your three best entry points. Supply your product facts and it also writes a finished listing for each entry point. Costs 5 credits, the three listings included.

The reverse-ASIN read: every keyword an Amazon product ranks for, with real monthly searches and its exact position - split into the top 20 and the reachable rest, with the product's title, price and rating on top. Run it on your own ASIN to see what is working, or on a competitor's to read their whole keyword strategy in one go. Any Amazon country (US default). Costs 2 credits.

FREE: the stored day-by-day price, rating and review-count history for an Amazon ASIN we snapshot - your product or a competitor's. History accumulates automatically from daily rank checks, competitor scans and watches; every point is a real stored observation, never an estimate.

Who competes with an Amazon product: the ASINs that share its search results, ranked by how many keywords they overlap on - each with its title, price, rating, average position and total demand, plus the price band across them and where yours sits. The map of who you are fighting - then read any of them with the reverse-ASIN tool. Any Amazon country (US default). Costs 2 credits.

Price and rating history for any ASIN, one point per day, built from every day someone here looked at it: your own runs of the Amazon tools, the extension reading the product page, and the daily watch on every ASIN you track. Never an estimate - each point is what Amazon showed that day. Free.

Where you rank right now - and every check is remembered, so movement shows over time. Google mode (default): finds your domain or URL in the top 100 organic results for a keyword. Sellers on Etsy, Amazon, Walmart, Shopify or TikTok Shop: use Google mode with your shop or listing URL - marketplace pages rank on Google. eBay mode finds your listing or seller in live eBay search. Amazon mode: give your ASIN as the target and get your real position in Amazon search for that keyword - rechecked daily on paid plans. Works on competitors too - track their domain and you get the alert when THEY slip. Free within a daily cap that scales with tier; paid plans get tracked keywords rechecked daily with a drop alert.

Real monthly search volumes for up to 200 keywords. Amazon mode reads Amazon shopper searches; Google mode (the default) reads Google - the demand source for Etsy, Walmart, Shopify and the open web - with CPC and advertiser competition. Sorted by volume. Costs 1 credit.

Live eBay market pulse for a keyword, straight from eBay's own catalog: how many listings match, the top listings with real prices and conditions, and the most common title words - genuine data for pricing and title research, not estimates. Free - consumes no quota. (Sandbox mode searches eBay's test inventory until production keys land at launch.)

Your eBay listing traffic from eBay's own analytics: impressions, views, click-through rate, and sales conversion for the connected eBay account. Optionally filter to specific listing ids. Requires Connect eBay. Free - consumes no quota or credits.