{"uid":"cap_01i3-bwCWmaqrj6nVVYFj","slug":"friday-seller-tools-seasonal-demand-calendar-d229c854","name":"Friday Seller Tools – Seasonal Demand Calendar","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/planning/seasonal-demand-calendar","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"category":{"enum":["outdoor_garden","toys_games","home_kitchen","apparel_accessories","electronics_accessories","health_personal_care","beauty_grooming","office_school","grocery_gourmet","sports_fitness","pet_supplies","baby","party_seasonal_decor","tools_home_improvement","general"],"type":"string","title":"Category"},"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},"lead_time_days":{"type":"integer","title":"Lead Time Days","default":30,"maximum":365,"minimum":1},"extra_peak_months":{"type":"array","items":{"type":"integer","maximum":12,"minimum":1},"title":"Extra Peak Months","maxItems":12},"listing_refresh_lead_days":{"type":"integer","title":"Listing Refresh Lead Days","default":21,"maximum":180,"minimum":1}}},"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_Yv8v7gC_hWgM3sUVVbFdc","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":"Generates a seasonal demand calendar for e-commerce products across Amazon, Walmart, Shopify, and eBay to guide listing and advertising timing.","exampleAgentPrompt":"Can you generate a seasonal demand calendar for my kitchen gadget products across Amazon and Shopify so I can plan my listings and ad spend around peak shopping periods for the rest of this year?","exampleUseCases":[{"title":"Holiday ad spend planning for Amazon","prompt":"I sell outdoor furniture on Amazon — can you build me a seasonal demand calendar so I know when to ramp up my PPC budget and when demand typically drops off throughout the year?"},{"title":"Multi-marketplace launch timing","prompt":"I'm launching a new line of fitness accessories on Amazon, Walmart, and Shopify — can you generate a seasonal demand calendar so I know the best windows to publish listings and run promotions on each platform?"},{"title":"eBay seasonal listing strategy","prompt":"I resell winter clothing on eBay and want to stop guessing — pull me a seasonal demand calendar for apparel so I can schedule my listings and pricing changes around actual demand peaks."}],"resultDescription":"Returns a job_id and queued status immediately; the completed result is a seasonal demand calendar detailing peak demand windows, promotional timing recommendations, and seasonal trends across the requested marketplaces and product categories to guide listing, launch, and advertising scheduling decisions.","failureModes":["Missing or invalid product category returns a 400 error","Unsupported marketplace identifier causes validation failure","Job may remain in queued state if processing is delayed on the backend","Empty or overly broad keyword inputs may yield low-confidence calendar output","Network timeout to the Railway-hosted service may require retry"],"whenToPreferThis":"Use this endpoint when you need structured, calendar-based seasonal demand intelligence specifically for multi-marketplace e-commerce sellers (Amazon, Walmart, Shopify, eBay) to plan listing timing and advertising budgets; prefer it over generic trend APIs when the output needs to be actionable for seller workflow planning at $0.25 per call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:48:27.597Z","isFirstParty":false}