Company Mentions

Notifies you when social media posts, articles, or other content mentions your tracked companies. This radar type helps you monitor brand presence and sentiment across various platforms.

Content Structure

The content object for company mentions contains:

Note: The author object now includes detailed structured fields. The name field is maintained for backward compatibility and is automatically constructed from first_name + last_name when available.

Field	Type	Required	Description
mention_content	string	Yes	Text content of the post or article
mention_url	string	Yes	URL to the original post or article
mention_channel	string	Yes	Platform or source (e.g., Twitter, LinkedIn)
mention_posted_at	string	Yes	Best estimated date of the mention (YYYY-MM-DD)
author	object	No	Information about the author of the mention

Author Object

Field	Type	Required	Description
name	string	No	Full name of the author (constructed from first_name + last_name when available)
profile_type	string	No	Type of profile: `"contact"` or `"company"`
first_name	string	No	Author’s first name - `null` if `profile_type` is `"company"`
last_name	string	No	Author’s last name - `null` if `profile_type` is `"company"`
profile_url	string	No	URL to the author’s profile
title	string	No	Author’s job title - `null` if `profile_type` is `"company"`
company_domain	string	No	Domain of the author’s company
company_name	string	No	Name of the author’s company
country	string	No	Author’s country location

Example

This example includes base webhook fields along with company-mentions-specific content:

{
  "update_id": "41991828-ed31-4bd9-98d2-44b2763f9f35",
  "update_type": "radar_finding",
  "record_id": "b77af154-c369-4446-b70a-f328880c3a48",
  "discovered_at": "2024-03-19T10:15:30Z",
  "data": {
    "radar_id": "c70813b3-7e87-4ca7-90fd-8c64574d911b",
    "radar_type": "company_mentions",
    "domain": "domain.com",
    "next_charge_at": "2024-04-20T16:10:00Z",
    "custom_fields": {
      "priority": "high",
      "account_id": "0011U00000TFV7MQAX"
    }
  },
  "content": {
    "mention_content": "@PrifWeinidog @DomainAI Can you confirm that you are not going to knock down statues of white men that have greatly contributed to history because it's has been reported on X that this is in your government's plan. If this is true it is an utter disgrace",
    "mention_url": "https://twitter.com/Catheri86555691/status/1902104771068125631",
    "mention_channel": "Twitter",
    "mention_posted_at": "2024-03-18",
    "author": {
      "name": "Joe Doe",
      "profile_type": "contact",
      "first_name": "Joe",
      "last_name": "Doe",
      "profile_url": "https://www.linkedin.com/in/joedoe",
      "title": "Director of Sales",
      "company_domain": "abc.com",
      "company_name": "ABC Corporation",
      "country": "United States"
    }
  }
}

Introduction / Overview

Getting Started

Core Guides

Agentic Setup

API Reference

Bulk

Webhooks

Content Structure

Author Object

Example

​Content Structure

​Author Object

​Example

Content Structure

Author Object

Example