{"uid":"cap_RAZ49yjFQ-F12XSx_DcHo","slug":"friday-seller-tools-return-reason-analysis-f23e6e46","name":"Friday Seller Tools – Return Reason Analysis","description":"Instant, low-cost Amazon, Walmart, Shopify, and eBay listing, upload-preparation, advertising, and image-brief deliverables.","url":"https://friday-seller-tools-production.up.railway.app/v1/quality/return-reason-analysis","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sku":{"anyOf":[{"type":"string","pattern":"^[A-Za-z0-9._-]+$","maxLength":80,"minLength":1},{"type":"null"}],"title":"Sku","default":null},"returns":{"type":"array","items":{"type":"object","title":"ReturnReasonEntry","required":["reason_text"],"properties":{"units":{"type":"integer","title":"Units","default":1,"maximum":100000,"minimum":1},"reason_text":{"type":"string","title":"Reason Text","maxLength":300,"minLength":2},"buyer_comment":{"anyOf":[{"type":"string","maxLength":500,"minLength":1},{"type":"null"}],"title":"Buyer Comment","default":null}},"additionalProperties":false},"title":"Returns","maxItems":200,"minItems":1},"units_sold":{"anyOf":[{"type":"integer","maximum":10000000,"minimum":1},{"type":"null"}],"title":"Units Sold","default":null},"marketplace":{"enum":["amazon_us","walmart_us","shopify","ebay_us"],"type":"string","title":"Marketplace","default":"amazon_us"},"product_name":{"type":"string","title":"Product Name","maxLength":200,"minLength":2}}},"responseSchema":{"type":"json","example":{"job_id":"example","status":"queued"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_WLk-wyUH948ctcJcr_WTx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes marketplace return reasons to surface actionable insights for Amazon, Walmart, Shopify, and eBay sellers.","exampleAgentPrompt":"Can you analyze the return reasons for my Amazon product ASIN B08XYZ1234 and tell me what's driving customers to return it so I can figure out what to fix?","exampleUseCases":[{"title":"Diagnose high return rate on Amazon","prompt":"I'm seeing a spike in returns for my Amazon listing B09ABC5678 — can you analyze the return reasons and tell me what the main issues are so I know whether it's a product problem or a listing mismatch?"},{"title":"Reduce Shopify store returns","prompt":"Run a return reason analysis for my Shopify store's top-returned product SKU SHOE-RED-10 and give me insights on what's causing customers to send it back."},{"title":"Improve eBay listing accuracy","prompt":"Analyze the return reasons coming in for my eBay listing 123456789012 and let me know if customers are returning it because the description is inaccurate or because of quality issues."}],"resultDescription":"Returns a job_id and queued status immediately; once processed, delivers a structured breakdown of return reason categories, frequency analysis, root cause diagnosis, and actionable recommendations to reduce return rates for the specified marketplace product.","failureModes":["Missing or invalid ASIN/SKU results in a 400 error","Unsupported marketplace name causes validation failure","Insufficient return data for meaningful analysis","Payment not received causes 402 response before processing","Job processing timeout for large return datasets"],"whenToPreferThis":"Choose this endpoint when you need to systematically diagnose why customers are returning products on Amazon, Walmart, Shopify, or eBay — especially when trying to reduce return rates, improve listing accuracy, or identify product defects. It is purpose-built for e-commerce sellers needing structured return intelligence at low cost ($0.25/call), making it preferable to general-purpose analytics tools for marketplace-specific return workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:46:29.475Z","isFirstParty":false}