Send filters, limit, offset and sort options
The example below shows how to pass filters, limit, offset, and sort parameters similar to the Conversations API.
Sample Request
curl -g --location \
--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>' \
'https://seo.bazaarvoice.com/structured-data/v1/clients/testcustomer-fast-prs/ugc?locale=en_US&productId=product1&q={"reviews":{"filter":["productid:eq:product1"],"limit":"1","offset":"0","sort":"submissiontime:desc"}}'Sample Response
<script type="application/ld+json" id="bv-geo-jsonld-reviews-data">
{
"@context": "https://schema.org/",
"review": [
{
"@type": "Review",
"dateCreated": "2026-03-30T10:42:36.000+00:00",
"datePublished": "2026-03-30T10:45:44.000+00:00",
"reviewBody": "This is my positive review about this poor product",
"name": "Review title",
"reviewRating": {
"@type": "Rating",
"ratingValue": 4,
"bestRating": 5,
"worstRating": 1
},
"author": {
"@type": "Person",
"name": "Billy Jean2"
}
}
]
}
</script>
Updated 20 days ago