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 id='bv-geo-microdata-reviews-data' style='display: none'>
    <div itemprop="review" itemscope itemtype="https://schema.org/Review">
        <span itemprop="dateCreated">2026-03-30T10:42:36.000+00:00</span>
        <span itemprop="datePublished">2026-03-30T10:45:44.000+00:00</span>
        <span itemprop="reviewBody">This is my positive review about this poor product</span>
        <span itemprop="name">Review title</span>
        <div itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
            <span itemprop="ratingValue">4</span>
            <span itemprop="bestRating">5</span>
            <span itemprop="worstRating">1</span>
        </div>
        <div itemprop="author" itemscope itemtype="https://schema.org/Person">
            <span itemprop="name">Billy Jean2</span>
        </div>
    </div>
    <div itemprop="review" itemscope itemtype="https://schema.org/Review">
        <span itemprop="dateCreated">2026-03-29T10:42:06.000+00:00</span>
        <span itemprop="datePublished">2026-03-29T10:46:43.000+00:00</span>
        <span itemprop="reviewBody">This is my positive review about this poor product</span>
        <span itemprop="name">Review title</span>
        <div itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
            <span itemprop="ratingValue">1</span>
            <span itemprop="bestRating">5</span>
            <span itemprop="worstRating">1</span>
        </div>
        <div itemprop="author" itemscope itemtype="https://schema.org/Person">
            <span itemprop="name">Billy Jean2</span>
        </div>
    </div>
    <div itemprop="review" itemscope itemtype="https://schema.org/Review">
        <span itemprop="dateCreated">2026-03-28T10:42:22.000+00:00</span>
        <span itemprop="datePublished">2026-03-28T10:47:00.000+00:00</span>
        <span itemprop="reviewBody">This is my positive review about this poor product</span>
        <span itemprop="name">Review title</span>
        <div itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
            <span itemprop="ratingValue">5</span>
            <span itemprop="bestRating">5</span>
            <span itemprop="worstRating">1</span>
        </div>
        <div itemprop="author" itemscope itemtype="https://schema.org/Person">
            <span itemprop="name">Billy Jean2</span>
        </div>
    </div>
    <div itemprop="review" itemscope itemtype="https://schema.org/Review">
        <span itemprop="dateCreated">2026-03-27T10:42:14.000+00:00</span>
        <span itemprop="datePublished">2026-03-27T10:46:59.000+00:00</span>
        <span itemprop="reviewBody">This is my positive review about this poor product</span>
        <span itemprop="name">Review title</span>
        <div itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
            <span itemprop="ratingValue">1</span>
            <span itemprop="bestRating">5</span>
            <span itemprop="worstRating">1</span>
        </div>
        <div itemprop="author" itemscope itemtype="https://schema.org/Person">
            <span itemprop="name">Billy Jean2</span>
        </div>
    </div>
    <div itemprop="review" itemscope itemtype="https://schema.org/Review">
        <span itemprop="dateCreated">2026-03-26T10:42:29.000+00:00</span>
        <span itemprop="datePublished">2026-03-26T10:48:53.000+00:00</span>
        <span itemprop="reviewBody">This is my positive review about this poor product</span>
        <span itemprop="name">Review title</span>
        <div itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
            <span itemprop="ratingValue">4</span>
            <span itemprop="bestRating">5</span>
            <span itemprop="worstRating">1</span>
        </div>
        <div itemprop="author" itemscope itemtype="https://schema.org/Person">
            <span itemprop="name">Billy Jean2</span>
        </div>
    </div>
    <div itemprop="review" itemscope itemtype="https://schema.org/Review">
        <span itemprop="dateCreated">2026-03-26T05:18:36.000+00:00</span>
        <span itemprop="datePublished">2026-03-26T05:30:32.000+00:00</span>
        <span itemprop="reviewBody">This is my positive review about this poor product</span>
        <span itemprop="name">Review title</span>
        <div itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
            <span itemprop="ratingValue">1</span>
            <span itemprop="bestRating">5</span>
            <span itemprop="worstRating">1</span>
        </div>
        <div itemprop="author" itemscope itemtype="https://schema.org/Person">
            <span itemprop="name">Billy Jean2</span>
        </div>
    </div>
    <div itemprop="review" itemscope itemtype="https://schema.org/Review">
        <span itemprop="dateCreated">2026-03-25T06:06:42.000+00:00</span>
        <span itemprop="datePublished">2026-03-25T06:16:09.000+00:00</span>
        <div itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
            <span itemprop="ratingValue">3</span>
            <span itemprop="bestRating">5</span>
            <span itemprop="worstRating">1</span>
        </div>
        <div itemprop="author" itemscope itemtype="https://schema.org/Person">
            <span itemprop="name">kpkp</span>
        </div>
    </div>
    <div itemprop="review" itemscope itemtype="https://schema.org/Review">
        <span itemprop="dateCreated">2026-03-25T05:59:51.000+00:00</span>
        <span itemprop="datePublished">2026-03-25T06:01:58.000+00:00</span>
        <span itemprop="reviewBody">Prod location 36.2Prod location 36.2Prod location 36.2Prod location 36.2Prod location 36.2Prod location 36.2</span>
        <span itemprop="name">Prod location 36.2</span>
        <div itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
            <span itemprop="ratingValue">2</span>
            <span itemprop="bestRating">5</span>
            <span itemprop="worstRating">1</span>
        </div>
        <div itemprop="author" itemscope itemtype="https://schema.org/Person">
            <span itemprop="name">rb2503</span>
        </div>
    </div>
</div>
<div id='bv-geo-microdata-ratings-data' style='display: none'>
    <div>
        <div itemprop="aggregateRating" itemscope itemtype="https://schema.org/AggregateRating">
            <span itemprop="bestRating">5</span>
            <span itemprop="ratingValue">3.4320546163849155</span>
            <span itemprop="reviewCount">3076</span>
        </div>
    </div>
</div>