> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tamradar.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Company Mentions

> Company Mentions documentation for TAMradar API.

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](/webhooks/overview) along with company-mentions-specific content:

```json theme={null}
{
  "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"
    }
  }
}
```
