Answer

Example

The following is a generalized example. Actual answers will vary based on configurations. Continue to the Fields section for information on each field.

{  
    "id":"003737df-7605-5119-b231-3f7c34ce51ac",  
    "type":"answer",  
    "client":"example-client",  
    "contentLocale":"en_US",  
    "helpfulVoteCount":0,  
    "notHelpfulVoteCount":0,  
    "authorLocation":"Austin, TX",  
    "lastModificationTime":"2015-08-24T01:30:05.959Z",  
    "legacyId":"2002796",  
    "submissionId":"qekz0odjlk8utw7y4n4ht8qtm",  
    "submissionTime":"2015-08-24T01:24:14.000Z",  
    "containedIn":[  
      {  
        "id":"21995596-15b6-5706-9a6f-bdf9f4e7187b",  
        "type":"question",  
        "client":"example-client"  
      }  
    ],  
    "contentCodes":[  
       "HMP"  
    ],  
    "contextDataValues":{  
      "Age":{  
         "id":"Age",  
         "value":"18to25"  
      }  
    },  
    "photos": [  
     {  
        "caption": "Green Soap",  
        "id": 12345,  
        "sizes": [  
           {  
              "size": "thumbnail",  
              "url": "https://.../bc7efdb8-49dc-5120-a768-c54fa09fe921"  
           },  
           {  
              "size": "medium",  
              "url": "https://.../bc7efdb8-49dc-5120-a768-c54fa09fs4da"  
           }  
        ]  
     },  
    ],  
    "photoUrls":[  
      "http://.../bc7efdb8-49dc-5120-a768-c54fa09fe921",  
      "http://.../bc7efdb8-49dc-5120-a768-c54fa09fs4da"  
    ],  
    "tagDimensions":{  
      "Topic1":{  
         "id":"Topic",  
         "values":[  
            "Vestibulum lobortis, diam a",  
            "Morbi a sapien non lectus fringillamole",  
         ]  
      }  
    },  
    "authorReference":{  
      "id":"5d22d0e2-32ab-531e-9850-1229ea48f322",  
      "type":"author",  
      "client":"example-client"  
    },  
    "additionalFields":{  
      "children":{  
        "id":"children",  
        "value":"1"  
      },  
      "sku":{  
        "id":"sku",  
        "value":"Cos7j_7"  
      }  
    },  
    "userNickname":"cupcake",  
    "isFeatured":false,  
    "campaignId":"BV_ANSWER_DISPLAY",  
    "answerText":"Per conubia nostra, per inceptos himenaeos. Etiam vel pellentesque enim. Quisque rutrum eros ut sapien posuere ornare. Quisque vulputate ac diam eu scelerisque. Integer volutpat felis sed aliquam ornare.",  
    "videos":[{  
      "caption":"see it in action",  
      "rawUrlInput":"http://youtu.be/KeIDiddsjR0",  
      "videoHost":"www.youtube.com",  
      "videoId":"KeIDiddsjR0"  
    }]  
  }

Relationships

Author

An answer will only have a single author. This relationship is maintained on the answer using the Author reference field.

The following diagram depicts the relationship between an answer and an author:

Question

An answer will only relate to a single question. This relationship is maintained on the answer using the Contained in field.

The following diagram depicts the relationship between an answer and a question:

Fields

Additional fields

"additionalFields":{  
  "children":{  
    "id":"children",  
    "value":"1"  
  },  
  "sku":{  
    "id":"sku",  
    "value":"Cos7j_7"  
  }  
}

Additional fields accept arbitrary free text information. Values can come from the author or may be information related to the content (custom IDs, internal tracking numbers, etc.).

📘

Additional configurations are available for this field.

🚧

This is a free text field submitted by the author. Always escape it appropriately for the intended environment before displaying it.

Answer text

"answerText":"Per conubia nostra, per inceptos himenaeos..."

The main text content of the submission.

🚧

This is a free text field submitted by the author. Always escape it appropriately for the intended environment before displaying it.

Author location

"authorLocation":"Austin, TX"

Free text field submitted by the author. This value is not guaranteed to be in a standardized format.

🚧

This is a free text field submitted by the author. Always escape it appropriately for the intended environment before displaying it.

Author reference

"authorReference":{  
  "id":"1f6ef1dd-7c6b-5a70-a9e2-c03a18a31849",  
  "type":"author",  
  "client":"example-client"  
}

Information about the content author. Refer to the Relationships section in this document to learn how to join an author reference with an author.

Campaign ID

"campaignId":"BV_ANSWER_DISPLAY",

Campaign ID is a text string identifying the action that originated the content.

Client

"client":"example-client"

The client from where this content originates. The source client.

📘

If this value is not your client name, then this content has been syndicated to you from the client identified.

Contained in

"containedIn":[  
  {  
    "id":"21995596-15b6-5706-9a6f-bdf9f4e7187b",  
    "type":"question",  
    "client":"example-client"  
  }  
],

