> ## 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.

# Mercari audit profile, Vortex IQ

> What the Vortex IQ Mercari health audit checks: Mercari Marketplace Audit

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

Will audit Mercari Pro Partner account health, listing quality and freshness, featured-offer position, order defect and feedback signals, and cross-channel parity for resale sellers.

## What this audit checks

### Authentication & access

* Partner refresh token present and exchangeable at /oauth/token (no expired-grant errors)
* Granted scopes cover seller\_read, listing\_read, order\_read
* /v1/seller/account returns a resolvable seller\_id matching the configured credential

### Account health & policy compliance

* Seller account status is ACTIVE (not RESTRICTED or SUSPENDED) on /v1/seller/account
* Seller rating at or above 4.7 and response\_rate within healthy band
* No open policy strikes or prohibited-item flags against the account

### Listing quality & suppression

* Suspended listings count is zero on /v1/listings (status=SUSPENDED)
* Brand attribute filled on at least 80% of active listings (search filter coverage)
* Condition grade set on every listing (NEW / LIKE\_NEW / GOOD / FAIR / POOR)
* Listings within the 7-day freshness boost window above the re-list threshold

### Buy Box / featured-offer

* Featured-offer (search-rank boost) win rate at or above target across active listings
* Smart Pricing floor not breached - no listings holding at smart\_pricing\_floor
* Average listing age under 14 days so freshness boost is not eroded

### Order defect & feedback

* Return rate under 8% over trailing 30 days on /v1/orders
* No grading-drift signal - returns on GOOD / LIKE\_NEW items with condition-mismatch reason
* Ships-within-3-days rate at or above 90% to hold the Fast Shipper badge
* No orders past ship\_deadline currently in PAID state

### Cross-channel inventory & pricing parity

* No ON\_SALE Mercari listing for an item sold or zero-stock on a BigCommerce / Depop / Vinted sibling
* Same item priced within 15% across Mercari and Depop / Vinted siblings (title\_hash match)
* Mercari order synced to BigCommerce / Shopify order within 24h (order\_ref match)

## Severity thresholds

| Signal                   | Warn | Critical |
| ------------------------ | ---- | -------- |
| `buy_box_win_rate`       | -    | \<40%    |
| `defect_rate`            | -    | >8%      |
| `feedback_score`         | -    | \<4.5    |
| `listing_suppressed_pct` | -    | >2%      |
| `account_health_score`   | -    | \<70     |

## Data sources

* `GET https://api.mercari.com/v1/seller/account` - Account status, seller rating, response rate, completed sales
* `GET https://api.mercari.com/v1/listings` - Listing inventory, condition, brand, price, smart-pricing, suspension status
* `GET https://api.mercari.com/v1/orders` - Orders, status, totals, ship deadlines for defect and fulfilment signals
* `POST https://api.mercari.com/oauth/token` - Partner refresh-token exchange for access token