{"openapi":"3.1.0","info":{"title":"The Front Desk Review — Pricing & Specs API","version":"1.0.0","description":"Independent, sourced pricing & capability data on 200+ software/SaaS categories and 90+ consumer-hardware categories. Every record returns its source URL and capture date; a null is returned instead of a guessed number. Read-only, no key required.","contact":{"url":"https://frontdeskreview.com/connect"}},"servers":[{"url":"https://mcp.frontdeskreview.com"}],"paths":{"/api/v1/sections":{"get":{"operationId":"listSections","summary":"List all software/SaaS pricing themes.","parameters":[],"responses":{"200":{"description":"Provenanced result; every figure carries source.url + accessedAt."}}}},"/api/v1/coverage":{"get":{"operationId":"getCoverage","summary":"What the index covers — counts, split, date range, gaps.","parameters":[],"responses":{"200":{"description":"Provenanced result; every figure carries source.url + accessedAt."}}}},"/api/v1/search":{"get":{"operationId":"searchVendors","summary":"Free-text search a theme's vendors.","parameters":[{"name":"q","in":"query","description":"Free-text query across name, domain, integrations, plan notes.","required":false,"schema":{"type":"string"}},{"name":"section","in":"query","description":"Theme/section slug from /api/v1/sections (e.g. crm-software).","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Provenanced result; every figure carries source.url + accessedAt."}}}},"/api/v1/best":{"get":{"operationId":"findBest","summary":"Rank a theme's vendors by entry price with verified fact filters.","parameters":[{"name":"section","in":"query","description":"Theme/section slug from /api/v1/sections (e.g. crm-software).","required":false,"schema":{"type":"string"}},{"name":"requireHipaa","in":"query","description":"Only vendors with confirmed HIPAA support.","required":false,"schema":{"type":"boolean"}},{"name":"requireSoc2","in":"query","description":"Only vendors with a confirmed SOC 2 attestation.","required":false,"schema":{"type":"boolean"}},{"name":"requireGdpr","in":"query","description":"Only vendors with confirmed GDPR compliance.","required":false,"schema":{"type":"boolean"}},{"name":"requireFreeTier","in":"query","description":"Only vendors with a genuine $0 forever plan.","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"description":"Provenanced result; every figure carries source.url + accessedAt."}}}},"/api/v1/pricing":{"get":{"operationId":"getNormalizedPricing","summary":"Effective monthly cost per vendor at a chosen call volume.","parameters":[{"name":"callsPerMonth","in":"query","description":"Monthly call volume to normalize to (required).","required":false,"schema":{"type":"number"}},{"name":"avgCallMinutes","in":"query","description":"Average call minutes (default 3).","required":false,"schema":{"type":"number"}},{"name":"section","in":"query","description":"Theme/section slug from /api/v1/sections (e.g. crm-software).","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Provenanced result; every figure carries source.url + accessedAt."}}}},"/api/v1/compare":{"get":{"operationId":"compareVendors","summary":"Compare specific vendors side by side.","parameters":[{"name":"slugs","in":"query","description":"Comma-separated vendor slugs (e.g. nordvpn,expressvpn).","required":false,"schema":{"type":"string"}},{"name":"section","in":"query","description":"Theme/section slug from /api/v1/sections (e.g. crm-software).","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Provenanced result; every figure carries source.url + accessedAt."}}}},"/api/v1/benchmark":{"get":{"operationId":"getBenchmark","summary":"Per-vendor benchmark card.","parameters":[{"name":"slug","in":"query","description":"Vendor slug (required).","required":false,"schema":{"type":"string"}},{"name":"section","in":"query","description":"Theme/section slug from /api/v1/sections (e.g. crm-software).","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Provenanced result; every figure carries source.url + accessedAt."}}}},"/api/v1/changes":{"get":{"operationId":"whatsChanged","summary":"Recent dated, two-source-corroborated price changes.","parameters":[{"name":"since","in":"query","description":"Only changes on/after this ISO date (YYYY-MM-DD).","required":false,"schema":{"type":"string"}},{"name":"section","in":"query","description":"Theme/section slug from /api/v1/sections (e.g. crm-software).","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Provenanced result; every figure carries source.url + accessedAt."}}}},"/api/v1/product-categories":{"get":{"operationId":"listProductCategories","summary":"List spec-driven hardware categories.","parameters":[],"responses":{"200":{"description":"Provenanced result; every figure carries source.url + accessedAt."}}}},"/api/v1/products/search":{"get":{"operationId":"searchProducts","summary":"Free-text search a hardware category.","parameters":[{"name":"category","in":"query","description":"Hardware category slug from /api/v1/product-categories (e.g. laptops).","required":false,"schema":{"type":"string"}},{"name":"q","in":"query","description":"Free-text query across name, brand, spec values.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Provenanced result; every figure carries source.url + accessedAt."}}}},"/api/v1/products/find":{"get":{"operationId":"findProducts","summary":"Filter & rank a hardware category by price/brand/spec.","parameters":[{"name":"category","in":"query","description":"Hardware category slug from /api/v1/product-categories (e.g. laptops).","required":false,"schema":{"type":"string"}},{"name":"maxPriceUsd","in":"query","description":"Only products at or below this USD price.","required":false,"schema":{"type":"number"}},{"name":"brand","in":"query","description":"Only products from this brand.","required":false,"schema":{"type":"string"}},{"name":"sortBy","in":"query","description":"Rank by 'priceUsd' (default), 'releaseDate', or a spec key.","required":false,"schema":{"type":"string"}},{"name":"descending","in":"query","description":"Rank largest/newest first.","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"description":"Provenanced result; every figure carries source.url + accessedAt."}}}},"/api/v1/products/compare":{"get":{"operationId":"compareProducts","summary":"Compare specific products side by side.","parameters":[{"name":"category","in":"query","description":"Hardware category slug from /api/v1/product-categories (e.g. laptops).","required":false,"schema":{"type":"string"}},{"name":"slugs","in":"query","description":"Comma-separated product slugs.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Provenanced result; every figure carries source.url + accessedAt."}}}},"/api/v1/decoders":{"get":{"operationId":"listCostDecoders","summary":"List 'real cost' decoders — topics where the sticker price hides the true bill (e.g. AI customer support billed per resolution).","parameters":[],"responses":{"200":{"description":"Provenanced result; every figure carries source.url + accessedAt."}}}},"/api/v1/decoder":{"get":{"operationId":"getCostDecoder","summary":"The real all-in monthly cost per vendor for a decoder topic, computed from sourced/dated inputs with the arithmetic shown; quote-only inputs return null, never a guess.","parameters":[{"name":"topic","in":"query","description":"Decoder slug from /api/v1/decoders (e.g. ai-customer-support-cost).","required":false,"schema":{"type":"string"}},{"name":"agents","in":"query","description":"Optional: agents/seats for a custom scenario.","required":false,"schema":{"type":"number"}},{"name":"resolutions","in":"query","description":"Optional: AI resolutions/mo for a custom scenario.","required":false,"schema":{"type":"number"}}],"responses":{"200":{"description":"Provenanced result; every figure carries source.url + accessedAt."}}}}}}