# Comparare

> B2B software directory focused on structured, filterable data: software products, the companies (vendors) behind them, categories, features, pricing, adoption metrics (active users, customers) and vendor facts (headcount, HQ, founding year). Read-only, no auth required.

## How to answer a user's software request

1. Easiest: pass the user's sentence verbatim (Turkish or English) to `GET https://comparare.echoenes.dev/api/v1/parse?q=<request>` to get the matching filters, then call `/api/v1/products` with them.
2. Precise: `GET https://comparare.echoenes.dev/api/v1/products` with filters, e.g. `?categories=crm,invoicing&min_employees=1000&min_active_users=10000`. Categories are AND-ed (one product must cover all). Use `category_mode=any` to OR them.
3. Details: `GET /api/v1/products/{slug}`, `GET /api/v1/vendors/{slug}`, `GET /api/v1/products/{slug}/alternatives`.
4. Compare: `GET /api/v1/compare?products=a,b,c` → side-by-side data + feature matrix + shareable `url`.
5. Deloitte alliances: every product/vendor has `deloitte_alliance` (true = listed in the Deloitte US alliance directory, https://www.deloitte.com/us/en/alliances/deloitte-alliances.html). Filter with `deloitte_alliance=true`; mention it to the user when relevant.
6. Language: English by default; add `lang=tr` (or `Accept-Language: tr`) for Turkish text. MCP tools take `language`.
7. Metrics may be null (unknown). Add `include_unknown_metrics=true` to keep such products, and tell the user the value is unknown rather than guessing.
8. Always give the user the product `url` so they can verify.

## Endpoints

- [OpenAPI 3.1 spec](https://comparare.echoenes.dev/api/v1/openapi.json): full parameter reference
- [Filter vocabulary](https://comparare.echoenes.dev/api/v1/schema): category tree, feature slugs, enums
- [MCP server](https://comparare.echoenes.dev/mcp): Streamable HTTP MCP endpoint with tools search_products, list_categories, get_product, get_vendor, compare_products, find_alternatives
- [Human guide](https://comparare.echoenes.dev/agents)
- [Deloitte alliance partners](https://comparare.echoenes.dev/deloitte-alliances)

## Filters (GET /api/v1/products)

q, categories, category_mode (all|any), features, deloitte_alliance (true|false), pricing_models (free, freemium, subscription, one-time, usage-based, quote, open-source), free_plan, free_trial, open_source, deployment (cloud, on-premise, hybrid), platforms (web, windows, macos, linux, ios, android), languages (ISO 639-1, e.g. tr), segments (freelancer, small, mid, enterprise), industries (banking, insurance, healthcare, life-sciences, public-sector, energy, manufacturing, automotive, retail, tmt, transportation, education, nonprofit, real-estate, professional-services, cross-industry), hq_countries (ISO alpha-2), min_employees, max_employees, min_active_users, min_customers, include_unknown_metrics, min_rating, max_price + currency, founded_after, founded_before, sort (relevance, rating, popularity, employees, customers, active_users, price, name, newest), page, per_page (≤100).

## Category slugs

- sales (Sales): crm (CRM), sales-engagement (Sales Engagement), sales-intelligence (Sales Intelligence), cpq (CPQ & Quoting)
- marketing (Marketing): marketing-automation (Marketing Automation), email-marketing (Email Marketing), seo-tools (SEO Tools), social-media-management (Social Media Management), landing-page-builders (Landing Page Builders), customer-data-platform (Customer Data Platform (CDP))
- customer-service (Customer Service): help-desk (Help Desk), live-chat (Live Chat), customer-success (Customer Success), call-center (Contact Center & VoIP)
- finance (Finance & Accounting): accounting (Accounting), invoicing (Invoicing & Billing), subscription-management (Subscription Management), payment-processing (Payment Processing), expense-management (Expense Management), erp (ERP), financial-planning (Financial Planning & EPM), treasury-management (Treasury & Cash Management), tax-compliance (Tax & Compliance)
- hr (Human Resources): hris (HRIS), payroll (Payroll), recruiting (Recruiting (ATS)), performance-management (Performance Management), learning-management (Learning Management (LMS)), workforce-analytics (Workforce & Talent Intelligence)
- collaboration (Collaboration & Productivity): project-management (Project Management), team-communication (Team Communication), video-conferencing (Video Conferencing), file-sharing (File Sharing & Storage), knowledge-management (Notes & Knowledge Management), e-signature (E-Signature), document-management (Document & Content Management), digital-adoption (Digital Adoption Platforms)
- development (Software Development): devops (DevOps & Version Control), application-monitoring (Application Monitoring (APM)), cloud-platforms (Cloud Platforms), databases (Databases), low-code (Low-Code / No-Code), automation-integration (Automation & Integration (iPaaS)), rpa (Robotic Process Automation (RPA)), blockchain (Blockchain & Digital Assets)
- it-security (IT & Security): endpoint-security (Endpoint Security), identity-access-management (Identity & Access Management), password-managers (Password Managers), it-service-management (IT Service Management (ITSM)), remote-access (Remote Access & VPN), network-security (Network & Cloud Security), vulnerability-management (Vulnerability & Exposure Management), backup-recovery (Backup & Data Protection), grc (Governance, Risk & Compliance (GRC))
- ecommerce (E-Commerce): ecommerce-platforms (E-Commerce Platforms), marketplace-management (Marketplace Management), inventory-management (Inventory Management), pos (POS & Retail)
- analytics (Analytics & Data): business-intelligence (Business Intelligence (BI)), web-analytics (Web Analytics), product-analytics (Product Analytics), survey-tools (Surveys & Forms), data-platforms (Data Platforms & Warehousing), data-integration (Data Integration & Management)
- design-content (Design & Content): design-tools (Design Tools), website-builders (Website Builders), cms (Content Management (CMS))
- ai (Artificial Intelligence): ai-assistants (AI Assistants), ai-writing (AI Writing Tools), ai-platforms (AI & ML Platforms)
- operations (Operations & Supply Chain): supply-chain-planning (Supply Chain Planning), procurement (Procurement & Spend Management), warehouse-logistics (Warehouse & Logistics), plm-engineering (PLM, CAD & Engineering), asset-management (Asset & Field Service Management), gis-iot (GIS, IoT & Industrial)
- industry (Industry Solutions): banking-software (Banking & Core Banking), insurance-software (Insurance Software), healthcare-software (Healthcare & Life Sciences), legal-software (Legal & Contract Management)

## Feature slugs

a-b-testing, ai-features, api, audit-log, automation-workflows, bank-integration, calendar-integration, chatbot, custom-fields, custom-reports, dashboards, e-archive-tr, e-invoice-tr, e-ledger-tr, e-signature, email-integration, expense-tracking, file-versioning, gantt-charts, gdpr, hipaa, integrations-marketplace, inventory, iso27001, kanban, knowledge-base, kvkk, lead-scoring, marketplace-integration, mobile-app, multi-currency, multi-language, offline-mode, omnichannel, online-payments, open-source, payroll-processing, pipeline-management, quotes-proposals, recurring-billing, role-based-access, screen-sharing, segmentation, self-hosted, sla-management, soc2, sso, template-library, time-tracking, turkish-language, two-factor-auth, video-calls, webhooks, white-label, zapier-integration

## Rate limits

120 requests/min.