Skip to content

Mentions

Company mentions time series data.

Operations

Mentions time series

Request

Single-company mentions time series.

Security
authorization
Bodyapplication/jsonrequired

Mentions time series parameters

companyobjectrequired

Company identifier. Provide exactly one of id or domain.

Example:
{
  "domain": "microsoft.com"
}
filtersobject
Example:
{
  "mentions": {
    "ids": [ … ]
  }
}
max_mentionsinteger, [ 1 .. 50 ]
Default:20
Example:20
time_rangeobject
Example:
{
  "relative_range": "last_24m"
}
curl -i -X POST \
  https://api.hginsights.com/data-api/v2/companies/mentions/time-series \
  -H 'Authorization: Bearer <YOUR_API_KEY_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "company": {
      "domain": "walmart.com"
    },
    "filters": {
      "mentions": {
        "ids": [
          100
        ]
      }
    },
    "max_mentions": 20,
    "time_range": {
      "relative_range": "last_24m"
    }
  }'

Responses

Mentions time series results

Bodyapplication/json
companyobject
Example:
{
  "id": "E48EDEB162A5FBFDAF2DCF707079F8F",
  "name": "Walmart Inc."
}
mentionsArray of objects
Example:
[
  {
    "current_intensity": 72,
    "data_points": [ … ],
    "is_active": true,
    "mention_category_name": "Container Orchestration",
    "mention_id": 100,
    "mention_name": "Kubernetes"
  }
]
time_rangeobject
Example:
{
  "end": "2025-07",
  "start": "2023-07"
}
Response
{
  "company": {
    "id": "E48EDEB162A5FBFDAF2DCF707079F8F",
    "name": "Walmart Inc."
  },
  "mentions": [
    { … }
  ],
  "time_range": {
    "end": "2025-07",
    "start": "2023-07"
  }
}