← All Friday Seller Tools

Pay once · No Friday subscription

Marketplace Return Reason Analyzer

Find out which return driver is actually costing you, and fix that one first.

Amazon USWalmart USShopifyeBay US

Included in the $9.00 Shelf Kit

Agent/API — $0.25
Review-first
Every output stays a draft.
No credentials
No seller-account login required.
Private delivery
Inputs expire after 24 hours.
Clear recourse
Digital-service refund policy.

What you receive

  • Root-cause buckets ranked by returned units and share
  • Up to three example reason lines per bucket
  • Listing, packaging, and supplier actions per bucket
  • Concentrated-driver and elevated-return-rate findings
  • Unclassified reason lines listed for human reading

Who it is for

Sellers, agencies, and agents deciding which return driver to fix first from an exported returns report.

Delivery: usually a structured result, workbook, or ZIP depending on the tool.

How it stays safe

Friday treats reason lines and buyer comments as untrusted data and creates only an analysis draft. Buckets come from fixed keyword patterns, not from reading buyer intent, so a short or ambiguous line can land in the wrong bucket — read the unclassified list yourself. It reads no returns report, accesses no seller account, does not publish listings, and creates or changes no refund, case, or listing.

Synthetic sample

See the deliverable structure before buying

{
  "publish_status": "draft_needs_review",
  "total_return_units": 60,
  "return_rate_percent": 5.0,
  "top_category": "damaged_in_transit",
  "categories": [
    {
      "category": "damaged_in_transit",
      "label": "Damaged in transit",
      "units": 31,
      "share_percent": 51.67,
      "example_reasons": [
        "Arrived damaged, lid cracked"
      ],
      "recommended_actions": [
        "Review protective packaging and drop-test the current pack-out.",
        "Compare damage rates by carrier and by ship-from location before changing packaging."
      ]
    },
    {
      "category": "sizing_fit",
      "label": "Size or fit mismatch",
      "units": 18,
      "share_percent": 30.0,
      "example_reasons": [
        "Wrong size for my cup holder"
      ],
      "recommended_actions": [
        "Publish measured dimensions per size, not just a size label."
      ]
    }
  ],
  "finding_preview": [
    {
      "severity": "error",
      "code": "concentrated_return_driver",
      "message": "Damaged in transit accounts for 51.67% of the supplied returned units; work this bucket before the smaller ones."
    }
  ],
  "unclassified_reasons": [
    "Buyer did not state a reason"
  ],
  "safety": "Analysis draft only; buckets come from fixed keyword patterns, not judgement. It reads no returns report, accesses no account, and creates or changes no refund, case, or listing."
}

This sample uses synthetic facts. Your output is generated only from the facts you submit.

Agent API and x402 details

POST /v1/quality/return-reason-analysis

Exact x402 price: $0.25. Use the public OpenAPI schema and Base USDC payment flow. The response returns a private job URL and temporary token.

Open the API documentation →

Related seller tools