{"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. Software plans with a price also carry `citation`: figure, plan, source page, read date and record URL in one line."}}}},"/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. Software plans with a price also carry `citation`: figure, plan, source page, read date and record URL in one line."}}}},"/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. Software plans with a price also carry `citation`: figure, plan, source page, read date and record URL in one line."}}}},"/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. Software plans with a price also carry `citation`: figure, plan, source page, read date and record URL in one line."}}}},"/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. Software plans with a price also carry `citation`: figure, plan, source page, read date and record URL in one line."}}}},"/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. Software plans with a price also carry `citation`: figure, plan, source page, read date and record URL in one line."}}}},"/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. Software plans with a price also carry `citation`: figure, plan, source page, read date and record URL in one line."}}}},"/api/v1/changes":{"get":{"operationId":"whatsChanged","summary":"Recent dated price changes, each cleared against two witnesses on two different hosts.","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. Software plans with a price also carry `citation`: figure, plan, source page, read date and record URL in one line."}}}},"/api/v1/price-history":{"get":{"operationId":"getPriceHistory","summary":"Full dated price series + derived stats for one product/vendor ('how much did X cost / did it drop').","parameters":[{"name":"slug","in":"query","description":"Product or vendor slug (required).","required":false,"schema":{"type":"string"}},{"name":"kind","in":"query","description":"Limit to 'hw' or 'sw'; omit to resolve across both.","required":false,"schema":{"type":"string","enum":["hw","sw"]}}],"responses":{"200":{"description":"Provenanced result; every figure carries source.url + accessedAt. Software plans with a price also carry `citation`: figure, plan, source page, read date and record URL in one line."}}}},"/api/v1/price-movers":{"get":{"operationId":"priceMovers","summary":"Recorded price moves across the index within a recency window (dated before→after), newest-and-largest first.","parameters":[{"name":"kind","in":"query","description":"Limit to 'hw' or 'sw'.","required":false,"schema":{"type":"string","enum":["hw","sw"]}},{"name":"category","in":"query","description":"Limit to one category/theme slug.","required":false,"schema":{"type":"string"}},{"name":"withinDays","in":"query","description":"Recency window in days (default 90).","required":false,"schema":{"type":"number"}},{"name":"limit","in":"query","description":"Max movers (default 25).","required":false,"schema":{"type":"number"}}],"responses":{"200":{"description":"Provenanced result; every figure carries source.url + accessedAt. Software plans with a price also carry `citation`: figure, plan, source page, read date and record URL in one line."}}}},"/api/v1/volatility":{"get":{"operationId":"getVolatility","summary":"0-100 price-volatility score + change stats for one entity; withheld (sufficient:false) below a minimum recorded-change threshold.","parameters":[{"name":"slug","in":"query","description":"Product or vendor slug (required).","required":false,"schema":{"type":"string"}},{"name":"kind","in":"query","description":"Limit to 'hw' or 'sw'.","required":false,"schema":{"type":"string","enum":["hw","sw"]}}],"responses":{"200":{"description":"Provenanced result; every figure carries source.url + accessedAt. Software plans with a price also carry `citation`: figure, plan, source page, read date and record URL in one line."}}}},"/api/v1/most-volatile":{"get":{"operationId":"mostVolatileInCategory","summary":"Entities in a category ranked by price volatility, plus the category price baseline.","parameters":[{"name":"category","in":"query","description":"Category/theme slug (required).","required":false,"schema":{"type":"string"}},{"name":"kind","in":"query","description":"Limit to 'hw' or 'sw'.","required":false,"schema":{"type":"string","enum":["hw","sw"]}},{"name":"limit","in":"query","description":"Max ranked entities (default 25).","required":false,"schema":{"type":"number"}}],"responses":{"200":{"description":"Provenanced result; every figure carries source.url + accessedAt. Software plans with a price also carry `citation`: figure, plan, source page, read date and record URL in one line."}}}},"/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. Software plans with a price also carry `citation`: figure, plan, source page, read date and record URL in one line."}}}},"/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. Software plans with a price also carry `citation`: figure, plan, source page, read date and record URL in one line."}}}},"/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. Software plans with a price also carry `citation`: figure, plan, source page, read date and record URL in one line."}}}},"/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. Software plans with a price also carry `citation`: figure, plan, source page, read date and record URL in one line."}}}},"/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. Software plans with a price also carry `citation`: figure, plan, source page, read date and record URL in one line."}}}},"/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. Software plans with a price also carry `citation`: figure, plan, source page, read date and record URL in one line."}}}}}}