{"openapi":"3.1.0","info":{"title":"Kirppiskettu Agentic Circular Economy & Flea Market API","version":"1.0.0","description":"Machine-readable API for verified Finnish flea market directory, circular valuation, B2B data licensing, and autonomous commerce payments following MPP and x402 standards. Protected under Finnish Copyright Act Sec. 49.","termsOfService":"https://muuttokettu.fi/ehdot#api-lisenssi","contact":{"name":"Pelkosen Koneisto Oy","url":"https://kirppiskettu.fi/api-lisenssi","email":"api@kirppiskettu.fi"},"license":{"name":"Commercial Database License / Tekijänoikeuslaki 49 §","url":"https://kirppiskettu.fi/api-lisenssi"}},"x-service-info":{"service_name":"Kirppiskettu Circular Economy & B2B Data Engine","categories":["ecommerce","data_license","api","circular_economy","directory","vintage"],"supported_transports":["https","mcp"]},"servers":[{"url":"https://kirppiskettu.fi/api"}],"paths":{"/stores":{"get":{"summary":"Query and filter verified Finnish flea markets and second-hand stores","description":"Returns paginated and filtered flea market venues across 19 Finnish regions. Rate-limited to 60 req/min for demo/public queries; higher throughput requires a commercial license key (x-api-key).","operationId":"getFleaMarketStores","parameters":[{"name":"kunta","in":"query","description":"Filter by municipality name (e.g., Helsinki, Tampere, Hamina)","schema":{"type":"string"}},{"name":"maakunta","in":"query","description":"Filter by region ID or name (e.g., uusimaa, pirkanmaa)","schema":{"type":"string"}},{"name":"kategoria","in":"query","description":"Filter by operator category (itsepalvelu, hyvantekevaisyys, osto_myynti, vintage_antiikki)","schema":{"type":"string"}},{"name":"q","in":"query","description":"Free text search matching name, street address, or notes","schema":{"type":"string"}},{"name":"aukiNyt","in":"query","description":"Filter to stores open right now (true/false)","schema":{"type":"boolean"}},{"name":"page","in":"query","description":"Page number (defaults to 1)","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","description":"Number of records to return (defaults to 30, max 50 for demo, max 200 for licensed keys)","schema":{"type":"integer","default":30}},{"name":"x-api-key","in":"header","description":"Commercial B2B API Key (29 € / month license from /api-lisenssi)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful stores query response with pagination and metadata"},"429":{"description":"Rate limit exceeded (60 req/min for demo tier). Commercial license required."}}}},"/stores/{id}":{"get":{"summary":"Retrieve single verified flea market store by ID","operationId":"getStoreById","parameters":[{"name":"id","in":"path","required":true,"description":"Unique slug ID of the store","schema":{"type":"string"}}],"responses":{"200":{"description":"Store details found"},"404":{"description":"Store not found"}}}},"/stripe/checkout":{"post":{"summary":"Commercial B2B API Key Subscription Checkout (29 € / month)","description":"Initiates a Stripe Checkout session to purchase a commercial REST API subscription license (10,000 req/month) under Finnish Copyright Act Sec. 49.","operationId":"createApiSubscriptionCheckout","x-payment-info":{"intent":"session","method":"stripe","currency":"EUR","amount":2900,"description":"Kirppiskettu B2B REST API 10,000 req/month subscription license"},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","description":"Customer email address for key delivery"},"companyName":{"type":"string","description":"Company or licensee name"},"returnUrl":{"type":"string","description":"Redirect URL after checkout"}}}}}},"responses":{"200":{"description":"Stripe checkout session created or sandbox key generated"},"500":{"description":"Checkout creation error"}}}},"/agent-pay":{"post":{"summary":"Autonomous Machine-to-Machine Payment via x402 and MPP","description":"Facilitates direct autonomous micropayments in Base USDC without human checkout.","operationId":"executeAgentPayment","x-payment-info":{"intent":"charge","method":"x402","currency":"EUR","amount":50,"description":"Kirppiskettu autonomous agent query and telemetry stream"},"responses":{"200":{"description":"Agent payment confirmed"},"402":{"description":"Payment required via x402 protocol (returns WWW-Authenticate and wallet requirements)"}}}},"/precious-metals":{"get":{"summary":"Real-time Scrap Gold and Silver Buyback Benchmark Prices in Finland","operationId":"getPreciousMetalsPrices","responses":{"200":{"description":"Successful market pricing benchmark"}}}},"/weather":{"get":{"summary":"Weather and Outdoor Market Conditions for Finnish Municipalities","operationId":"getWeatherConditions","parameters":[{"name":"city","in":"query","schema":{"type":"string"}},{"name":"lat","in":"query","schema":{"type":"number"}},{"name":"lng","in":"query","schema":{"type":"number"}}],"responses":{"200":{"description":"Successful weather response"}}}}}}