Information about the question to which this answer relates. Refer to the Relationships section in this document to learn how to join an answer to it's related question.

Content codes

"contentCodes":[  
    "HMP"  
  ]

Codes assigned by Bazaarvoice moderators. For a list of possible codes refer to Moderator codes for content in the Conversations API documentation.

Content locale

"contentLocale":"en_US",

The locale code associated with this content.

Context data values

"Age":{  
  "id":"Age",  
  "value":"18to25"  
}

Context data values (CDV) are the answers to multi-select questions about the author. For example, the author's age when the content was written.

📘

Additional configurations are available for this field.

Helpful vote count

"helpfulVoteCount":0,

The count of users who indicated the content was helpful.

ID

"id":"003737df-7605-5119-b231-3f7c34ce51ac"

Universally unique value identifying item. This ID is generated by Bazaarvoice.

Is featured

"isFeatured":false

Indicates the content should highlighted to consumers, typically by sorting the featured content to the top and applying a badge or other graphic indicator.

Last modification time

"lastModificationTime":"2015-08-24T01:30:05.959Z"

When this content was most recently modified.

Legacy ID

"legacyId":"2002796"

This identifier is used in the Bazaarvoice portal (AKA: Workbench) and standard export feeds. It is not guaranteed to be unique across clients.

Not helpful vote count

"notNelpfulVoteCount":0

The count of users who indicated the content was not helpful.

Photos

"photos": [  
   {  
      "caption": "Green Soap",  
      "id": 12345,  
      "sizes": [  
         {  
            "size": "thumbnail",  
            "url": "https://.../bc7efdb8-49dc-5120-a768-c54fa09fe921"  
         },  
         {  
            "size": "medium",  
            "url": "https://.../bc7efdb8-49dc-5120-a768-c54fa09fs4da"  
         }  
      ]  
   },  
],

A list of author-submitted photos to be displayed with the content. Each photo includes a unique identifier and a sizes array. The photos might include a caption describing the image if one was specified during submission. The sizes array contains objects with the URLs to the available images, separated by size. Refer to the Photo Upload topic in the Conversations API documentation for information about photo sizes.

Photo URLs

"photoUrls":[  
  "http://.../bc7efdb8-49dc-5120-a768-c54fa09fe921",  
  "http://.../bc7efdb8-49dc-5120-a768-c54fa09fs4da"  
],

This field has been deprecated in favor of the [photos](#photos) field. While photoUrls is still included in the dataset to support existing dependencies, Bazaarvoice recommends using the photos field.

Submission ID

"submissionId":"qekz0odjlk8utw7y4n4ht8qtm"

The unique identifier assigned to content (for example, to an answer) when it was submitted. This ID exists only on native content generated on your site. It does not exist on syndicated content or on native content generated through a manual import.

Submission time

"submissionTime":"2015-08-24T01:24:14.000Z"

When the content was submitted.

Tag dimensions

"tagDimensions":{  
  "Topic1":{  
     "id":"Topic",  
     "values":[  
        "Vestibulum lobortis, diam a",  
        "Morbi a sapien non lectus fringillamole",  
     ]  
  }  
}

Tag dimensions identify the different attributes of a product. Depending on configuration, authors can express sentiment by selecting from predefined tags or by creating their own tags at submission time.

📘

Additional configurations are available for this field.

🚧

This is a free text field submitted by the author. Always escape it appropriately for the intended environment before displaying it.

Type

"type":"answer"

The content type.

User nickname

"userNickname":"cupcake"

Public display name chosen by the author. If this value is absent, you should look for the displayName field on the associated author record.

Videos

Information about videos associated with the content. Bazaarvoice supports the following video styles:

Third party video linking

With this style, consumers can link to videos hosted on other platforms. Currently only YouTube is supported.

"videos":[{  
  "caption":"see it in action",  
  "rawUrlInput":"http://youtu.be/KeIDiddsjR0",  
  "videoHost":"www.youtube.com",  
  "videoId":"KeIDiddsjR0"  
}]

See YouTube's developer documentation for more information on YouTube's current methods for displaying YouTube hosted video.

Bazaarvoice hosted video

With this style, consumers can upload video files directly to Bazaarvoice when submitting content. Videos will be hosted and served by Bazaarvoice.

"videos":[{  
  "VideoId": "9d637b22-fff8-aad7-4841-356422b9fb41",  
  "VideoHost": "BAZAARVOICE",  
  "VideoThumbnailUrl": "https://d32knfnyyqt5ha.cloudfront.net/9d637b22-fff8-aad7-4841-356422b9fb41/thumbnail/image-00001.png",  
  "VideoIframeUrl": null,  
  "Caption": "see it in action",  
  "VideoUrl": "https://d32knfnyyqt5ha.cloudfront.net/9d637b22-fff8-aad7-4841-356422b9fb41/video/movie.mp4" 
}]