Retrieve data in Microdata
This section provides sample request to retrieve structured data in Microdata format.
To retrieve data in the Microdata format, send text/html in the Accept request header.
Sample Request
curl --location 'https://seo.bazaarvoice.com/structured-data/v1/clients/testcustomer-fast-prs/ugc?locale=en_US&productId=product1' \
--header 'Accept: text/html' \
--header 'User-Agent: Java-http-client/17.0.7' \
--header 'Bv-Forwarded-User-Agent: Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko); compatible; GPTBot/1.1; +https://openai.com/gptbot' \
--header 'bv-passkey: <PASSKEY>'Sample Response
<div>
<!-- Aggregate Rating -->
<div itemscope itemtype="https://schema.org/AggregateRating">
<meta itemprop="bestRating" content="5" />
<meta itemprop="ratingValue" content="3.4320546163849155" />
<meta itemprop="reviewCount" content="3076" />
</div>
<!-- Reviews -->
<div itemscope itemtype="https://schema.org/Review">
<meta itemprop="dateCreated" content="2026-03-30T10:42:36.000+00:00" />
<meta itemprop="datePublished" content="2026-03-30T10:45:44.000+00:00" />
<span itemprop="name">Review title</span>
<span itemprop="reviewBody">This is my positive review about this poor product</span>
<!-- additionalProperty -->
<div itemprop="additionalProperty" itemscope itemtype="https://schema.org/PropertyValue">
<meta itemprop="name" content="Best Uses - Telecom" />
<meta itemprop="value" content="Office Use" />
</div>
<div itemprop="additionalProperty" itemscope itemtype="https://schema.org/PropertyValue">
<meta itemprop="name" content="Quality of Product" />
<meta itemprop="value" content="4" />
<meta itemprop="maxValue" content="5" />
</div>
<div itemprop="additionalProperty" itemscope itemtype="https://schema.org/PropertyValue">
<meta itemprop="name" content="Value of Product" />
<meta itemprop="value" content="5" />
<meta itemprop="maxValue" content="5" />
</div>
<div itemprop="additionalProperty" itemscope itemtype="https://schema.org/PropertyValue">
<meta itemprop="name" content="Comfort" />
<meta itemprop="value" content="5" />
<meta itemprop="maxValue" content="5" />
</div>
<div itemprop="additionalProperty" itemscope itemtype="https://schema.org/PropertyValue">
<meta itemprop="name" content="Length of ownership" />
<meta itemprop="value" content="3 months" />
</div>
<!-- image -->
<div itemprop="image" itemscope itemtype="https://schema.org/ImageObject">
<meta itemprop="contentUrl" content="https://photos-us.bazaarvoice.com/photo/2/cGhvdG86zdGN1c3RvbWVyLWZhc3QtcHJz/f70282db-e961-5232-bddd-adc4133a7de3" />
<meta itemprop="name" content="Example Review title" />
<meta itemprop="description" content="Example review description" />
<meta itemprop="caption" content="image caption" />
</div>
<!-- video -->
<div itemprop="video" itemscope itemtype="https://schema.org/VideoObject">
<meta itemprop="thumbnailUrl" content="https://video.api.bazaarvoice.com/e6bef6e8-1777-4d6/thumbnail/image-00001.png" />
<meta itemprop="contentUrl" content="https://video.api.bazaarvoice.com/e6bef6e8-1777-4d698/video/movie.mp4" />
<meta itemprop="uploadDate" content="2026-07-30T09:25:23.000+00:00" />
<meta itemprop="name" content="Example Review title" />
<meta itemprop="description" content="Example review description" />
<meta itemprop="caption" content="image caption" />
<div itemprop="thumbnail" itemscope itemtype="https://schema.org/ImageObject">
<meta itemprop="name" content="BAZAARVOICE" />
</div>
</div>
<div itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
<meta itemprop="ratingValue" content="4" />
<meta itemprop="bestRating" content="5" />
<meta itemprop="worstRating" content="1" />
</div>
<div itemprop="author" itemscope itemtype="https://schema.org/Person">
<meta itemprop="name" content="Billy Jean2" />
</div>
</div>
<div itemscope itemtype="https://schema.org/Review">
<meta itemprop="dateCreated" content="2026-03-29T10:42:06.000+00:00" />
<meta itemprop="datePublished" content="2026-03-29T10:46:43.000+00:00" />
<span itemprop="name">Review title</span>
<span itemprop="reviewBody">This is my positive review about this poor product</span>
<div itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
<meta itemprop="ratingValue" content="1" />
<meta itemprop="bestRating" content="5" />
<meta itemprop="worstRating" content="1" />
</div>
<div itemprop="author" itemscope itemtype="https://schema.org/Person">
<meta itemprop="name" content="Billy Jean2" />
</div>
</div>
<div itemscope itemtype="https://schema.org/Review">
<meta itemprop="dateCreated" content="2026-03-28T10:42:22.000+00:00" />
<meta itemprop="datePublished" content="2026-03-28T10:47:00.000+00:00" />
<span itemprop="name">Review title</span>
<span itemprop="reviewBody">This is my positive review about this poor product</span>
<div itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
<meta itemprop="ratingValue" content="5" />
<meta itemprop="bestRating" content="5" />
<meta itemprop="worstRating" content="1" />
</div>
<div itemprop="author" itemscope itemtype="https://schema.org/Person">
<meta itemprop="name" content="Billy Jean2" />
</div>
</div>
<div itemscope itemtype="https://schema.org/Review">
<meta itemprop="dateCreated" content="2026-03-27T10:42:14.000+00:00" />
<meta itemprop="datePublished" content="2026-03-27T10:46:59.000+00:00" />
<span itemprop="name">Review title</span>
<span itemprop="reviewBody">This is my positive review about this poor product</span>
<div itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
<meta itemprop="ratingValue" content="1" />
<meta itemprop="bestRating" content="5" />
<meta itemprop="worstRating" content="1" />
</div>
<div itemprop="author" itemscope itemtype="https://schema.org/Person">
<meta itemprop="name" content="Billy Jean2" />
</div>
</div>
<div itemscope itemtype="https://schema.org/Review">
<meta itemprop="dateCreated" content="2026-03-26T10:42:29.000+00:00" />
<meta itemprop="datePublished" content="2026-03-26T10:48:53.000+00:00" />
<span itemprop="name">Review title</span>
<span itemprop="reviewBody">This is my positive review about this poor product</span>
<div itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
<meta itemprop="ratingValue" content="4" />
<meta itemprop="bestRating" content="5" />
<meta itemprop="worstRating" content="1" />
</div>
<div itemprop="author" itemscope itemtype="https://schema.org/Person">
<meta itemprop="name" content="Billy Jean2" />
</div>
</div>
<div itemscope itemtype="https://schema.org/Review">
<meta itemprop="dateCreated" content="2026-03-26T05:18:36.000+00:00" />
<meta itemprop="datePublished" content="2026-03-26T05:30:32.000+00:00" />
<span itemprop="name">Review title</span>
<span itemprop="reviewBody">This is my positive review about this poor product</span>
<div itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
<meta itemprop="ratingValue" content="1" />
<meta itemprop="bestRating" content="5" />
<meta itemprop="worstRating" content="1" />
</div>
<div itemprop="author" itemscope itemtype="https://schema.org/Person">
<meta itemprop="name" content="Billy Jean2" />
</div>
</div>
<div itemscope itemtype="https://schema.org/Review">
<meta itemprop="dateCreated" content="2026-03-25T06:06:42.000+00:00" />
<meta itemprop="datePublished" content="2026-03-25T06:16:09.000+00:00" />
<span itemprop="name"></span>
<span itemprop="reviewBody"></span>
<div itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
<meta itemprop="ratingValue" content="3" />
<meta itemprop="bestRating" content="5" />
<meta itemprop="worstRating" content="1" />
</div>
<div itemprop="author" itemscope itemtype="https://schema.org/Person">
<meta itemprop="name" content="kpkp" />
</div>
</div>
<div itemscope itemtype="https://schema.org/Review">
<meta itemprop="dateCreated" content="2026-03-25T05:59:51.000+00:00" />
<meta itemprop="datePublished" content="2026-03-25T06:01:58.000+00:00" />
<span itemprop="name">Prod location 36.2</span>
<span itemprop="reviewBody">Prod location 36.2Prod location 36.2Prod location 36.2Prod location 36.2Prod location 36.2Prod location 36.2</span>
<div itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
<meta itemprop="ratingValue" content="2" />
<meta itemprop="bestRating" content="5" />
<meta itemprop="worstRating" content="1" />
</div>
<div itemprop="author" itemscope itemtype="https://schema.org/Person">
<meta itemprop="name" content="rb2503" />
</div>
</div>
</div>Updated 9 days ago
