> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vortexiq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Etsy audit profile, Vortex IQ

> What the Vortex IQ Etsy health audit checks: Etsy Shop & Listing Audit

**[Nerve Centre KPIs](/nerve-centre/kpi-cards/etsy) · [Audit Profile](/nerve-centre/kpi-cards/etsy/audit) · [Sentiment Settings](/nerve-centre/kpi-cards/etsy/sentiment)**

Will audit OAuth/access health, Star Seller policy compliance, listing findability and suppression, featured-offer eligibility, order-defect/feedback risk, and cross-channel inventory + pricing parity for an Etsy shop.

## What this audit checks

### Authentication & access

* OAuth2 access token (shop\_id.access\_token) valid and not expired (1h lifetime)
* Refresh token present and rotated on last use (Etsy invalidates on second use)
* x-api-key keystring set and accepted on /v3/application/shops/{shop_id}
* Required scopes granted: listings\_r, listings\_w, shops\_r, transactions\_r, email\_r

### Account health & policy compliance

* Star Seller status held (review\_average >= 4.8 over rolling 90d)
* On-time shipping rate >= 95% (Star Seller threshold) from receipts shipped vs estimated\_ship\_date
* Message response rate within 24h not breached more than once in 30d
* Shop not in is\_vacation mode while listings are active

### Listing quality & suppression

* Active listings not suspended for handmade-policy, prohibited-material, or trademark complaints
* Titles >= 70 chars with primary search terms (not brand-only repetition)
* All 13 tag slots used and category-required attributes complete
* Listings approaching 4-month expiry flagged for renew vs lapse decision

### Buy Box / featured-offer

* Listings eligible for Etsy search page-1 placement (no rank drop to page 3+ on high-velocity terms)
* Etsy Ads spend not cannibalising organic earnings (ROAS net of natural-organic counterfactual)
* Views to favourites conversion >= 2% (soft-signal of competitive offer)

### Order defect & feedback

* Cancellation rate \<= 3% across receipts in 30d
* Return rate \<= 5% across receipts in 30d
* Average review rating (ShopReview\.rating) >= 4.8 with no recent negative cluster
* No orders past estimated\_ship\_date risking on-time-ship KPI

### Cross-channel inventory & pricing parity

* Active Etsy listing not pointing to a SKU that is OOS on BigCommerce (cancellation risk)
* Etsy listing title/price not drifting from BC source-of-truth by > 5%
* Same item priced within 15% across Etsy vs eBay / Depop on title\_hash

## Severity thresholds

| Signal                   | Warn | Critical |
| ------------------------ | ---- | -------- |
| `buy_box_win_rate`       | -    | \< 0.40  |
| `defect_rate`            | -    | > 0.05   |
| `feedback_score`         | -    | \< 4.6   |
| `listing_suppressed_pct` | -    | > 0.10   |
| `account_health_score`   | -    | \< 60    |

## Data sources

* `POST https://api.etsy.com/v3/public/oauth/token` - OAuth token exchange + refresh-token rotation
* `GET https://api.etsy.com/v3/application/shops/{shop_id}` - Shop health, Star Seller status, review average + count
* `GET https://api.etsy.com/v3/application/shops/{shop_id}/listings/active` - Active listings: title/tag/attribute completeness, expiry, state, views
* `GET https://api.etsy.com/v3/application/shops/{shop_id}/receipts` - Orders: ship status, estimated\_ship\_date, cancellation/return signals
* `GET https://api.etsy.com/v3/application/shops/{shop_id}/reviews` - Per-transaction ratings for feedback-score and defect clustering