Send filters, limit, offset and sort options
This section provides sample request to pass filters, limit, offset and sort parameters.
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 about 6 hours ago