Listing SEO Auditor for Etsy sellers

Audit one listing—or a whole portfolio—without paying for another monthly SEO subscription.

This Actor audits one listing, an explicit batch, or up to 100 active listings from an authorized shop using official Etsy Open API listing data. It never opens a result/ad link, requests an Etsy login, or edits a listing.

Search rank and page-one competitors are an optional add-on, not part of the default audit. Etsy challenges automated browsers, so a live cloud capture usually returns no rank data. To get rank, autocomplete and competitors reliably, capture the search in your own authorized browser and pass it via marketSnapshots. Everything listed under "What each completed listing audit includes" below runs without it.

What each completed listing audit includes

• A deterministic listing-readiness score out of 100, with the scored checks shown
• Prioritized title, description, image, video, tag, and digital-product findings
• A suggested title, 13 Etsy-length-checked tags, and a description opener
• A clear kept/added/dropped tag plan
• Supply-index evidence for the buyer phrase you provide
• Mechanical validation that rejects unsupported keywords and malformed AI output
• One structured dataset item, a machine-readable SUMMARY record, and a self-contained REPORT.html

Only when you supply an authorized browser capture

• Timestamped observed rank across one or two Etsy result pages
• Page-one organic competitors enriched through the official API
• Autocomplete wording, live demand badges, visible basket activity, ad share, discounting, and price range
• Competitor photo/video/description/tag gaps and relative public traffic context

Without a capture, marketIntelligence.status is unavailable and the report's notMeasured list says so explicitly. The audit price is the same either way — it pays for the listing audit, scoring and copy work, which do not depend on a storefront snapshot.

The score measures listing completeness and copy readiness. Observed rank is specific to the run's time, locale, proxy, and session. It is not a universal rank or a prediction of traffic, sales, conversion rate, revenue, or profit.

Pricing

Mode	Price per completed audit	AI cost
Managed Gemini	$0.075	Included
Bring your own Gemini key	$0.015	Charged by Google to your account
Deterministic-only or partial result	No completed-audit event	No model call when AI is off

The Actor charges a completed-audit event only after a valid result has been stored. A failed model call or deterministic-only result is returned as partial and is not charged as a completed listing audit. Apify may apply its own platform discounts or account-specific billing rules.

Input

{
  "listingUrl": "https://www.etsy.com/listing/YOUR_LISTING_ID/your-listing",
  "targetKeyword": "the buyer phrase you want to assess",
  "confirmAuthorizedListing": true,
  "acceptTerms": true,
  "useAi": true
}

Use a listing you own, manage, or are otherwise authorized to audit. A bare numeric listing ID also works.

For a batch, provide audits: [{ "listingUrl": "...", "targetKeyword": "..." }]. For a shop sweep, provide the exact shopName and maxListings (1–100). Shop phrases are derived from each listing's first multi-word tag or title and clearly labeled for review. marketIntelligenceLimit controls how many listings receive the slower browser snapshot (maximum 25); every selected listing still receives the official-API readiness audit.

If Etsy returns an anti-bot challenge to the cloud browser, the audit continues with market fields marked unavailable—never zero. An authorized seller can optionally pass marketSnapshots captured in their own browser; the Actor validates the Etsy search URL and exact keyword before using that evidence. It does not spoof a device fingerprint or bypass the challenge.

Optional BYOK

Add geminiApiKey as a secret input to use your own Google Gemini API account. The key overrides the managed key, is used only for that run, and is never returned in the dataset or printed in logs.

No-AI mode

Set useAi to false to receive the deterministic score and findings without sending listing content to Gemini. Because no generated rewrite is produced, the result is labelled partial and no completed-audit event is charged.

Output

The default dataset contains one item per listing. Important fields include:

• status: completed or partial
• score: readiness total, band, rubric version, dimensions, and checks
• summary and priorities: the main diagnosis and ordered actions
• rewrite: suggested title, 13 tags, and description opener
• tagChanges: tags to keep, add, and drop
• evidence: supply-index coverage and phrase-pool counts
• marketIntelligence: observed ranks, page-one market, autocomplete, demand badges, competitor gaps, keyword opportunities, traffic context, and explicit scope
• validation: whether every mechanical output rule passed
• ai: provider mode, model, repair status, errors, and token usage when reported
• etsyDataRetrievedAt and retention: retrieval and content-expiry timestamps

The run output schema links to the dataset, SUMMARY, and printable REPORT. A multi-listing run stores a portfolio dashboard in REPORT and an individual REPORT_<listing-id> plus SUMMARY_<listing-id> for every successful listing. A shop run also stores SHOP_SNAPSHOT.

Explicit limits

• No universal rank claim—only the exact timestamped search snapshot captured in the run
• No keyword search volume—autocomplete proves related wording, not popularity
• No clicking/opening of result cards or ads; competitor details come from the Open API
• No Etsy account login, OAuth order data, buyer data, or automatic listing edits
• No guarantee that applying a recommendation changes marketplace performance

The Etsy API keyword endpoint is used as a supply index, not presented as Etsy search ranking.

Data handling and collection boundary

• Listing content, tags, images, public counters, shop data, and competitor details use the official Etsy Open API
• The authorized market browser opens only internally constructed /search?q=... pages and Etsy's same-origin autocomplete endpoint
• Result and ad destinations are never opened; Etsy credentials, orders, buyers, and private account data are never requested
• One listing, a seller-defined batch, or an authorized whole-shop sweep per run
• AI is optional and disclosed in the input form
• Customer API keys are secret inputs and are never logged or stored in output
• Web search and grounding are disabled for the model
• Suggested keywords are constrained to evidence collected for the audit and mechanically validated

Read the Privacy Policy and Terms of Use before running the Actor. The input requires affirmative acceptance.

Support

Questions or reproducible problems: digitasfortuna@gmail.com

When reporting an issue, include the Apify run ID and remove any API keys or other secrets.

---

The term “Etsy” is a trademark of Etsy, Inc. This application uses the Etsy API but is not endorsed or certified by Etsy, Inc.

Listing SEO Auditor is independently provided by FortunaDigitas3D.