Etsy Trend & Shop Scout

Normalize listing and shop observations from configured public Etsy URLs.

What this Actor does

Return source-backed listing, shop, price, rating, review-count, and tag observations across supplied URLs.

• Inspect configured public Etsy listing or shop URLs.
• Normalize JSON-LD and page metadata.
• Aggregate repeated tags in the supplied URL set.

Who this is for

Etsy sellers, Marketplace analysts, Catalog researchers.

Input

• Demo mode is the safe default and emits one deterministic fixture.
• Live mode processes at most maxItems configured inputs.
• startUrls: user-provided or approved public URLs.

Output

The default dataset uses the Actor-specific schema in .actor/DATASET_SCHEMA.json. Key fields include listingName, shopName, listingId, price, currency, ratingValue, reviewCount, tags, changedFields, plus exact source, status, delta, confidence, warning, and fixture/live labels.

Data sources

Registered catalog sources: none. Live inputs are buyer-provided or explicitly approved public Etsy listing or shop URLs; those inputs are not represented as registered source IDs.

Demo run

Run examples/first-run.json. The row in examples/sample-output.json is labeled sourceStatus: fixture, isDemo: true, and is not live evidence.

Live-run behavior

Live mode processes only the configured Actor-specific inputs. Failures are returned as diagnostics or explicit errors; the runtime does not silently substitute unrelated source families.

Pricing

The runtime reads the effective Apify pay-per-event map after Actor.init() and writes each buyer-visible dataset record through the verified result-delivery event. It stops with an explicit configuration-drift error instead of emitting unmetered output. This package never defines or changes provider pricing.

Identity and visibility safety

This package targets only zentrafoundry/etsy-trend-shop-scout with Actor ID yTwCmmbC3CxOiu4uP. Any future release must find exactly one authenticated inventory match and abort on identity or visibility drift. Creating, cloning, upserting, duplicating, drafting, or privatizing the Actor is forbidden.

Limitations

• Output is limited to configured public URLs and does not claim platform-wide trend coverage.
• The Actor does not bypass login, CAPTCHA, rate limits, or other access controls.
• Local tests and fixtures do not prove an Apify build, live run, Store content update, or Store readback.

Responsible use

Use only data you are authorized to process. Respect source terms, robots policies, privacy rules, and applicable law. Never place credentials, cookies, tokens, or private account data in URLs or logs.

Support

When reporting a problem, include the run ID, sanitized input shape, expected result, and observed result. Do not include secrets or private data.