{"openapi":"3.1.0","info":{"title":"Comparare Software Catalog API","version":"1.0.0","description":"Read-only API over a B2B software directory: products, vendors (companies), categories, features, comparisons.\n\nAgents: call GET /parse?q=... to turn a free-text buyer request (Turkish or English) into filters, or GET /schema once to learn slugs, then GET /products with filters.\nCategory filters are AND-ed: `categories=crm,invoicing` returns products that cover BOTH. Metrics may be null (unknown); add include_unknown_metrics=true to keep those.\nEvery product carries `deloitte_alliance` (listed in the Deloitte alliance directory); filter with deloitte_alliance=true.\nText fields are English by default; add lang=tr (or Accept-Language: tr) for Turkish.\nNo auth needed. Send `Authorization: Bearer <token>` for higher rate limits. MCP endpoint: https://comparare.echoenes.dev/mcp"},"servers":[{"url":"https://comparare.echoenes.dev/api/v1"}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"}},"parameters":{"lang":{"name":"lang","in":"query","required":false,"description":"Language of descriptive text","schema":{"type":"string","enum":["en","tr"],"default":"en"}}},"schemas":{"Generic":{"type":"object","additionalProperties":true},"ProductCompact":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"tagline":{"type":"string"},"vendor":{"type":"string"},"vendor_slug":{"type":"string"},"vendor_employees":{"type":["integer","null"]},"vendor_hq_country":{"type":["string","null"]},"deloitte_alliance":{"type":"boolean","description":"Vendor/product listed in the Deloitte alliance directory"},"categories":{"type":"array","items":{"type":"string"}},"features":{"type":"array","items":{"type":"string"}},"pricing":{"type":"object"},"metrics":{"type":"object","properties":{"active_users":{"type":["integer","null"]},"customers":{"type":["integer","null"]}}},"rating":{"type":["number","null"]},"url":{"type":"string"},"api_url":{"type":"string"}}},"ProductList":{"type":"object","properties":{"filters":{"type":"object"},"meta":{"type":"object"},"data":{"type":"array","items":{"$ref":"#/components/schemas/ProductCompact"}}}}}},"paths":{"/parse":{"get":{"operationId":"parseQuery","summary":"Only parse a natural-language request into filters (no search)","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/lang"}],"responses":{"200":{"description":"Parsed intent and filters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Generic"}}}}}}},"/schema":{"get":{"operationId":"getSchema","summary":"Filter vocabulary: category tree, feature slugs, enums","responses":{"200":{"description":"Vocabulary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Generic"}}}}},"parameters":[{"$ref":"#/components/parameters/lang"}]}},"/categories":{"get":{"operationId":"listCategories","summary":"Category tree with product counts","responses":{"200":{"description":"Categories","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Generic"}}}}},"parameters":[{"$ref":"#/components/parameters/lang"}]}},"/features":{"get":{"operationId":"listFeatures","summary":"Feature vocabulary","responses":{"200":{"description":"Features","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Generic"}}}}},"parameters":[{"$ref":"#/components/parameters/lang"}]}},"/products":{"get":{"operationId":"searchProducts","summary":"Search and filter products","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Free text"},{"name":"categories","in":"query","required":false,"description":"Comma separated category slugs; product must cover ALL (parent slug = any child).","schema":{"type":"string"},"style":"form","explode":false},{"name":"category_mode","in":"query","schema":{"type":"string","enum":["all","any"]}},{"name":"features","in":"query","required":false,"description":"Comma separated feature slugs, all required.","schema":{"type":"string"},"style":"form","explode":false},{"name":"pricing_models","in":"query","required":false,"description":"Any of. Values: free, freemium, subscription, one-time, usage-based, quote, open-source","schema":{"type":"string"},"style":"form","explode":false},{"name":"deployment","in":"query","required":false,"description":"Any of. Values: cloud, on-premise, hybrid","schema":{"type":"string"},"style":"form","explode":false},{"name":"platforms","in":"query","required":false,"description":"Any of. Values: web, windows, macos, linux, ios, android","schema":{"type":"string"},"style":"form","explode":false},{"name":"segments","in":"query","required":false,"description":"Any of. Values: freelancer, small, mid, enterprise","schema":{"type":"string"},"style":"form","explode":false},{"name":"languages","in":"query","required":false,"description":"UI languages, all required (ISO 639-1).","schema":{"type":"string"},"style":"form","explode":false},{"name":"hq_countries","in":"query","required":false,"description":"Vendor HQ country, ISO alpha-2.","schema":{"type":"string"},"style":"form","explode":false},{"name":"industries","in":"query","required":false,"description":"Industries served, any of. Only products with a company profile carry industries. Values: banking, insurance, healthcare, life-sciences, public-sector, energy, manufacturing, automotive, retail, tmt, transportation, education, nonprofit, real-estate, professional-services, cross-industry","schema":{"type":"string"},"style":"form","explode":false},{"name":"min_employees","in":"query","required":false,"description":"Vendor headcount ≥","schema":{"type":"integer","minimum":0}},{"name":"max_employees","in":"query","required":false,"description":"Vendor headcount ≤","schema":{"type":"integer","minimum":0}},{"name":"min_active_users","in":"query","required":false,"description":"Active users ≥","schema":{"type":"integer","minimum":0}},{"name":"min_customers","in":"query","required":false,"description":"Customers (organisations) ≥","schema":{"type":"integer","minimum":0}},{"name":"include_unknown_metrics","in":"query","required":false,"description":"Keep products with unknown metric values","schema":{"type":"boolean"}},{"name":"free_plan","in":"query","required":false,"description":"","schema":{"type":"boolean"}},{"name":"free_trial","in":"query","required":false,"description":"","schema":{"type":"boolean"}},{"name":"open_source","in":"query","required":false,"description":"","schema":{"type":"boolean"}},{"name":"deloitte_alliance","in":"query","required":false,"description":"true = only products of vendors listed in the Deloitte alliance directory","schema":{"type":"boolean"}},{"name":"min_rating","in":"query","schema":{"type":"number","minimum":1,"maximum":5}},{"name":"max_price","in":"query","schema":{"type":"number"},"description":"Max starting price; free-plan products always pass"},{"name":"currency","in":"query","schema":{"type":"string","enum":["USD","EUR","TRY","GBP"]}},{"name":"founded_after","in":"query","required":false,"description":"Vendor founding year ≥","schema":{"type":"integer","minimum":0}},{"name":"founded_before","in":"query","required":false,"description":"Vendor founding year ≤","schema":{"type":"integer","minimum":0}},{"name":"sort","in":"query","schema":{"type":"string","enum":["relevance","rating","popularity","employees","customers","active_users","price","name","newest"]}},{"name":"page","in":"query","required":false,"description":"","schema":{"type":"integer","minimum":0}},{"name":"per_page","in":"query","required":false,"description":"Max 100","schema":{"type":"integer","minimum":0}},{"$ref":"#/components/parameters/lang"}],"responses":{"200":{"description":"Paginated products","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductList"}}}}}}},"/products/{slug}":{"get":{"operationId":"getProduct","summary":"Product details","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/lang"}],"responses":{"200":{"description":"Product","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Generic"}}}}}}},"/products/{slug}/alternatives":{"get":{"operationId":"getAlternatives","summary":"Alternative products (accepts the same filters as /products)","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max 50","schema":{"type":"integer","minimum":0}},{"$ref":"#/components/parameters/lang"}],"responses":{"200":{"description":"Alternatives","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Generic"}}}}}}},"/vendors":{"get":{"operationId":"searchVendors","summary":"Search software companies","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"hq_country","in":"query","required":false,"description":"ISO alpha-2","schema":{"type":"string"},"style":"form","explode":false},{"name":"category","in":"query","required":false,"description":"Vendors with products in these categories","schema":{"type":"string"},"style":"form","explode":false},{"name":"min_employees","in":"query","required":false,"description":"","schema":{"type":"integer","minimum":0}},{"name":"max_employees","in":"query","required":false,"description":"","schema":{"type":"integer","minimum":0}},{"name":"page","in":"query","required":false,"description":"","schema":{"type":"integer","minimum":0}},{"name":"per_page","in":"query","required":false,"description":"","schema":{"type":"integer","minimum":0}},{"$ref":"#/components/parameters/lang"}],"responses":{"200":{"description":"Vendors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Generic"}}}}}}},"/vendors/{slug}":{"get":{"operationId":"getVendor","summary":"Vendor details and products","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/lang"}],"responses":{"200":{"description":"Vendor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Generic"}}}}}}},"/compare":{"get":{"operationId":"compareProducts","summary":"Side-by-side comparison with feature matrix","parameters":[{"name":"products","in":"query","required":true,"description":"Comma separated product slugs (2-6)","schema":{"type":"string"},"style":"form","explode":false},{"$ref":"#/components/parameters/lang"}],"responses":{"200":{"description":"Comparison","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Generic"}}}}}}}}}