Contents

(+ show- hide)

Perform the following steps to request API keys:

Log on to the Bazaarvoice Portal

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.

Request API Keys via the API Key Management application

To complete the steps in this section, the following conditions must be true:
  • 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.
  1. Ensure you are logged on to Portal.
  2. Click the Portal menu and select Developer Tools under Administration.
  3. Click the Request API key button.
  4. Follow the instructions in the request form to request a new API key. After you submit the request, you receive an email summarizing the API key's details.
  5. Register your application with Bazaarvoice.
  6. Wait for a technical admin to approve your keys.

Register your application with Bazaarvoice

In order to receive your OAuth2 API passkeys, register your application by contacting our Support team at https://support.bazaarvoice.com.

Copy/paste the template below into your support case and then manually replace the <PLACE_HOLDER> tokens with the appropriate information or click here to use an interactive template generator and then copy/paste the completed template into your support case.

Refer to the table below for information about each value. All values are required.

Please register an application for use with the <API_NAME>

BAZAARVOICE PORTAL USER EMAIL ADDRESS: <EMAIL_ADDRESS>
DEVELOPER COUNTRY: <DEVELOPER_COUNTRY>
CLIENT INSTANCE NAMES: <NAME_1>, <NAME_2>, <NAME_N>

APP DISPLAY NAME: <DISPLAY_NAME>

APP DESCRIPTION:
<DESCRIPTION>

REDIRECT URIS:
<URI_1>
<URI_2>
<URN_N>

Thanks,

<SIGNATURE>
The name of the Bazaarvoice API you are requesting keys for.
The email address associated with your Bazaarvoice Portal account.
The country where the developer is located.
This name should match the client instance you want your keys to have access to. You can find client instance names in the Portal or Workbench client picker menu.
A human readable name that will be displayed to users when they grant access to you application.
A brief explanation of how this application will be used.
One or more complete URLs to a resource implemented by your application.
Cancel
Bazaarvoice API name

The name of the API you are requesting keys for, such as Response API or Privacy API.

Bazaarvoice Portal user email address

This is the email address associated with a Bazaarvoice Portal account. You must have an account prior to registering an application.

Developer country

The country where the developer is located.

Client instance names

This name should match the client instance you want your keys to have access to. You can find client instance names in the Portal or Workbench client picker menu.

Ex: acme-en_us, acme-fr_fr

App Display Name

This is a human readable name that will be displayed to users when they grant access to your application.

Ex: Acme Privacy App

App Description

A brief explanation of how this application will be used.

Ex: App for custom privacy regulations compliance dashboard.

Redirect URIs

One or more complete URLs to a resource implemented by your application. This is where the application will redirect to after it authenticates. One per line.

https://dev.example.com/privacy/app
https://stg.example.com/privacy/app
https://www.example.com/privacy/app

Wait for your technical administator to approve your keys

After you request keys, your company's technical administrator needs to approve your keys. Your keys are automatically created in a pending state until they are approved. You may check on the status of your request by viewing your list of keys in the API Key Management application in Portal.

Refer to the following topics to learn more: