Docs
Build with Soundev
Everything you need to get mentions into your tools: the REST API, signed webhooks, the MCP server and CRM integrations.
Quickstart
Sign up, describe your company, and add your brand, competitors and the problems you solve as keywords. Soundev starts checking 29 sources straight away (podcasts too on Scale), and reads the comment threads under the posts it finds on YouTube, LinkedIn, TikTok and Instagram. Open a brand or competitor keyword to connect its review pages on G2, Trustpilot, the App Store, Google Play and Product Hunt; Soundev finds them for you.
Every mention is scored for relevance, intent, sentiment and fit with your ideal customer. Save filters as feeds, send feeds to Slack, email or a webhook under Alerts, and send single mentions to HubSpot, Attio or Linear.
REST API
Create a key under Settings → API keys (the REST API and the MCP server are on every paid plan). Read-only keys can list and fetch; keys with write access can also update mentions and add keywords. Send the key as a bearer token. Each key can make 120 requests a minute.
curl https://soundev.com/api/v1/mentions?relevance=high&tags=buy_intent \
-H "Authorization: Bearer sdv_…"| Method and path | What it does |
|---|---|
| GET /api/v1/mentions | Newest first. Filters: platforms, relevance, sentiment, tags, keyword_ids, keyword_types, q, since, engaged, include_filtered, limit (1–200), cursor. |
| GET /api/v1/mentions/{id} | One mention with its scores, reason, reply draft and keywords. |
| PATCH /api/v1/mentions/{id} | Write key. Body: engaged, bookmarked, feedback (relevant, not_relevant or null). |
| GET /api/v1/keywords | Tracked keywords with type, health and 30-day stats. |
| POST /api/v1/keywords | Write key. Body: term, type (brand, competitor, industry or problem). |
| GET /api/v1/feeds | Saved feeds and their filters. |
| GET /api/v1/usage | Plan, keywords and mentions used this month. |
| GET /api/v1/analytics | Volume, sentiment, sources and share of voice. days: 7, 14, 30, 60 or 90. |
| POST /api/v1/mentions/{id}/send | Write key. Body: to (hubspot, attio or linear). Creates a deal, task or issue once. |
Lists return { data, next_cursor }; pass next_cursor back as cursor for the next page. Errors return { error: { code, message } } with the HTTP status: 400 bad input, 401 bad key, 403 plan or read-only key, 404 not found, 429 rate limit.
Webhooks
Under Alerts, send any feed to an https URL. Each new mention arrives as a POST with type mention.created, the feed, and the mention in the same shape as the API. Soundev waits 8 seconds for a 2xx answer; failed deliveries are retried on the next pass, and an alert pauses after 10 failures in a row.
Every request is signed. The Soundev-Signature header holds a timestamp and an HMAC-SHA256 of "timestamp.body" made with the alert's signing secret (shown under the alert). Check it before trusting the payload:
import { createHmac, timingSafeEqual } from "node:crypto";
export function verify(body: string, header: string, secret: string) {
const { t, v1 } = Object.fromEntries(header.split(",").map((p) => p.split("=")));
const expected = createHmac("sha256", secret).update(`${t}.${body}`).digest("hex");
const fresh = Math.abs(Date.now() / 1000 - Number(t)) < 300;
return fresh && timingSafeEqual(Buffer.from(expected), Buffer.from(v1));
}MCP server
On every plan, agents read and act on your mentions through the Model Context Protocol. Add https://soundev.com/api/mcp as a remote MCP server in Claude, ChatGPT, Cursor or any client; it opens Soundev to sign in and asks which workspace to connect (OAuth 2.1 with PKCE). Members connect read-only; owners and admins can also allow changes. See and disconnect agents under Settings → API keys. Ready-made prompts are in the playbooks library at /playbooks.
Tools: search_mentions, get_mention, update_mention, send_mention (HubSpot, Attio or Linear), get_analytics, list_keywords, add_keyword, list_feeds and get_usage. Nothing can post publicly. Clients without sign-in can send an API key instead:
{
"mcpServers": {
"soundev": {
"type": "http",
"url": "https://soundev.com/api/mcp",
"headers": { "Authorization": "Bearer sdv_…" }
}
}
}HubSpot, Attio and Linear
Connect each tool under Settings → Integrations with a token you create in that tool (the page lists the exact scopes). Then every mention has a Send to button: HubSpot gets a deal in your first deal pipeline, Attio a follow-up task, Linear an issue in the team you choose. The mention keeps a link to what was created. Tokens are stored encrypted.