TrustRadius customers with intent data included in their subscription are able to access TrustRadius’ intent API to get intent data about buyers researching your products, competitor products, and your categories.
The intent API provides information about 1) the companies showing intent and 2) the intent activities performed by those companies. Reach out to your Customer Success Manager or submit a support ticket to learn how to operationalize TrustRadius intent with your systems and processes.
To call the API, you will need your TrustRadius API key. See the article, Accessing your TrustRadius API key. You can learn more about this API, the query parameters it accepts, and the information included in the response in our Intent API Documentation.
The below guide is meant to help you understand the definitions of the fields provided in the API response.
| Field | Field Definition |
Activity Date | Date an intent activity took place. |
Account Name | Name of the account identified that is showing intent. |
Account Domain | Domain (website) of the account showing intent. |
| Account ID | TrustRadius' ID of the account showing intent. |
Account Description | Description of the account showing intent. |
Account Annual Revenue | Annual revenue (public companies only) of the account showing intent. |
Account Size | Employee headcount of the account showing intent. |
Account Sector | Broad sector of the account showing intent. See possible values here. |
Account Industry | Industry of the account showing intent. See possible values here. |
Account Sub-industry | Sub-industry of the account showing intent. See possible values here. |
| Account SIC Code | Standard Industrial Classifcation (SIC) code of the account showing intent. Learn more here. |
| Account City | Account headquarters city name. |
Account State | Account headquarters state name. |
Account State Code | Account headquarters state code. |
Account Country | Account headquarters country name. |
Account Country Code | Account headquarters country code. Learn more here. |
Account Postal Code | Account headquarters postal code. |
| Account LinkedIn ID | Account LinkedIn ID/URL. |
Account Facebook | Account Facebook ID. |
Account Twitter | Account Twitter screen name. |
Account Visitors Count | Number of total unique visitors from the Account in the requested date range. |
Activity ID | TrustRadius' ID of an individual activity. |
Activity Source | Describes why an intent activity is included in a customer’s dataset. Possible values are Licensed Product, Category, and Competitors. -If the activity includes the customer’s product, Activity Source = Licensed Product. -If the activity includes one of the customer’s name competitors, Activity Source = Competitors. -If the activity includes the Category itself, or a product in the Category the customer has purchased, Activity Source = Category. |
Activity Type | The type of action taken by the account visitor. Possible values include view, click, share, save, download. |
Activity Label | The subject or page engaged with for an intent activity (i.e. Product Listing, Comparison, Review). |
Activity Description | Human readable description of an intent activity. |
Activity URL/Page | URL for the page on TrustRadius that was engaged with in an intent activity. |
Visitor City | City name of the individual visitor who completed an intent activity. |
Visitor State | State name of the individual visitor who completed an intent activity. |
Visitor State Code | State code of the individual visitor who completed an intent activity. |
Visitor Country | Country name of the individual visitor who completed an intent activity. |
Visitor Country Code | Country code of the individual visitor who completed an intent activity. |
Object 1 Name | Name of the Object of an intent activity. Possible values are a product name or a category name. For Comparison activities, there will be multiple Object fields. |
Object 1 ID | TrustRadius' ID for Object 1. For Comparison activities, there will be multiple Object fields. |
Object 1 Type | The type of Object of an intent activity. Possible values are Product or Category. For Comparison activities, there will be multiple Object fields. |
Object 1 Category | The Category the Object of an intent activity is associated with. For a product, this is the product’s primary category on TrustRadius. For a category, the Object Category will be the same as the Object Name. For Comparison activities, there will be multiple Object fields. |
Object 1 Vendor | The Vendor the Object of an intent activity is associated with. Only applicable when Object Type = Product. For Comparison activities, there will be multiple Object fields. |