# Friday Seller Tools – Seasonal Demand Calendar

> Friday Seller Tools – Seasonal Demand Calendar is a paid API for AI agents from friday-seller-tools-production.up.railway.app, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-15).

Generates a seasonal demand calendar for e-commerce products across Amazon, Walmart, Shopify, and eBay to guide listing and advertising timing.

## Facts

- Endpoint: POST https://friday-seller-tools-production.up.railway.app/v1/planning/seasonal-demand-calendar
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/friday-seller-tools-seasonal-demand-calendar-d229c854
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_01i3-bwCWmaqrj6nVVYFj

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability friday-seller-tools-seasonal-demand-calendar-d229c854 -d '<json body>'
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Instant, low-cost Amazon, Walmart, Shopify, and eBay listing, upload-preparation, advertising, and image-brief deliverables.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "job_id": "example",
  "status": "queued"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/friday-seller-tools-seasonal-demand-calendar-d229c854/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from friday-seller-tools-production.up.railway.app](https://www.zero.xyz/host/friday-seller-tools-production.up.railway.app/llms.txt)