Contents

API reference / Competitors

List competitors

GET /api/v1/projects/{project}/competitors

list_competitors Read MCP tool

Each competitor with its domain, handles, keywords and, over `days` (default 30), how many judged posts mention it, their sentiment and what the authors are doing: complaint, praise, alternative (leaving or asking for one), pricing or other.

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

Parameters

NameTypeDescription
project required
path
string The project's id.
days
query
integer
1–365

Example

curl "https://sniffington.com/api/v1/projects/{project}/competitors" \
  -H "Authorization: Bearer $SCOUT_API_KEY"