{"openapi":"3.1.0","info":{"title":"Friday Seller Tools","description":"Paid, agent-ready marketplace listing and advertising deliverables.","contact":{"email":"orders@breathenaturally.com"},"version":"0.3.0","x-guidance":"Choose one Friday Seller Tools POST operation, submit its documented JSON body, complete the returned x402 payment requirement, then poll the returned job URL using its temporary X-Job-Token until the deliverable is ready.","x-checkout":{"guidedHumanUrl":"https://friday-seller-tools-production.up.railway.app/buy","ponchoMerchantUrl":"https://tryponcho.com/m/friday-seller-tools-production.up.railway.app","paymentProtocol":"x402","network":"eip155:8453","stripeBundlePathTemplate":"https://friday-seller-tools-production.up.railway.app/v1/stripe/bundles/{bundle_id}","stripeBundlePrices":{"listing_rescue":"$3.00","shelf_kit":"$9.00","listing_launch":"$29.00"}}},"paths":{"/v1/stripe/checkout/{service}":{"post":{"summary":"Stripe Checkout","operationId":"stripe_checkout_v1_stripe_checkout__service__post","parameters":[{"name":"service","in":"path","required":true,"schema":{"type":"string","title":"Service"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"Backward-compatible standalone card checkout for services at or above Stripe's minimum. New human purchases use the fee-aware bundles in /skills.json; individual x402 prices are unchanged.","requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/MarketplaceTitleOptimizerRequest"},{"$ref":"#/components/schemas/ListingTitleVariantsRequest"},{"$ref":"#/components/schemas/BulletRewriteRequest"},{"$ref":"#/components/schemas/ProductDescriptionHtmlRequest"},{"$ref":"#/components/schemas/CategoryNodeSuggestionRequest"},{"$ref":"#/components/schemas/MarketplaceClaimCheckRequest"},{"$ref":"#/components/schemas/CatalogReadinessRequest"},{"$ref":"#/components/schemas/ListingAuditRequest"},{"$ref":"#/components/schemas/ListingBuildRequest"},{"$ref":"#/components/schemas/PPCKitRequest"},{"$ref":"#/components/schemas/OmnichannelLaunchRequest"},{"$ref":"#/components/schemas/MarketplaceAdsKitRequest"},{"$ref":"#/components/schemas/MarketplaceImageBriefRequest"},{"$ref":"#/components/schemas/ReviewResponseRequest"},{"$ref":"#/components/schemas/APlusContentBriefRequest"},{"$ref":"#/components/schemas/KeywordGapRequest"},{"$ref":"#/components/schemas/AmazonBackendSearchTermsRequest"},{"$ref":"#/components/schemas/ImageAltTextPackRequest"},{"$ref":"#/components/schemas/PricingWhatIfRequest"},{"$ref":"#/components/schemas/PromotionProfitRequest"},{"$ref":"#/components/schemas/ComplianceScanRequest"},{"$ref":"#/components/schemas/BulkCSVAuditRequest"},{"$ref":"#/components/schemas/BrandNameScreenRequest"},{"$ref":"#/components/schemas/HolidayCopyRefreshRequest"},{"$ref":"#/components/schemas/CompetitorChangeMonitorRequest"},{"$ref":"#/components/schemas/EmailFlowPackRequest"},{"$ref":"#/components/schemas/WalmartRichMediaBriefRequest"},{"$ref":"#/components/schemas/EbayItemSpecificsRequest"},{"$ref":"#/components/schemas/VariationFamilyPlanRequest"},{"$ref":"#/components/schemas/ReturnReasonAnalysisRequest"},{"$ref":"#/components/schemas/RestockPlanRequest"},{"$ref":"#/components/schemas/ListingAppealRequest"},{"$ref":"#/components/schemas/CompetitorResearchRequest"}]}}}}}},"/v1/stripe/bundles/{bundle_id}":{"post":{"summary":"Stripe Bundle Checkout","operationId":"stripe_bundle_checkout_v1_stripe_bundles__bundle_id__post","parameters":[{"name":"bundle_id","in":"path","required":true,"schema":{"type":"string","title":"Bundle Id"}}],"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"Create a hosted Stripe Checkout session for Listing Rescue ($3), a selected Shelf Kit ($9), or Listing Launch ($29). Payment grants fixed, service-specific entitlements only; it does not create a transferable wallet."}},"/v1/stripe/bundles/{bundle_id}/redeem/{service}":{"post":{"summary":"Stripe Bundle Redeem","operationId":"stripe_bundle_redeem_v1_stripe_bundles__bundle_id__redeem__service__post","parameters":[{"name":"bundle_id","in":"path","required":true,"schema":{"type":"string","title":"Bundle Id"}},{"name":"service","in":"path","required":true,"schema":{"type":"string","title":"Service"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"description":"Redeem one paid, service-specific bundle entitlement. Supply the private redemption_token plus the selected service's documented request body."}},"/v1/listing/audit":{"post":{"summary":"Listing Audit","operationId":"listing_audit_v1_listing_audit_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListingAuditRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/listing_audit","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/marketplace-listing-audit"}},"/v1/listing/title-optimizer":{"post":{"summary":"Title Optimizer","operationId":"title_optimizer_v1_listing_title_optimizer_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketplaceTitleOptimizerRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/title_optimizer","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/marketplace-title-optimizer"}},"/v1/listings/title-variants":{"post":{"summary":"Create three fact-grounded marketplace title variants","description":"Create exactly three distinct, fact-grounded marketplace title drafts using fixed keyword-first, benefit-first, and compact strategies. Every title stays within the selected channel's conservative limit and includes keyword coverage plus rationale. The tool predicts no experiment, ranking, conversion, traffic, or sales outcome and does not edit or publish listings.","operationId":"listing_title_variants_v1_listings_title_variants_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListingTitleVariantsRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/listing_title_variants","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/marketplace-listing-title-variant-generator"}},"/v1/listings/bullet-rewrite":{"post":{"summary":"Rewrite listing bullets for readability and report keyword coverage","description":"Normalize supplied Amazon US, Walmart US, Shopify, or eBay US bullet points for readability — whitespace, leading capitalization, repeated-punctuation cleanup, and sentence-casing of shouted words — while removing promotional and unverified sensitive phrases. Returns each rewritten bullet with a readability score, applied-edit flags, and focus-keyword coverage. It adds no new facts, inserts no keywords, and does not edit or publish listings.","operationId":"bullet_rewriter_v1_listings_bullet_rewrite_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulletRewriteRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/bullet_rewriter","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/marketplace-bullet-point-rewriter"}},"/v1/listings/description-html":{"post":{"summary":"Format a marketplace product description with conservative HTML","description":"Strip supplied markup and rebuild product-description copy as a conservative, attribute-free fragment for Amazon US, Walmart US, Shopify, or eBay US. Returns the formatted HTML, plain-text fallback, exact allowlist, sanitization counts, and UTF-8 size. It adds no facts, links, media, styles, tracking, or executable content and is a draft—not a marketplace-policy or category compliance guarantee.","operationId":"product_description_html_v1_listings_description_html_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductDescriptionHtmlRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/product_description_html","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/product-description-html-formatter"}},"/v1/catalog/category-node-suggestions":{"post":{"summary":"Rank marketplace category or node candidates from product facts","description":"Rank two to fifty seller-supplied current marketplace category or node candidates against verified product facts. Returns transparent text-match scores, matched terms, evidence fields, unmatched candidate terms, search phrases, and ambiguity warnings. It does not fetch or verify taxonomy data, access an account, change a listing, or establish category eligibility, browse placement, fees, approval, or compliance.","operationId":"category_node_suggester_v1_catalog_category_node_suggestions_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CategoryNodeSuggestionRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/category_node_suggester","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/marketplace-category-node-suggester"}},"/v1/listing/claim-check":{"post":{"summary":"Screen marketplace claims","description":"Return severity-coded findings for unsupported sensitive claims, promotional language, and seller-specified forbidden claims in supplied marketplace copy. Each finding includes a reason and review action; this is a deterministic screen, not a policy or legal compliance guarantee.","operationId":"claim_check_v1_listing_claim_check_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketplaceClaimCheckRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/claim_check","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/marketplace-claim-check"}},"/v1/catalog/readiness-check":{"post":{"summary":"Check four-marketplace catalog readiness","description":"Return channel-by-channel readiness status, missing product or seller fields, and the next preparation step for Amazon US, Walmart US, Shopify, and eBay US. No seller account is accessed and no listing is uploaded.","operationId":"catalog_readiness_v1_catalog_readiness_check_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogReadinessRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/catalog_readiness","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/four-marketplace-catalog-readiness-check"}},"/v1/listing/build":{"post":{"summary":"Listing Build","operationId":"listing_build_v1_listing_build_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListingBuildRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/listing_build","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/marketplace-listing-builder"}},"/v1/amazon-ppc/launch-kit":{"post":{"summary":"Build a paused Amazon PPC launch kit","description":"Create a paused Amazon Sponsored Products draft with ACoS-based bid math, AUTO and MANUAL target rows, budget allocation, review warnings, and a downloadable XLSX workbook. Nothing is activated and no advertising spend occurs.","operationId":"ppc_kit_v1_amazon_ppc_launch_kit_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PPCKitRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.50"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/ppc_kit","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/amazon-ppc-launch-kit"}},"/v1/omnichannel/launch-pack":{"post":{"summary":"Omnichannel Pack","operationId":"omnichannel_pack_v1_omnichannel_launch_pack_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OmnichannelLaunchRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.00"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/omnichannel_pack","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/omnichannel-product-launch-pack"}},"/v1/marketplace-ads/launch-kit":{"post":{"summary":"Marketplace Ads Kit","operationId":"marketplace_ads_kit_v1_marketplace_ads_launch_kit_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketplaceAdsKitRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.50"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/marketplace_ads_kit","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/marketplace-ads-launch-kit"}},"/v1/marketplace-images/brief":{"post":{"summary":"Marketplace Image Brief","operationId":"marketplace_image_brief_v1_marketplace_images_brief_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketplaceImageBriefRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.50"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/marketplace_image_brief","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/marketplace-product-image-brief"}},"/v1/reviews/response-draft":{"post":{"summary":"Draft a marketplace review response","description":"Create a concise, draft-only response to a supplied marketplace review without echoing customer instructions, inventing order facts, promising remedies, or accessing a seller account. Returns concern categories, recommended internal actions, and an explicit specialist-review flag for safety, authenticity, or fraud allegations.","operationId":"review_response_v1_reviews_response_draft_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewResponseRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/review_response","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/marketplace-review-response-writer"}},"/v1/amazon-a-plus/content-brief":{"post":{"summary":"Build an Amazon A+ content brief","description":"Create a deterministic Amazon A+ content planning brief from seller-supplied product facts. Returns three to five module briefs with grounded draft copy, image direction, alt text, factual basis, asset gaps, and claim-review steps. It does not access a seller account or claim Amazon eligibility, policy compliance, or acceptance.","operationId":"a_plus_content_brief_v1_amazon_a_plus_content_brief_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APlusContentBriefRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.50"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/a_plus_content_brief","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/amazon-a-plus-content-brief"}},"/v1/listings/keyword-gap":{"post":{"summary":"Map keyword gaps against supplied competitor listings","description":"Compare one seller listing against up to three customer-supplied competitor listings and return a deterministic keyword gap map. Returns missing words and phrases with competitor usage counts, the fields they appear in, priority, and placement guidance, plus shared terms and coverage. It fetches nothing, uses no search-volume data, and predicts no ranking outcome.","operationId":"keyword_gap_v1_listings_keyword_gap_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeywordGapRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/keyword_gap","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/marketplace-keyword-gap-analyzer"}},"/v1/amazon/listings/backend-search-terms":{"post":{"summary":"Optimize Amazon backend search terms within 250 bytes","description":"Pack seller-ranked candidate keywords into one normalized Amazon US backend search-term string that never exceeds 250 UTF-8 bytes. The deterministic result deduplicates words against supplied visible copy, removes seller exclusions and fixed risky terms, reports every omission, and uses no search-volume or ranking data. It does not access Seller Central, edit a listing, or claim policy compliance.","operationId":"amazon_backend_search_terms_v1_amazon_listings_backend_search_terms_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AmazonBackendSearchTermsRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/amazon_backend_search_terms","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/amazon-backend-search-term-optimizer"}},"/v1/marketplace-images/alt-text-pack":{"post":{"summary":"Build marketplace gallery alt text and SEO captions","description":"Create deterministic alt text, SEO captions, and filenames for up to 12 marketplace gallery images from seller-confirmed visual descriptions and product facts. Returns length-bounded drafts, grounded and omitted keyword lists, factual basis, and review checks. It does not inspect image files, upload metadata, publish content, guarantee accessibility compliance, or predict search ranking.","operationId":"image_alt_text_pack_v1_marketplace_images_alt_text_pack_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageAltTextPackRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/image_alt_text_pack","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/marketplace-image-alt-text-seo-caption-pack"}},"/v1/pricing/break-even-what-if":{"post":{"summary":"Compare candidate prices against your current unit economics","description":"Compare up to eight candidate prices against your current price using unit economics you supply. Returns contribution margin per unit, monthly contribution at today's volume, and the break-even unit count and percentage volume change each price would need to leave profit unchanged. It is arithmetic on your own numbers: it fetches no fee schedules or competitor prices, forecasts no demand, changes no price, and recommends nothing you have not asked it to compare.","operationId":"pricing_what_if_v1_pricing_break_even_what_if_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PricingWhatIfRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/pricing_what_if","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/marketplace-price-change-break-even-analyzer"}},"/v1/pricing/promotion-profit-guard":{"post":{"summary":"Check promotion scenarios against supplied unit economics","description":"Compare up to eight seller-supplied percentage-discount scenarios using the list price, unit cost, referral rate, fulfillment cost, per-redemption fee, fixed promotion fee, and expected units you supply. Returns sale price, contribution per unit, net contribution, change versus no promotion, and the units needed to cover the fixed fee. It fetches no fee schedule, predicts no demand, changes no price, activates no promotion, and provides arithmetic rather than financial advice.","operationId":"promotion_profit_guard_v1_pricing_promotion_profit_guard_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromotionProfitRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/promotion_profit_guard","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/marketplace-promotion-profit-guard"}},"/v1/listings/compliance-scan":{"post":{"summary":"Scan listing copy for restricted-claim and policy-risk phrasing","description":"Scan a supplied title, bullets, and description against a fixed list of restricted-claim phrase rules and return each match with its field, policy category, severity, why it is risky, and a safer rewrite, plus a 0-100 risk score. Promotional and urgency phrasing is escalated when found in the title. It reads no policy document, seller account, or live listing, changes nothing, and a clean scan is not a compliance approval.","operationId":"compliance_scan_v1_listings_compliance_scan_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComplianceScanRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/compliance_scan","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/marketplace-listing-compliance-scanner"}},"/v1/listings/bulk-csv-audit":{"post":{"summary":"Audit up to 100 marketplace listing rows from CSV","description":"Audit up to 100 rows of seller-supplied listing CSV data for required identifiers, duplicate SKUs, conservative channel field limits, spreadsheet-formula triggers, and fixed restricted-phrase rules. Returns row-level findings, scores, and review status. The CSV is treated only as untrusted data; no account, template, policy document, or live listing is accessed, nothing is uploaded, and a clear row is not an approval.","operationId":"bulk_csv_audit_v1_listings_bulk_csv_audit_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkCSVAuditRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.00"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/bulk_csv_audit","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/bulk-csv-marketplace-listing-audit"}},"/v1/brands/name-screen":{"post":{"summary":"Screen candidate brand names against supplied collision and wording risks","description":"Screen up to 20 candidate brand names against up to 100 customer-supplied known names, seller-forbidden terms, category-only wording, marketplace names, claim-like authority wording, and weak formats. Returns exact and textual-similarity findings with next review steps. It searches no trademark registry, marketplace, domain, web page, seller account, or customer database and provides no availability claim or legal clearance.","operationId":"brand_name_screen_v1_brands_name_screen_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandNameScreenRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/brand_name_screen","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/brand-name-risk-screener"}},"/v1/listings/holiday-copy-refresh":{"post":{"summary":"Build a reversible seasonal listing-copy and campaign-caption draft","description":"Create a reversible seasonal listing-copy and campaign-caption draft from current copy, seller-supplied seasonal context, an optional verified offer, and a campaign end date. Returns unchanged-title strategy, refreshed bullets and description, fixed-rule risk findings, exact rollback copy, and a removal checklist. It accesses no account, live listing, offer schedule, campaign, or policy document and publishes or activates nothing.","operationId":"holiday_copy_refresh_v1_listings_holiday_copy_refresh_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HolidayCopyRefreshRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/holiday_copy_refresh","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/holiday-marketplace-copy-refresher"}},"/v1/competitors/change-monitor-spec":{"post":{"summary":"Compare supplied competitor snapshots and build a monitoring specification","description":"Compare two seller-supplied snapshots of one competitor listing and return a factual field-change report plus a daily, weekly, or monthly monitoring specification. Text summaries report only normalized character or bullet-position changes rather than reproducing competitor copy. It fetches and monitors nothing, verifies no observation, infers no cause or trend, sends no alert, and changes no listing, price, or account.","operationId":"competitor_change_monitor_v1_competitors_change_monitor_spec_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompetitorChangeMonitorRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/competitor_change_monitor","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/competitor-listing-change-monitor-spec"}},"/v1/marketing/email-flow-draft":{"post":{"summary":"Build a three-message draft flow for an owned opt-in audience","description":"Create a three-message email sequence draft from seller-supplied product facts for an audience the seller confirms is an owned opt-in list. Returns subject lines, previews, plain-text bodies, factual basis, send-offset planning, review checks, and suppression requirements. It accepts no recipient or order data, accesses no account, schedules or sends nothing, and does not claim consent, legal compliance, or campaign performance.","operationId":"email_flow_pack_v1_marketing_email_flow_draft_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailFlowPackRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.00"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/email_flow_pack","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/opt-in-customer-email-flow-pack"}},"/v1/walmart/rich-media-brief":{"post":{"summary":"Build a fact-grounded Walmart rich-media planning brief","description":"Create a three-to-five-block Walmart rich-media planning brief from supplied product facts and asset inventory. Returns grounded draft copy, image direction, alt text, factual basis, asset gaps, and review checks. It accesses no account, uploads and publishes nothing, and does not claim Walmart eligibility, current component availability, policy compliance, or acceptance.","operationId":"walmart_rich_media_brief_v1_walmart_rich_media_brief_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalmartRichMediaBriefRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.50"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/walmart_rich_media_brief","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/walmart-rich-media-content-brief"}},"/v1/ebay/item-specifics":{"post":{"summary":"Score eBay item-specifics coverage and suggest grounded values","description":"Score an eBay listing's item-specifics coverage against the required and recommended aspect names the seller supplies for their category, suggest grounded values from supplied product facts where an aspect clearly maps, and flag every required aspect that still needs a seller-confirmed value. It reads no eBay category taxonomy, accesses no account, lists nothing, and does not claim eBay search-ranking outcomes.","operationId":"ebay_item_specifics_v1_ebay_item_specifics_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EbayItemSpecificsRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/ebay_item_specifics","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/ebay-item-specifics-optimizer"}},"/v1/catalog/variation-family-plan":{"post":{"summary":"Review a marketplace variation family before catalog entry","description":"Review two to fifty seller-supplied SKUs against a one-to-three-attribute variation theme. Returns dimension values, proposed child labels, missing theme fields, duplicate combinations, unplanned attributes, and a review queue. It reads no marketplace taxonomy or policy, accesses no account, changes no catalog data, and does not claim that a variation relationship is eligible or compliant.","operationId":"variation_family_plan_v1_catalog_variation_family_plan_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VariationFamilyPlanRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/variation_family_plan","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/marketplace-variation-family-planner"}},"/v1/inventory/restock-plan":{"post":{"summary":"Rank supplied SKUs by stockout risk and suggest reorder quantities","description":"Rank up to one hundred supplied SKUs by stockout risk and return a reorder point, a days-of-cover figure, an order-within window, and a suggested order quantity raised to the minimum order quantity and case pack you supply. The reorder point is demand-only and carries no safety stock. It reads no inventory report, accesses no seller account, and creates or changes no purchase order, shipment, or listing.","operationId":"restock_plan_v1_inventory_restock_plan_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RestockPlanRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/restock_plan","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/inventory-restock-stockout-risk-planner"}},"/v1/quality/return-reason-analysis":{"post":{"summary":"Cluster supplied return reasons into ranked root-cause buckets","description":"Cluster up to two hundred seller-supplied return-reason lines into fixed root-cause buckets, rank them by returned units and share, and return prioritised listing, packaging, and supplier actions per bucket plus every line that matched no pattern. Buckets come from fixed keyword patterns, not judgement. It reads no returns report, accesses no seller account, and creates or changes no refund, case, or listing.","operationId":"return_reason_analysis_v1_quality_return_reason_analysis_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReturnReasonAnalysisRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/return_reason_analysis","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/marketplace-return-reason-analyzer"}},"/v1/listings/appeal-draft":{"post":{"summary":"Draft a suppressed-listing appeal or plan of action","description":"Draft a bounded suppressed-listing appeal or plan of action from a supplied marketplace notice and the corrective steps the seller confirms they completed. Returns a root-cause summary, appeal draft, corrective and preventive actions, an evidence checklist, and blocking gaps. It states no fix the seller did not report, submits nothing, gives no legal advice, and predicts no reinstatement outcome.","operationId":"listing_appeal_v1_listings_appeal_draft_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListingAppealRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.50"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/listing_appeal","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/suppressed-listing-appeal-draft"}},"/v1/competitors/research":{"post":{"summary":"Competitor Research","operationId":"competitor_research_v1_competitors_research_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompetitorResearchRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{}}]},"x-sample-url":"https://friday-seller-tools-production.up.railway.app/v1/examples/competitor_research","x-product-url":"https://friday-seller-tools-production.up.railway.app/tools/competitor-product-listing-extractor"}}},"components":{"schemas":{"APlusContentBriefRequest":{"properties":{"product":{"$ref":"#/components/schemas/ProductFacts"},"objective":{"type":"string","enum":["new_launch","refresh","conversion_improvement"],"title":"Objective","default":"new_launch"},"module_count":{"type":"integer","maximum":5.0,"minimum":3.0,"title":"Module Count","default":5},"brand_tone":{"type":"string","enum":["clear","warm","premium","technical"],"title":"Brand Tone","default":"clear"},"available_assets":{"items":{"type":"string","maxLength":500,"minLength":1},"type":"array","maxItems":30,"title":"Available Assets"},"avoid":{"items":{"type":"string","maxLength":500,"minLength":1},"type":"array","maxItems":30,"title":"Avoid"}},"additionalProperties":false,"type":"object","required":["product"],"title":"APlusContentBriefRequest"},"AmazonBackendSearchTermsRequest":{"properties":{"product":{"$ref":"#/components/schemas/ProductFacts"},"candidate_terms":{"items":{"$ref":"#/components/schemas/BackendSearchTermCandidate"},"type":"array","maxItems":100,"minItems":1,"title":"Candidate Terms"},"visible_copy":{"items":{"type":"string","maxLength":2000,"minLength":1},"type":"array","maxItems":20,"title":"Visible Copy"},"excluded_terms":{"items":{"type":"string","maxLength":100,"minLength":1},"type":"array","maxItems":50,"title":"Excluded Terms"},"byte_budget":{"type":"integer","const":250,"title":"Byte Budget","default":250}},"additionalProperties":false,"type":"object","required":["product","candidate_terms"],"title":"AmazonBackendSearchTermsRequest"},"BackendSearchTermCandidate":{"properties":{"term":{"type":"string","maxLength":500,"minLength":1,"title":"Term"},"relevance":{"type":"integer","maximum":5.0,"minimum":1.0,"title":"Relevance"}},"additionalProperties":false,"type":"object","required":["term","relevance"],"title":"BackendSearchTermCandidate"},"BrandNameScreenRequest":{"properties":{"marketplace":{"$ref":"#/components/schemas/Marketplace","default":"amazon_us"},"product_category":{"type":"string","maxLength":150,"minLength":2,"title":"Product Category"},"candidate_names":{"items":{"type":"string","maxLength":80,"minLength":2},"type":"array","maxItems":20,"minItems":1,"title":"Candidate Names"},"known_names":{"items":{"type":"string","maxLength":80,"minLength":2},"type":"array","maxItems":100,"title":"Known Names"},"forbidden_terms":{"items":{"type":"string","maxLength":80,"minLength":1},"type":"array","maxItems":50,"title":"Forbidden Terms"}},"additionalProperties":false,"type":"object","required":["product_category","candidate_names"],"title":"BrandNameScreenRequest"},"BridgeFailureRequest":{"properties":{"worker_id":{"type":"string","maxLength":80,"minLength":3,"pattern":"^[A-Za-z0-9._-]+$","title":"Worker Id"},"code":{"type":"string","maxLength":80,"minLength":2,"pattern":"^[a-z0-9_]+$","title":"Code"},"message":{"type":"string","maxLength":500,"minLength":1,"title":"Message"},"retryable":{"type":"boolean","title":"Retryable","default":true}},"additionalProperties":false,"type":"object","required":["worker_id","code","message"],"title":"BridgeFailureRequest"},"BridgeHeartbeatRequest":{"properties":{"worker_id":{"type":"string","maxLength":80,"minLength":3,"pattern":"^[A-Za-z0-9._-]+$","title":"Worker Id"}},"additionalProperties":false,"type":"object","required":["worker_id"],"title":"BridgeHeartbeatRequest"},"BridgeLeaseRequest":{"properties":{"worker_id":{"type":"string","maxLength":80,"minLength":3,"pattern":"^[A-Za-z0-9._-]+$","title":"Worker Id"}},"additionalProperties":false,"type":"object","required":["worker_id"],"title":"BridgeLeaseRequest"},"BulkCSVAuditRequest":{"properties":{"marketplace":{"$ref":"#/components/schemas/Marketplace","default":"amazon_us"},"csv_text":{"type":"string","maxLength":200000,"minLength":1,"title":"Csv Text"}},"additionalProperties":false,"type":"object","required":["csv_text"],"title":"BulkCSVAuditRequest","description":"A bounded listing CSV supplied as data, never as instructions."},"BulletRewriteRequest":{"properties":{"product":{"$ref":"#/components/schemas/ProductFacts"},"bullets":{"items":{"type":"string","maxLength":1000,"minLength":2},"type":"array","maxItems":10,"minItems":1,"title":"Bullets"},"focus_keywords":{"items":{"type":"string","maxLength":100,"minLength":1},"type":"array","maxItems":20,"title":"Focus Keywords"}},"additionalProperties":false,"type":"object","required":["product","bullets"],"title":"BulletRewriteRequest"},"CatalogReadinessRequest":{"properties":{"product":{"$ref":"#/components/schemas/ProductFacts"},"sku":{"type":"string","maxLength":80,"minLength":1,"pattern":"^[A-Za-z0-9._-]+$","title":"Sku"},"quantity":{"type":"integer","maximum":10000000.0,"minimum":0.0,"title":"Quantity","default":0},"gtin":{"anyOf":[{"type":"string","pattern":"^[0-9]{8,14}$"},{"type":"null"}],"title":"Gtin"},"image_urls":{"items":{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},"type":"array","maxItems":250,"title":"Image Urls"},"country_of_origin":{"anyOf":[{"type":"string","pattern":"^[A-Z]{2}$"},{"type":"null"}],"title":"Country Of Origin"},"walmart_product_type":{"anyOf":[{"type":"string","maxLength":150},{"type":"null"}],"title":"Walmart Product Type"},"shopify_product_category":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Shopify Product Category"},"ebay_category_id":{"anyOf":[{"type":"string","pattern":"^[0-9]+$"},{"type":"null"}],"title":"Ebay Category Id"},"ebay_merchant_location_key":{"anyOf":[{"type":"string","maxLength":36},{"type":"null"}],"title":"Ebay Merchant Location Key"},"ebay_payment_policy_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Ebay Payment Policy Id"},"ebay_return_policy_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Ebay Return Policy Id"},"ebay_fulfillment_policy_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Ebay Fulfillment Policy Id"}},"additionalProperties":false,"type":"object","required":["product","sku"],"title":"CatalogReadinessRequest"},"CategoryNodeCandidate":{"properties":{"node_id":{"type":"string","maxLength":80,"minLength":1,"pattern":"^[A-Za-z0-9._:/-]+$","title":"Node Id"},"label":{"type":"string","maxLength":150,"minLength":2,"title":"Label"},"path":{"type":"string","maxLength":500,"minLength":2,"title":"Path"},"keywords":{"items":{"type":"string","maxLength":100,"minLength":1},"type":"array","maxItems":30,"title":"Keywords"}},"additionalProperties":false,"type":"object","required":["node_id","label","path"],"title":"CategoryNodeCandidate"},"CategoryNodeSuggestionRequest":{"properties":{"product":{"$ref":"#/components/schemas/ProductFacts"},"candidate_nodes":{"items":{"$ref":"#/components/schemas/CategoryNodeCandidate"},"type":"array","maxItems":50,"minItems":2,"title":"Candidate Nodes"},"max_suggestions":{"type":"integer","maximum":5.0,"minimum":1.0,"title":"Max Suggestions","default":2}},"additionalProperties":false,"type":"object","required":["product","candidate_nodes"],"title":"CategoryNodeSuggestionRequest"},"CompetitorChangeMonitorRequest":{"properties":{"marketplace":{"$ref":"#/components/schemas/Marketplace","default":"amazon_us"},"competitor_label":{"type":"string","maxLength":100,"minLength":2,"title":"Competitor Label"},"listing_identifier":{"type":"string","maxLength":120,"minLength":1,"pattern":"^[A-Za-z0-9._:/-]+$","title":"Listing Identifier"},"before":{"$ref":"#/components/schemas/CompetitorListingSnapshot"},"after":{"$ref":"#/components/schemas/CompetitorListingSnapshot"},"cadence":{"type":"string","enum":["daily","weekly","monthly"],"title":"Cadence","default":"weekly"},"watch_fields":{"items":{"type":"string","enum":["title","price_usd","bullets","description","availability","rating","review_count"]},"type":"array","maxItems":7,"minItems":1,"title":"Watch Fields"}},"additionalProperties":false,"type":"object","required":["competitor_label","listing_identifier","before","after"],"title":"CompetitorChangeMonitorRequest","description":"Two seller-supplied snapshots for a deterministic change report and monitor spec."},"CompetitorListingSnapshot":{"properties":{"captured_at":{"type":"string","format":"date","title":"Captured At"},"title":{"anyOf":[{"type":"string","maxLength":500,"minLength":5},{"type":"null"}],"title":"Title"},"price_usd":{"anyOf":[{"type":"number","maximum":1000000.0,"exclusiveMinimum":0.0},{"type":"null"}],"title":"Price Usd"},"bullets":{"items":{"type":"string","maxLength":1000,"minLength":2},"type":"array","maxItems":10,"title":"Bullets"},"description":{"anyOf":[{"type":"string","maxLength":5000,"minLength":10},{"type":"null"}],"title":"Description"},"availability":{"anyOf":[{"type":"string","enum":["in_stock","out_of_stock","limited","unknown"]},{"type":"null"}],"title":"Availability"},"rating":{"anyOf":[{"type":"number","maximum":5.0,"minimum":0.0},{"type":"null"}],"title":"Rating"},"review_count":{"anyOf":[{"type":"integer","maximum":1000000000.0,"minimum":0.0},{"type":"null"}],"title":"Review Count"}},"additionalProperties":false,"type":"object","required":["captured_at"],"title":"CompetitorListingSnapshot"},"CompetitorMarketplace":{"type":"string","enum":["amazon_us","walmart_us","ebay_us","website"],"title":"CompetitorMarketplace"},"CompetitorResearchMode":{"type":"string","enum":["product_extract"],"title":"CompetitorResearchMode"},"CompetitorResearchRequest":{"properties":{"mode":{"$ref":"#/components/schemas/CompetitorResearchMode"},"product_url":{"type":"string","maxLength":2048,"minLength":1,"format":"uri","title":"Product Url"},"marketplace":{"anyOf":[{"$ref":"#/components/schemas/CompetitorMarketplace"},{"type":"null"}]},"max_results":{"type":"integer","maximum":1.0,"minimum":1.0,"title":"Max Results","default":1}},"additionalProperties":false,"type":"object","required":["mode","product_url"],"title":"CompetitorResearchRequest","description":"Customer-safe contract leased to the outbound Mac worker."},"ComplianceScanRequest":{"properties":{"marketplace":{"$ref":"#/components/schemas/Marketplace","default":"amazon_us"},"product_name":{"type":"string","maxLength":200,"minLength":1,"title":"Product Name"},"title":{"type":"string","maxLength":500,"minLength":1,"title":"Title"},"bullets":{"items":{"type":"string","maxLength":1000,"minLength":1},"type":"array","maxItems":10,"title":"Bullets"},"description":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}],"title":"Description"}},"additionalProperties":false,"type":"object","required":["product_name","title"],"title":"ComplianceScanRequest","description":"Seller-supplied listing copy to scan for restricted-claim phrasing."},"EbayItemSpecific":{"properties":{"name":{"type":"string","maxLength":80,"minLength":1,"title":"Name"},"value":{"type":"string","maxLength":200,"minLength":1,"title":"Value"}},"additionalProperties":false,"type":"object","required":["name","value"],"title":"EbayItemSpecific"},"EbayItemSpecificsRequest":{"properties":{"product":{"$ref":"#/components/schemas/ProductFacts"},"required_aspects":{"items":{"type":"string","maxLength":80,"minLength":1},"type":"array","maxItems":40,"minItems":1,"title":"Required Aspects"},"recommended_aspects":{"items":{"type":"string","maxLength":80,"minLength":1},"type":"array","maxItems":60,"title":"Recommended Aspects"},"current_specifics":{"items":{"$ref":"#/components/schemas/EbayItemSpecific"},"type":"array","maxItems":60,"title":"Current Specifics"}},"additionalProperties":false,"type":"object","required":["product","required_aspects"],"title":"EbayItemSpecificsRequest"},"EmailFlowPackRequest":{"properties":{"product":{"$ref":"#/components/schemas/ProductFacts"},"campaign_goal":{"type":"string","enum":["product_education","product_launch","customer_reengagement"],"title":"Campaign Goal"},"audience_basis":{"type":"string","const":"owned_opt_in_list","title":"Audience Basis"},"sender_name":{"type":"string","maxLength":100,"minLength":2,"title":"Sender Name"},"tone":{"type":"string","enum":["clear","warm","playful","premium"],"title":"Tone","default":"clear"}},"additionalProperties":false,"type":"object","required":["product","campaign_goal","audience_basis","sender_name"],"title":"EmailFlowPackRequest","description":"Draft-only email sequence for an audience the seller confirms opted in."},"GalleryImageInput":{"properties":{"position":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Position"},"visual_description":{"type":"string","maxLength":1000,"minLength":5,"title":"Visual Description"},"focus_keywords":{"items":{"type":"string","maxLength":100,"minLength":1},"type":"array","maxItems":5,"title":"Focus Keywords"},"is_main_image":{"type":"boolean","title":"Is Main Image","default":false}},"additionalProperties":false,"type":"object","required":["position","visual_description"],"title":"GalleryImageInput"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HolidayCopyRefreshRequest":{"properties":{"marketplace":{"$ref":"#/components/schemas/Marketplace","default":"amazon_us"},"product_name":{"type":"string","maxLength":200,"minLength":2,"title":"Product Name"},"occasion":{"type":"string","enum":["holiday_gifting","black_friday","cyber_monday","mothers_day","fathers_day","back_to_school","summer","winter"],"title":"Occasion"},"current_title":{"type":"string","maxLength":500,"minLength":5,"title":"Current Title"},"current_bullets":{"items":{"type":"string","maxLength":1000,"minLength":2},"type":"array","maxItems":10,"title":"Current Bullets"},"current_description":{"type":"string","maxLength":5000,"title":"Current Description","default":""},"seasonal_context":{"items":{"type":"string","maxLength":300,"minLength":2},"type":"array","maxItems":5,"minItems":1,"title":"Seasonal Context"},"verified_offer":{"anyOf":[{"type":"string","maxLength":200,"minLength":2},{"type":"null"}],"title":"Verified Offer"},"campaign_end_date":{"type":"string","pattern":"^20\\d{2}-\\d{2}-\\d{2}$","title":"Campaign End Date"},"tone":{"type":"string","enum":["warm","direct","playful","premium"],"title":"Tone","default":"warm"}},"additionalProperties":false,"type":"object","required":["product_name","occasion","current_title","seasonal_context","campaign_end_date"],"title":"HolidayCopyRefreshRequest"},"ImageAltTextPackRequest":{"properties":{"product":{"$ref":"#/components/schemas/ProductFacts"},"images":{"items":{"$ref":"#/components/schemas/GalleryImageInput"},"type":"array","maxItems":12,"minItems":1,"title":"Images"},"alt_text_max_characters":{"type":"integer","maximum":250.0,"minimum":80.0,"title":"Alt Text Max Characters","default":125},"caption_max_characters":{"type":"integer","maximum":300.0,"minimum":100.0,"title":"Caption Max Characters","default":180}},"additionalProperties":false,"type":"object","required":["product","images"],"title":"ImageAltTextPackRequest"},"JobAccepted":{"properties":{"job_id":{"type":"string","title":"Job Id"},"job_token":{"type":"string","title":"Job Token"},"status":{"type":"string","enum":["queued","running","succeeded","failed"],"title":"Status"},"reused":{"type":"boolean","title":"Reused"},"status_url":{"type":"string","title":"Status Url"},"artifact_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Artifact Url"},"retention_hours":{"type":"integer","title":"Retention Hours"},"payment_note":{"type":"string","title":"Payment Note"}},"additionalProperties":false,"type":"object","required":["job_id","job_token","status","reused","status_url","retention_hours","payment_note"],"title":"JobAccepted"},"JobStatus":{"properties":{"job_id":{"type":"string","title":"Job Id"},"service":{"type":"string","title":"Service"},"status":{"type":"string","enum":["queued","running","succeeded","failed"],"title":"Status"},"attempts":{"type":"integer","title":"Attempts"},"result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Result"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"artifact_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Artifact Url"},"created_at":{"type":"string","title":"Created At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"}},"additionalProperties":false,"type":"object","required":["job_id","service","status","attempts","created_at"],"title":"JobStatus"},"KeywordGapRequest":{"properties":{"marketplace":{"$ref":"#/components/schemas/Marketplace","default":"amazon_us"},"your_listing":{"$ref":"#/components/schemas/ListingContent"},"competitor_listings":{"items":{"$ref":"#/components/schemas/ListingContent"},"type":"array","maxItems":3,"minItems":1,"title":"Competitor Listings"},"max_gap_terms":{"type":"integer","maximum":50.0,"minimum":5.0,"title":"Max Gap Terms","default":20},"include_phrases":{"type":"boolean","title":"Include Phrases","default":true},"competitor_brands":{"items":{"type":"string","maxLength":100,"minLength":1},"type":"array","maxItems":20,"title":"Competitor Brands"},"ignore_terms":{"items":{"type":"string","maxLength":100,"minLength":1},"type":"array","maxItems":100,"title":"Ignore Terms"}},"additionalProperties":false,"type":"object","required":["your_listing","competitor_listings"],"title":"KeywordGapRequest"},"ListingAppealRequest":{"properties":{"marketplace":{"$ref":"#/components/schemas/Marketplace","default":"amazon_us"},"listing_identifier":{"type":"string","maxLength":80,"minLength":1,"pattern":"^[A-Za-z0-9._-]+$","title":"Listing Identifier"},"suppression_reason":{"$ref":"#/components/schemas/SuppressionReason"},"notice_text":{"type":"string","maxLength":5000,"minLength":1,"title":"Notice Text"},"corrective_actions_taken":{"items":{"type":"string","maxLength":500,"minLength":1},"type":"array","maxItems":20,"title":"Corrective Actions Taken"},"preventive_actions_taken":{"items":{"type":"string","maxLength":500,"minLength":1},"type":"array","maxItems":20,"title":"Preventive Actions Taken"},"evidence_available":{"items":{"type":"string","maxLength":500,"minLength":1},"type":"array","maxItems":20,"title":"Evidence Available"},"tone":{"type":"string","enum":["brief","formal"],"title":"Tone","default":"formal"}},"additionalProperties":false,"type":"object","required":["listing_identifier","suppression_reason","notice_text"],"title":"ListingAppealRequest"},"ListingAuditRequest":{"properties":{"product":{"$ref":"#/components/schemas/ProductFacts"},"listing":{"$ref":"#/components/schemas/ListingContent"}},"additionalProperties":false,"type":"object","required":["product","listing"],"title":"ListingAuditRequest"},"ListingBuildRequest":{"properties":{"product":{"$ref":"#/components/schemas/ProductFacts"},"tone":{"type":"string","maxLength":200,"title":"Tone","default":"clear, factual, benefit-led"},"include_search_terms":{"type":"boolean","title":"Include Search Terms","default":true}},"additionalProperties":false,"type":"object","required":["product"],"title":"ListingBuildRequest"},"ListingContent":{"properties":{"title":{"type":"string","maxLength":500,"minLength":5,"title":"Title"},"bullets":{"items":{"type":"string","maxLength":1000,"minLength":2},"type":"array","maxItems":10,"minItems":1,"title":"Bullets"},"description":{"type":"string","maxLength":10000,"minLength":10,"title":"Description"},"backend_keywords":{"items":{"type":"string","maxLength":100,"minLength":1},"type":"array","maxItems":100,"title":"Backend Keywords"}},"additionalProperties":false,"type":"object","required":["title","bullets","description"],"title":"ListingContent"},"ListingTitleVariantsRequest":{"properties":{"product":{"$ref":"#/components/schemas/ProductFacts"},"current_title":{"anyOf":[{"type":"string","maxLength":500,"minLength":1},{"type":"null"}],"title":"Current Title"},"focus_keywords":{"items":{"type":"string","maxLength":100,"minLength":1},"type":"array","maxItems":20,"title":"Focus Keywords"}},"additionalProperties":false,"type":"object","required":["product"],"title":"ListingTitleVariantsRequest"},"Marketplace":{"type":"string","enum":["amazon_us","walmart_us","shopify","ebay_us"],"title":"Marketplace"},"MarketplaceAdsKitRequest":{"properties":{"item_id":{"type":"string","maxLength":100,"minLength":1,"title":"Item Id"},"product":{"$ref":"#/components/schemas/ProductFacts"},"target_acos_percent":{"type":"number","maximum":100.0,"exclusiveMinimum":0.0,"title":"Target Acos Percent"},"daily_budget_usd":{"type":"number","maximum":100000.0,"exclusiveMinimum":0.0,"title":"Daily Budget Usd"},"conversion_rate_percent":{"type":"number","maximum":100.0,"exclusiveMinimum":0.0,"title":"Conversion Rate Percent","default":10},"keywords":{"items":{"$ref":"#/components/schemas/PPCKeyword"},"type":"array","maxItems":200,"title":"Keywords"},"negative_keywords":{"items":{"type":"string","maxLength":100,"minLength":2},"type":"array","maxItems":100,"title":"Negative Keywords"},"max_bid_usd":{"anyOf":[{"type":"number","maximum":1000.0,"exclusiveMinimum":0.0},{"type":"null"}],"title":"Max Bid Usd"},"max_ad_rate_percent":{"anyOf":[{"type":"number","maximum":100.0,"exclusiveMinimum":0.0},{"type":"null"}],"title":"Max Ad Rate Percent"}},"additionalProperties":false,"type":"object","required":["item_id","product","target_acos_percent","daily_budget_usd"],"title":"MarketplaceAdsKitRequest"},"MarketplaceClaimCheckRequest":{"properties":{"marketplace":{"$ref":"#/components/schemas/Marketplace"},"text":{"type":"string","maxLength":20000,"minLength":1,"title":"Text"},"verified_claims":{"items":{"type":"string","maxLength":500,"minLength":1},"type":"array","maxItems":100,"title":"Verified Claims"},"forbidden_claims":{"items":{"type":"string","maxLength":500,"minLength":1},"type":"array","maxItems":100,"title":"Forbidden Claims"}},"additionalProperties":false,"type":"object","required":["marketplace","text"],"title":"MarketplaceClaimCheckRequest"},"MarketplaceImageBriefRequest":{"properties":{"product":{"$ref":"#/components/schemas/ProductFacts"},"image_count":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Image Count","default":7},"objective":{"type":"string","enum":["new_listing","listing_refresh","conversion_improvement"],"title":"Objective","default":"new_listing"},"available_assets":{"items":{"type":"string","maxLength":500,"minLength":1},"type":"array","maxItems":30,"title":"Available Assets"},"must_show":{"items":{"type":"string","maxLength":500,"minLength":1},"type":"array","maxItems":20,"title":"Must Show"},"included_items":{"items":{"type":"string","maxLength":500,"minLength":1},"type":"array","maxItems":30,"title":"Included Items"},"avoid":{"items":{"type":"string","maxLength":500,"minLength":1},"type":"array","maxItems":20,"title":"Avoid"},"variants":{"items":{"type":"string","maxLength":500,"minLength":1},"type":"array","maxItems":30,"title":"Variants"},"brand_colors":{"items":{"type":"string","maxLength":50,"minLength":1},"type":"array","maxItems":10,"title":"Brand Colors"},"include_alt_text":{"type":"boolean","title":"Include Alt Text","default":true}},"additionalProperties":false,"type":"object","required":["product"],"title":"MarketplaceImageBriefRequest"},"MarketplaceTitleOptimizerRequest":{"properties":{"product":{"$ref":"#/components/schemas/ProductFacts"},"current_title":{"anyOf":[{"type":"string","maxLength":500,"minLength":1},{"type":"null"}],"title":"Current Title"}},"additionalProperties":false,"type":"object","required":["product"],"title":"MarketplaceTitleOptimizerRequest"},"OmnichannelLaunchRequest":{"properties":{"product":{"$ref":"#/components/schemas/ProductFacts"},"sku":{"type":"string","maxLength":80,"minLength":1,"pattern":"^[A-Za-z0-9._-]+$","title":"Sku"},"quantity":{"type":"integer","maximum":10000000.0,"minimum":0.0,"title":"Quantity","default":0},"currency":{"type":"string","const":"USD","title":"Currency","default":"USD"},"gtin":{"anyOf":[{"type":"string","pattern":"^[0-9]{8,14}$"},{"type":"null"}],"title":"Gtin"},"image_urls":{"items":{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},"type":"array","maxItems":250,"title":"Image Urls"},"condition":{"type":"string","enum":["NEW","LIKE_NEW","VERY_GOOD","GOOD","ACCEPTABLE"],"title":"Condition","default":"NEW"},"country_of_origin":{"anyOf":[{"type":"string","pattern":"^[A-Z]{2}$"},{"type":"null"}],"title":"Country Of Origin"},"walmart_product_type":{"anyOf":[{"type":"string","maxLength":150},{"type":"null"}],"title":"Walmart Product Type"},"shopify_product_category":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Shopify Product Category"},"ebay_category_id":{"anyOf":[{"type":"string","pattern":"^[0-9]+$"},{"type":"null"}],"title":"Ebay Category Id"},"ebay_marketplace_id":{"type":"string","const":"EBAY_US","title":"Ebay Marketplace Id","default":"EBAY_US"},"ebay_merchant_location_key":{"anyOf":[{"type":"string","maxLength":36},{"type":"null"}],"title":"Ebay Merchant Location Key"},"ebay_payment_policy_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Ebay Payment Policy Id"},"ebay_return_policy_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Ebay Return Policy Id"},"ebay_fulfillment_policy_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Ebay Fulfillment Policy Id"}},"additionalProperties":false,"type":"object","required":["product","sku"],"title":"OmnichannelLaunchRequest"},"PPCKeyword":{"properties":{"term":{"type":"string","maxLength":100,"minLength":2,"title":"Term"},"match_type":{"type":"string","enum":["exact","phrase","broad"],"title":"Match Type","default":"exact"}},"additionalProperties":false,"type":"object","required":["term"],"title":"PPCKeyword"},"PPCKitRequest":{"properties":{"asin":{"type":"string","pattern":"^[A-Z0-9]{10}$","title":"Asin"},"product":{"$ref":"#/components/schemas/ProductFacts"},"target_acos_percent":{"type":"number","maximum":100.0,"exclusiveMinimum":0.0,"title":"Target Acos Percent"},"daily_budget_usd":{"type":"number","maximum":100000.0,"exclusiveMinimum":0.0,"title":"Daily Budget Usd"},"conversion_rate_percent":{"type":"number","maximum":100.0,"exclusiveMinimum":0.0,"title":"Conversion Rate Percent","default":10},"keywords":{"items":{"$ref":"#/components/schemas/PPCKeyword"},"type":"array","maxItems":200,"title":"Keywords"},"negative_keywords":{"items":{"type":"string","maxLength":100,"minLength":2},"type":"array","maxItems":100,"title":"Negative Keywords"},"max_bid_usd":{"anyOf":[{"type":"number","maximum":1000.0,"exclusiveMinimum":0.0},{"type":"null"}],"title":"Max Bid Usd"}},"additionalProperties":false,"type":"object","required":["asin","product","target_acos_percent","daily_budget_usd"],"title":"PPCKitRequest"},"PricingWhatIfRequest":{"properties":{"marketplace":{"$ref":"#/components/schemas/Marketplace","default":"amazon_us"},"product_name":{"type":"string","maxLength":200,"minLength":1,"title":"Product Name"},"current_price":{"type":"number","maximum":100000.0,"exclusiveMinimum":0.0,"title":"Current Price"},"unit_cost":{"type":"number","maximum":100000.0,"minimum":0.0,"title":"Unit Cost"},"referral_fee_percent":{"type":"number","maximum":50.0,"minimum":0.0,"title":"Referral Fee Percent","default":15.0},"fixed_fee_per_unit":{"type":"number","maximum":10000.0,"minimum":0.0,"title":"Fixed Fee Per Unit","default":0.0},"monthly_units":{"type":"integer","maximum":1000000.0,"minimum":1.0,"title":"Monthly Units"},"candidate_prices":{"items":{"type":"number","maximum":100000.0,"exclusiveMinimum":0.0},"type":"array","maxItems":8,"minItems":1,"title":"Candidate Prices"}},"additionalProperties":false,"type":"object","required":["product_name","current_price","unit_cost","monthly_units","candidate_prices"],"title":"PricingWhatIfRequest","description":"Seller-supplied unit economics for a deterministic price-change comparison."},"ProductDescriptionHtmlRequest":{"properties":{"marketplace":{"$ref":"#/components/schemas/Marketplace","default":"amazon_us"},"description":{"type":"string","maxLength":15000,"minLength":20,"title":"Description"},"feature_highlights":{"items":{"type":"string","maxLength":500,"minLength":2},"type":"array","maxItems":10,"title":"Feature Highlights"}},"additionalProperties":false,"type":"object","required":["description"],"title":"ProductDescriptionHtmlRequest"},"ProductFacts":{"properties":{"marketplace":{"$ref":"#/components/schemas/Marketplace","default":"amazon_us"},"brand":{"type":"string","maxLength":100,"minLength":1,"title":"Brand"},"product_name":{"type":"string","maxLength":200,"minLength":2,"title":"Product Name"},"category":{"type":"string","maxLength":150,"minLength":2,"title":"Category"},"features":{"items":{"type":"string","maxLength":500,"minLength":1},"type":"array","maxItems":20,"minItems":1,"title":"Features"},"benefits":{"items":{"type":"string","maxLength":500,"minLength":1},"type":"array","maxItems":20,"title":"Benefits"},"target_audience":{"type":"string","maxLength":500,"title":"Target Audience","default":"general shoppers"},"keywords":{"items":{"type":"string","maxLength":100,"minLength":1},"type":"array","maxItems":50,"title":"Keywords"},"dimensions":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Dimensions"},"materials":{"items":{"type":"string","maxLength":100,"minLength":1},"type":"array","maxItems":20,"title":"Materials"},"verified_claims":{"items":{"type":"string","maxLength":500,"minLength":1},"type":"array","maxItems":20,"title":"Verified Claims"},"forbidden_claims":{"items":{"type":"string","maxLength":500,"minLength":1},"type":"array","maxItems":20,"title":"Forbidden Claims"},"price_usd":{"anyOf":[{"type":"number","maximum":1000000.0,"exclusiveMinimum":0.0},{"type":"null"}],"title":"Price Usd"},"product_url":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"null"}],"title":"Product Url"}},"additionalProperties":false,"type":"object","required":["brand","product_name","category","features"],"title":"ProductFacts"},"PromotionProfitRequest":{"properties":{"marketplace":{"$ref":"#/components/schemas/Marketplace","default":"amazon_us"},"product_name":{"type":"string","maxLength":200,"minLength":1,"title":"Product Name"},"list_price":{"type":"number","maximum":100000.0,"exclusiveMinimum":0.0,"title":"List Price"},"unit_cost":{"type":"number","maximum":100000.0,"minimum":0.0,"title":"Unit Cost"},"referral_fee_percent":{"type":"number","maximum":50.0,"minimum":0.0,"title":"Referral Fee Percent","default":15.0},"fulfillment_cost_per_unit":{"type":"number","maximum":10000.0,"minimum":0.0,"title":"Fulfillment Cost Per Unit","default":0.0},"scenarios":{"items":{"$ref":"#/components/schemas/PromotionScenarioInput"},"type":"array","maxItems":8,"minItems":1,"title":"Scenarios"}},"additionalProperties":false,"type":"object","required":["product_name","list_price","unit_cost","scenarios"],"title":"PromotionProfitRequest","description":"Seller-supplied unit economics for deterministic promotion arithmetic."},"PromotionScenarioInput":{"properties":{"label":{"type":"string","maxLength":80,"minLength":1,"title":"Label"},"discount_percent":{"type":"number","maximum":90.0,"exclusiveMinimum":0.0,"title":"Discount Percent"},"expected_units":{"type":"integer","maximum":1000000.0,"minimum":1.0,"title":"Expected Units"},"fee_per_redemption":{"type":"number","maximum":10000.0,"minimum":0.0,"title":"Fee Per Redemption","default":0.0},"fixed_promotion_fee":{"type":"number","maximum":100000.0,"minimum":0.0,"title":"Fixed Promotion Fee","default":0.0}},"additionalProperties":false,"type":"object","required":["label","discount_percent","expected_units"],"title":"PromotionScenarioInput"},"RestockPlanRequest":{"properties":{"marketplace":{"$ref":"#/components/schemas/Marketplace","default":"amazon_us"},"default_lead_time_days":{"type":"integer","maximum":365.0,"minimum":1.0,"title":"Default Lead Time Days","default":30},"review_period_days":{"type":"integer","maximum":90.0,"minimum":1.0,"title":"Review Period Days","default":14},"target_cover_days":{"type":"integer","maximum":365.0,"minimum":7.0,"title":"Target Cover Days","default":60},"skus":{"items":{"$ref":"#/components/schemas/RestockSkuInput"},"type":"array","maxItems":100,"minItems":1,"title":"Skus"}},"additionalProperties":false,"type":"object","required":["skus"],"title":"RestockPlanRequest"},"RestockSkuInput":{"properties":{"sku":{"type":"string","maxLength":80,"minLength":1,"pattern":"^[A-Za-z0-9._-]+$","title":"Sku"},"product_name":{"anyOf":[{"type":"string","maxLength":200,"minLength":2},{"type":"null"}],"title":"Product Name"},"units_on_hand":{"type":"integer","maximum":10000000.0,"minimum":0.0,"title":"Units On Hand"},"units_inbound":{"type":"integer","maximum":10000000.0,"minimum":0.0,"title":"Units Inbound","default":0},"daily_sales_velocity":{"type":"number","maximum":100000.0,"exclusiveMinimum":0.0,"title":"Daily Sales Velocity"},"lead_time_days":{"anyOf":[{"type":"integer","maximum":365.0,"minimum":1.0},{"type":"null"}],"title":"Lead Time Days"},"minimum_order_quantity":{"anyOf":[{"type":"integer","maximum":1000000.0,"minimum":1.0},{"type":"null"}],"title":"Minimum Order Quantity"},"case_pack_units":{"anyOf":[{"type":"integer","maximum":100000.0,"minimum":1.0},{"type":"null"}],"title":"Case Pack Units"}},"additionalProperties":false,"type":"object","required":["sku","units_on_hand","daily_sales_velocity"],"title":"RestockSkuInput"},"ReturnReasonAnalysisRequest":{"properties":{"marketplace":{"$ref":"#/components/schemas/Marketplace","default":"amazon_us"},"product_name":{"type":"string","maxLength":200,"minLength":2,"title":"Product Name"},"sku":{"anyOf":[{"type":"string","maxLength":80,"minLength":1,"pattern":"^[A-Za-z0-9._-]+$"},{"type":"null"}],"title":"Sku"},"units_sold":{"anyOf":[{"type":"integer","maximum":10000000.0,"minimum":1.0},{"type":"null"}],"title":"Units Sold"},"returns":{"items":{"$ref":"#/components/schemas/ReturnReasonEntry"},"type":"array","maxItems":200,"minItems":1,"title":"Returns"}},"additionalProperties":false,"type":"object","required":["product_name","returns"],"title":"ReturnReasonAnalysisRequest"},"ReturnReasonEntry":{"properties":{"reason_text":{"type":"string","maxLength":300,"minLength":2,"title":"Reason Text"},"units":{"type":"integer","maximum":100000.0,"minimum":1.0,"title":"Units","default":1},"buyer_comment":{"anyOf":[{"type":"string","maxLength":500,"minLength":1},{"type":"null"}],"title":"Buyer Comment"}},"additionalProperties":false,"type":"object","required":["reason_text"],"title":"ReturnReasonEntry"},"ReviewResponseRequest":{"properties":{"marketplace":{"$ref":"#/components/schemas/Marketplace"},"rating":{"type":"integer","maximum":5.0,"minimum":1.0,"title":"Rating"},"review_text":{"type":"string","maxLength":5000,"minLength":1,"title":"Review Text"},"tone":{"type":"string","enum":["brief","warm","formal"],"title":"Tone","default":"warm"},"include_support_invitation":{"type":"boolean","title":"Include Support Invitation","default":true}},"additionalProperties":false,"type":"object","required":["marketplace","rating","review_text"],"title":"ReviewResponseRequest"},"SuppressionReason":{"type":"string","enum":["image_requirements","missing_attribute","restricted_claim","pricing_error","variation_error","ip_complaint","safety_complaint","other"],"title":"SuppressionReason"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VariationAttribute":{"properties":{"name":{"type":"string","maxLength":80,"minLength":1,"title":"Name"},"value":{"type":"string","maxLength":120,"minLength":1,"title":"Value"}},"additionalProperties":false,"type":"object","required":["name","value"],"title":"VariationAttribute"},"VariationChild":{"properties":{"sku":{"type":"string","maxLength":80,"minLength":1,"pattern":"^[A-Za-z0-9._-]+$","title":"Sku"},"product_name":{"type":"string","maxLength":200,"minLength":2,"title":"Product Name"},"attributes":{"items":{"$ref":"#/components/schemas/VariationAttribute"},"type":"array","maxItems":10,"minItems":1,"title":"Attributes"}},"additionalProperties":false,"type":"object","required":["sku","product_name","attributes"],"title":"VariationChild"},"VariationFamilyPlanRequest":{"properties":{"marketplace":{"$ref":"#/components/schemas/Marketplace"},"parent_label":{"type":"string","maxLength":200,"minLength":2,"title":"Parent Label"},"theme_attributes":{"items":{"type":"string","maxLength":80,"minLength":1},"type":"array","maxItems":3,"minItems":1,"title":"Theme Attributes"},"variants":{"items":{"$ref":"#/components/schemas/VariationChild"},"type":"array","maxItems":50,"minItems":2,"title":"Variants"}},"additionalProperties":false,"type":"object","required":["marketplace","parent_label","theme_attributes","variants"],"title":"VariationFamilyPlanRequest"},"WalmartRichMediaBriefRequest":{"properties":{"product":{"$ref":"#/components/schemas/ProductFacts"},"objective":{"type":"string","enum":["new_launch","refresh","product_education"],"title":"Objective","default":"new_launch"},"module_count":{"type":"integer","maximum":5.0,"minimum":3.0,"title":"Module Count","default":5},"brand_tone":{"type":"string","enum":["clear","warm","premium","technical"],"title":"Brand Tone","default":"clear"},"available_assets":{"items":{"type":"string","maxLength":500,"minLength":1},"type":"array","maxItems":30,"title":"Available Assets"},"avoid":{"items":{"type":"string","maxLength":500,"minLength":1},"type":"array","maxItems":30,"title":"Avoid"}},"additionalProperties":false,"type":"object","required":["product"],"title":"WalmartRichMediaBriefRequest"}}}}