API Reference

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.

FieldTypeRequiredDescription
mention_contentstringYesText content of the post or article
mention_urlstringYesURL to the original post or article
mention_channelstringYesPlatform or source (e.g., Twitter, LinkedIn)
mention_posted_atstringYesBest estimated date of the mention (YYYY-MM-DD)
authorobjectNoInformation about the author of the mention

Author Object

FieldTypeRequiredDescription
namestringNoFull name of the author (constructed from first_name + last_name when available)
profile_typestringNoType of profile: "contact" or "company"
first_namestringNoAuthor's first name - null if profile_type is "company"
last_namestringNoAuthor's last name - null if profile_type is "company"
profile_urlstringNoURL to the author's profile
titlestringNoAuthor's job title - null if profile_type is "company"
company_domainstringNoDomain of the author's company
company_namestringNoName of the author's company
countrystringNoAuthor's country location

Example

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

{
  "event_id": "41991828-ed31-4bd9-98d2-44b2763f9f35",
  "event_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"
    }
  }
}
{
  "event_id": "41991828-ed31-4bd9-98d2-44b2763f9f35",
  "event_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": "company",
      "first_name": null,
      "last_name": null,
      "profile_url": "https://www.linkedin.com/company/abccorp",
      "title": null,
      "company_domain": "abc.com",
      "company_name": "ABC Corporation",
      "country": "United States"
    }
  }
}