Track brand mentions

Experimental. We’re exploring this monitoring feature. The endpoint and payloads below are drafts and aren’t available in the live Waterfall API.

See who’s talking about your developer product and what they’re saying. Read the original post, then decide whether to answer a question, share feedback with your team, or research the account.

Proposed endpoint

POST /v1/monitoring/company-mentions

Example setup

{
  "domain": "your-devtool.example",
  "profile_url": "https://www.linkedin.com/company/your-devtool-example",
  "webhook_url": "https://your-app.example/webhooks/waterfall",
  "custom_fields": {
    "source": "brand-monitoring",
    "account_id": "acct_208"
  }
}

Start with your brand’s domain. You can also provide a LinkedIn company URL to help identify it. This draft does not support LinkedIn-only setup. We still need to confirm which channels the Waterfall offering will cover.

Example finding content

A fictional example, focused on the content object:

{
  "mention_content": "We are testing YourDevTool for tracing API requests across services. Has anyone used it with OpenTelemetry?",
  "mention_url": "https://social.example/posts/devtool-discussion-1042",
  "mention_channel": "Twitter",
  "mention_posted_at": "2026-09-28",
  "author": {
    "name": "James Lee",
    "profile_type": "contact",
    "first_name": "James",
    "last_name": "Lee",
    "profile_url": "https://www.linkedin.com/in/james-lee-example",
    "title": "Senior Platform Engineer",
    "company_domain": "northstar.example",
    "company_name": "Northstar",
    "country": "United States"
  }
}

We may not be able to identify every author. Some mentions may have no professional profile or employer details.

Use it in your workflow

Read the original mention before classifying it. Route a technical question to the right team, review product feedback, or enrich the author’s company when a usable domain is available. A mention alone does not establish interest in a sales conversation. See the brand-mention alerts workflow →

Start here

Use cases

Signups & accounts

Find your buying team

Visitors & existing users

Monitoring

Integration essentials

Proposed endpoint

Example setup

Example finding content

Use it in your workflow

​Proposed endpoint

​Example setup

​Example finding content

​Use it in your workflow

Proposed endpoint

Example setup

Example finding content

Use it in your workflow