{"name":"product-scout","manifest_version":"1.0.0","schema_version":"2026-08-05","description":"Amazon marketplace intelligence for Ideoon sourcing (.de/.at/.ch/.fr/.it). Fetches live best-sellers/new-releases/movers, persists them into a longitudinal rank-history dataset we alone own, resolves sourceable identifiers (GTIN/EAN), and serves an enriched review queue. The core reasons about nothing: it fetches, persists, enriches, serves. Recommendations come from the consuming agent, not from product-scout.","base_url":"https://discovery.ideoon.eu","markets":["de","at","ch","fr","it"],"auth":{"type":"bearer","header":"Authorization","format":"Bearer <agent_api_key>","note":"Issued to Ideoon agents. Required on the data tools; manifest/health are open."},"capabilities":["best-sellers","category-shotgun","submit-recommendation","review-queue"],"honesty_classes":{"upstream_live":"Raw field from the live upstream fetch, returned as-is.","demand_sampled_discrete":"Captured only when an agent queries. Discrete observations. Never interpolated into a smooth line.","derived":"Computed by product-scout from its own append-only snapshots; each such field declares x-derivation.","backfillable_continuous":"Legitimately a continuous multi-year series (Google Trends, Phase 5); may be shown as a seasonal curve."},"parameter_naming":{"canonical":{"market":["de","at","ch","fr","it"],"list_type":["best_sellers","new_releases","movers"],"category":"stable product-scout category key (marketplace/list-type slug resolved server-side)","cursor":"opaque pagination token","limit":"page size (default 50, max 100)"},"not":{"market":["country","locale","domain"],"list_type":["type","kind","list"],"pagination":["page","per_page","offset"]}},"rate_limits":{"proxy_metered":true,"monthly_quota_units":10000,"upstream_requests_per_second":10,"note":"Upstream sends no quota headers; product-scout meters client-side and synthesizes X-RateLimit-* on every response. Each fanned-out upstream page = 1 unit."},"boundary":{"does":["fetch (live upstream)","persist (append-only snapshots)","enrich (identity, first-seen, trajectory)","serve"],"does_not":["recommend","rank for you","reason about products"]},"_links":{"self":"/manifest","tools":"/tools","openapi":"/openapi.json","errors":"/errors","health":"/health"}}