Klysto MarketplacePolicies

Klysto Marketplace API

These read endpoints expose Klysto public marketplace data when the related marketplace flags and launch-country gates are enabled. Responses are intentionally conservative and do not authorize claiming Meta eligibility.

Public Read Endpoints

Marketplace model Klysto is a direct-deal classifieds surface: Klysto provides listing pages, messages, reports, and records; buyer and seller handle payment and deal details directly. Klysto does not provide checkout, escrow, shipping labels, street-address verification, refunds, returns, or chargeback decisions.
GET /marketplace/items.json Browse public listings with search, category, country, locality, seller type, price, sort, and pagination filters.
GET /marketplace/categories.json List category counts for visible marketplace listings.
GET /item/<public_id>.json Fetch one visible listing with contact/report availability and seller profile URL when available.
GET /seller/<profile_id>.json Fetch one active seller profile with paginated visible listings and storefront filters.
GET /marketplace/availability.json Inspect public marketplace flag and launch-country readiness, direct-deal operating model, required listing fields, and conservative eligibility state.
GET /marketplace/buyer-readiness.json Machine-readable buyer direct-deal checklist, problem routing, quick replies, and case readiness.
GET /marketplace/client-config.json Single production client configuration for marketplace flags, guardrails, defaults, and contract endpoint discovery.
GET /marketplace/contact-intents.json Machine-readable buyer contact presets for final-total and still-available messages, including the exact inquiry fields Klysto stores.
POST /marketplace/buyer-chats Load account-backed buyer inquiry threads with chat, reserved, and completed-direct-deal activity labels. Requires a Klysto account/device header; Klysto stores records but does not handle payment, logistics, refunds, or chargebacks.
GET /marketplace/deal-workflow.json Machine-readable direct-deal state and action model for inquiries, reservations, sold closeout, reporting, and forbidden checkout/escrow/logistics states.
GET /marketplace/eligibility.json Inspect conservative marketplace readiness diagnostics. This endpoint always returns canClaimMetaEligibility: false.
GET /marketplace/meta-partner-feed.json, /marketplace/meta-partner-feed.csv Conservative Meta partner inventory export surface. It includes only real active consumer listings in configured EEA launch countries with image, location, seller profile, and buyer continuation/contact path. Empty feeds are expected before real EEA inventory exists and do not authorize claiming Meta eligibility.
GET /marketplace/feedback-cases.json Machine-readable feedback, case, evidence, and direct-deal issue-record model. Klysto stores records and review notes, but does not handle refunds, chargebacks, escrow, payment processing, or logistics claims.
GET /marketplace/fulfillment-options.json Machine-readable direct-deal defaults, direct-payment options, and legacy aliases.
GET /marketplace/handoff-guide Explain the direct buyer/seller payment and completion model. Klysto coordinates messages and records, not checkout or logistics custody.
GET /marketplace/handoff-templates.json Machine-readable buyer and seller direct-deal message templates, closeout reminders, and deal checklist.
GET /marketplace/issue-taxonomy.json Machine-readable item report, seller report, buyer case, evidence, and marketplace issue boundary taxonomy.
GET/POST /marketplace/saved-items.json, /marketplace/saved-searches.json, /marketplace/saved-sellers.json Load account-backed or session-backed marketplace activity for saved listings, searches, and sellers. These are convenience records only and do not reserve inventory or imply checkout.
GET /marketplace/launch-checklist Human-readable launch-gate checklist for marketplace readiness. This page is intentionally conservative and does not claim Meta eligibility.
GET /marketplace/launch-countries Human-readable EEA launch-country setup page. It lists eligible country choices and keeps Klysto gated until real launch-country inventory and operations exist.
GET /marketplace/launch-readiness Human-readable real-data launch readiness page for Michael and internal deployment checks.
GET /marketplace/launch-checklist.json Machine-readable launch-gate checklist for app, website, deployment, and operations coordination.
GET /marketplace/launch-countries.json Machine-readable EEA launch-country options, configured country status, and guardrails for launch setup.
GET /marketplace/launch-readiness.json Real-data launch readiness status for launch country, inventory, seller identity, buyer continuation, notifications, moderation, discovery, and Meta-eligibility guardrails.
GET /marketplace/operations-readiness.json Machine-readable marketplace operations readiness for account-backed notification delivery, optional email delivery, admin moderation, notice handling, reports, cases, and remaining non-code blockers.
GET /marketplace/policies.json Machine-readable direct-deal policy summary for app, website, seller, buyer, and operations surfaces.
GET /marketplace/readiness.json Single conservative marketplace readiness manifest with launch flags, blockers, seller/buyer readiness, direct-deal options, message templates, issue taxonomy, and policy summary.
GET /marketplace/seller-readiness.json Machine-readable seller setup requirements, seller operations endpoint discovery, and public-launch vs Meta-eligibility boundaries.
POST /public-items/seller-ops, /public-items/seller-inbox, /public-items/seller-activity Load a seller's marketplace desk records: listings, inquiries, reports, feedback, cases, and status events. Requires seller account/device auth and does not create payment, escrow, or logistics custody.
POST /public-items/seller-listing-status, /public-items/seller-listing-renew Let sellers pause, publish, reserve, renew, or mark real listings sold. Marking sold requires direct-deal confirmation because payment happens outside Klysto.
POST /public-items/seller-inbox/reply, /public-items/seller-inbox/offer, /public-items/seller-inbox/offer/status, /public-items/seller-inbox/status Let sellers reply, counteroffer, accept or decline buyer offers, and update inquiry status while Klysto keeps the message/offer record only.