Displayable Content Export: Request Bazaarvoice Conversations data in bulk for public display using an HTTP interface.
1. Request Manifest File List
The Bazaarvoice Displayable Content Export (DCE) provides an HTTP interface for bulk requesting Bazaarvoice Conversations data intended for public display. To learn more, go to the DCE documentation home page.
Contents
The Displayble Content Export (DCE) workflow begins with a request for a manifest file list. Values in the list will be in the form of URL paths which will be used in the next step.
Request
Path
GET https://[stg.]api.bazaarvoice.com/dce/v3/data
Path tokens
Name | Description |
---|---|
[stg.] |
Optional subdomain indicating the request should use the non-production environment. Omit to use production. Learn more at the Reference section. |
Headers
Host: [stg.]api.bazaarvoice.com X-Bazaarvoice-Passkey: {DCE_PASSKEY} X-Bazaarvoice-Signature: {SIGNATURE} X-Bazaarvoice-Timestamp: {TIMESTAMP}
Refer to the Reference section for details on the headers and their values.
Access signature values
Replace the {SIGNATURE}
token above with the following string, encrypted using the algorithm described at Creating the Access Signature.
passkey={DCE_PASSKEY}×tamp={TIMESTAMP}
Replace the tokens above with the appropriate values as described below:
Name | Description |
---|---|
{DCE_PASSKEY} |
This is the same value communicated with the |
{TIMESTAMP} |
A Unix timestamp in milliseconds. This is the same value communicated by the ⚠ Using seconds or any increment other than milliseconds will cause your request to fail |
Response
Response will be a JSON object containing URL paths corresponding to available manifests. The following demonstrates a typical response:
{ "manifests": [ { "version": "v2", "fulls": [ { "date": "2017-07-31", "path": "/manifests/full/2017-07-31/v2/manifest.json" }, { "date": "2017-07-24", "path": "/manifests/full/2017-07-24/v2/manifest.json" }, { "date": "2017-07-17", "path": "/manifests/full/2017-07-17/v2/manifest.json" } ], "incrementals": [ { "date": "2017-07-31", "path": "/manifests/incremental/2017-07-31/v2/manifest.json" }, { "date": "2017-07-30", "path": "/manifests/incremental/2017-07-30/v2/manifest.json" }, { "date": "2017-07-28", "path": "/manifests/incremental/2017-07-28/v2/manifest.json" } ] } ] }
Full manifests contain all displayable Conversations data and are generated once a week. Use the most recently generated manifest to get a complete snapshot of your Conversations data.
Incremental manifests are generated in response to new and modified content over the previous 24 hour period. The absence of an incremental manifest for a particular period indicates that there is no new or updated content processed during that period.
The URL paths will be used in the next step.