Contents

API reference / Insights

Why customers leave a rival

GET /api/v1/insights/leave-reasons

get_leave_reasons Read MCP tool

For product marketers: for each rival (or the one you name), the posts from people leaving it or complaining about it in the last `days` (default 30), grouped by the reason their words give (price, bugs and reliability, support, missing features, complexity, speed, integrations, privacy, contract, direction), each reason with its count, the number of different people and real quotes with links. Grouped by a fixed list of words, not a model, so it costs nothing and cannot invent a quote; `unplaced` counts the posts whose words give no reason.

Any API key or OAuth token, or a signed-in member.

Parameters

NameTypeDescription
competitor
query
string A rival's name or id. Omit for every rival.
project
query
string Only this project's rivals.
days
query
integer
1–90

Returns

{ data: [{ rival, considered, switching, unplaced, themes: [{ theme, label, count, people, share, posts }], line }] }

Example

curl "https://sniffington.com/api/v1/insights/leave-reasons" \
  -H "Authorization: Bearer $SCOUT_API_KEY"