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>

Did this page help you?