Conversations API: Retrieve and submit consumer-generated content (CGC), and retrieve your product catalog and statistics about your CGC.
API Key Management
The Conversations API lets you programmatically retrieve and submit Bazaarvoice Conversations data for use in your applications. To learn more, go to the Conversations API documentation home page.
This page explains how to use the API Key Management application in the Bazaarvoice Portal to view and manage API keys.
Our key process allows any member of a client instance to request keys; however, they will not be able to use those keys until they are enabled. Through the use of the API Key Management app, designated technical administrators on the client side must take an active role in enabling the keys that have been requested for the client instance.
Accessing the API Key Management application
- Log on to Portal at https://portal.bazaarvoice.com.
If you do not have a Portal account, ask the Bazaarvoice account administrator listed in your Portal profile to create an account for you. To learn about Portal, refer to the Bazaarvoice knowledge base.
- Click the Portal menu and select Developer Tools under Administration.
- Your client instance must have API access. If your client instance does not have API access, contact your Bazaarvoice representative.
- Your Portal user account must have the Technical Contributor or Technical Administrator role assigned. Refer to the knowledge base for details about these roles. To verify your role assignment, contact the account administrator listed in your Portal profile.
- Your Portal user account must have the Ratings and Reviews solution assigned. Refer to the knowledge base for details about assigning solutions. To verify your role assignment, contact the account administrator listed in your Portal profile.
Learning about API key management permissions
Depending on your role in the Bazaarvoice Portal, your ability to view, edit, approve, or request keys will differ. Refer to the Bazaarvoice knowledge base to learn about the API key management actions each role can perform in the Bazaarvoice Portal.
- Use the filters to narrow down the list of keys based on API type, project name, status, etc.
- Use the search bar if you know the exact API key value to search for. You can use asterisks as wildcards. For example, searching for cAuS* returns all keys that begin with "cAuS". Note that search is case sensitive.
- Use the sort functionality to order the keys by project name, locked status, requester name, and other options.
- Click a key's project name to view detailed information about the key.
Enable or disable keys
When users request keys, the technical administrator for the account must approve the keys before they can be used. To approve keys as a technical administrator:
- Use the Key details > Status filter to narrow the list of keys to ones with a Pending state.
- Click the project name of a key to open its detailed view.
- Select Enable key.
- Click Save.
You can also disable keys from the detail view.
Request new keys
Refer to the Requesting API keys topic to learn how to request new API keys.