Skip to content

Get Company Intent Signals

Request

Returns intent signals for a known company. Combines HG topic-based intent and TrustRadius buyer-intent activities. Provide the company by id (hex-encoded) or domain. All filters are optional.

Security
authorization
Bodyapplication/jsonrequired

Intent Request

companyobjectrequired

Company identifier. Provide exactly one of id or domain.

Example:
{ "domain": "microsoft.com" }
fieldsArray of strings

Which response sections to include.

Default:["summary","topics","activities"]
Items Enum:"summary""topics""activities"
Example:
[ "summary", "topics", "activities" ]
filtersobject

Optional filters to narrow intent results.

Example:
{ "activities": { "product_category_ids": [ … ] }, "signal_date": { "max": "2026-12-31", "min": "2023-01-01" }, "topics": { "buyers_journey_names": [ … ], "context_type_names": [ … ], "signal_level": [ … ] }, "vendor_ids": [ 311 ] }
limitinteger, [ 1 .. 200 ]

Maximum number of records per section

Default:50
Example:50
offsetinteger, >= 0

Number of records to skip per section

Default:0
Example:0
curl -i -X POST \
  https://api.hginsights.com/data-api/v2/intent/enrich \
  -H 'Authorization: Bearer <YOUR_API_KEY_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "company": {
      "domain": "microsoft.com"
    },
    "fields": [
      "summary",
      "topics",
      "activities"
    ],
    "filters": {
      "signal_date": {
        "max": "2026-12-31",
        "min": "2023-01-01"
      },
      "topics": {
        "signal_level": [
          "HIGH"
        ]
      },
      "vendor_ids": [
        311
      ]
    },
    "limit": 50,
    "offset": 0
  }'

Responses

Intent Response

Bodyapplication/json
activitiesobject or null

TrustRadius buyer intent activities with total count.

Example:
{ "count": 3, "data": [ { … } ] }
companyobject or nullrequired

Resolved company information.

Example:
{ "domain": "microsoft.com", "id": "1698C53EBC888758570396E0334965C1", "name": "Microsoft" }
summaryobject or null

Aggregate summary computed from the fetched signals.

Example:
{ "active_topics_count": 5, "high_signal_topics_count": 2, "latest_signal_date": "2025-06-15", "sources": { "hg": 5, "trustradius": 3 }, "top_context_types": { "Displacement": 3, "Whitespace": 1 } }
topicsobject or null

HG topic intent signals with total count.

Example:
{ "count": 5, "data": [ { … } ] }
Response
{ "activities": { "count": 3, "data": [ … ] }, "company": { "domain": "microsoft.com", "id": "1698C53EBC888758570396E0334965C1", "name": "Microsoft" }, "summary": { "active_topics_count": 5, "high_signal_topics_count": 2, "latest_signal_date": "2025-06-15", "sources": { … }, "top_context_types": { … } }, "topics": { "count": 5, "data": [ … ] } }