Retrieve data in JSON-LD
This section provides sample requests to retrieve structured data in JSON-LD format.
Retrieve ratings, reviews and AI generated review summaries in JSON-LD
To retrieve ratings, reviews, and AI-generated review summary schema markups, include q={"reviews":{}, "ratings":{}, "reviewSummary": {}} in the request as shown below.
If you do not include any schema markups in the request, the default API response includes ratings, reviews, and aggregated ratings.
Sample Request
curl -g \
--location \
--header 'Accept: text/javascript' \
--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":{},"ratings":{},"reviewSummary":{}}'
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"
}
},
{
"@type": "Review",
"dateCreated": "2026-03-29T10:42:06.000+00:00",
"datePublished": "2026-03-29T10:46:43.000+00:00",
"reviewBody": "This is my positive review about this poor product",
"name": "Review title",
"reviewRating": {
"@type": "Rating",
"ratingValue": 1,
"bestRating": 5,
"worstRating": 1
},
"author": {
"@type": "Person",
"name": "Billy Jean2"
}
},
{
"@type": "Review",
"dateCreated": "2026-03-28T10:42:22.000+00:00",
"datePublished": "2026-03-28T10:47:00.000+00:00",
"reviewBody": "This is my positive review about this poor product",
"name": "Review title",
"reviewRating": {
"@type": "Rating",
"ratingValue": 5,
"bestRating": 5,
"worstRating": 1
},
"author": {
"@type": "Person",
"name": "Billy Jean2"
}
},
{
"@type": "Review",
"dateCreated": "2026-03-27T10:42:14.000+00:00",
"datePublished": "2026-03-27T10:46:59.000+00:00",
"reviewBody": "This is my positive review about this poor product",
"name": "Review title",
"reviewRating": {
"@type": "Rating",
"ratingValue": 1,
"bestRating": 5,
"worstRating": 1
},
"author": {
"@type": "Person",
"name": "Billy Jean2"
}
},
{
"@type": "Review",
"dateCreated": "2026-03-26T10:42:29.000+00:00",
"datePublished": "2026-03-26T10:48:53.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"
}
},
{
"@type": "Review",
"dateCreated": "2026-03-26T05:18:36.000+00:00",
"datePublished": "2026-03-26T05:30:32.000+00:00",
"reviewBody": "This is my positive review about this poor product",
"name": "Review title",
"reviewRating": {
"@type": "Rating",
"ratingValue": 1,
"bestRating": 5,
"worstRating": 1
},
"author": {
"@type": "Person",
"name": "Billy Jean2"
}
},
{
"@type": "Review",
"dateCreated": "2026-03-25T06:06:42.000+00:00",
"datePublished": "2026-03-25T06:16:09.000+00:00",
"reviewBody": "",
"name": "",
"reviewRating": {
"@type": "Rating",
"ratingValue": 3,
"bestRating": 5,
"worstRating": 1
},
"author": {
"@type": "Person",
"name": "kpkp"
}
},
{
"@type": "Review",
"dateCreated": "2026-03-25T05:59:51.000+00:00",
"datePublished": "2026-03-25T06:01:58.000+00:00",
"reviewBody": "Prod location 36.2Prod location 36.2Prod location 36.2Prod location 36.2Prod location 36.2Prod location 36.2",
"name": "Prod location 36.2",
"reviewRating": {
"@type": "Rating",
"ratingValue": 2,
"bestRating": 5,
"worstRating": 1
},
"author": {
"@type": "Person",
"name": "rb2503"
}
}
]
}
</script><script type="application/ld+json" id="bv-geo-jsonld-ratings-data">
{
"@context": "https://schema.org",
"aggregateRating": {
"@type": "AggregateRating",
"bestRating": 5,
"ratingValue": 3.4320546163849155,
"reviewCount": 3076
}
}
</script><script type="application/ld+json" id="bv-geo-jsonld-reviewSummary-data">
{
"@context": "https://schema.org/",
"review": {
"@type": "Review",
"datePublished": "2025-10-09T19:18:37.064000+00:00",
"reviewBody": "The product is highly regarded by customers, with many praising its excellent features, quality, and value. Positive reviews highlight the impressive battery life and camera performance. However, some mixed opinions mention the camera quality in low light conditions. The summary should be curated to remove irrelevant or low-quality submissions.",
"author": {
"@type": "Organization",
"name": "AI Review Summary",
"description": "This summary is generated by artificial intelligence based on customer reviews"
}
}
}
</script>
Retrieve ratings, reviews, and questions and answers
To retrieve ratings, reviews, and questions and answers schema markups, include q={"reviews":{}, "ratings":{}, "questions": {}} in the request body as shown below
Sample Request
curl -g \
--location \
--header 'Accept: text/javascript' \
--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":{},"ratings":{},"questions":{}}'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"
}
},
{
"@type": "Review",
"dateCreated": "2026-03-29T10:42:06.000+00:00",
"datePublished": "2026-03-29T10:46:43.000+00:00",
"reviewBody": "This is my positive review about this poor product",
"name": "Review title",
"reviewRating": {
"@type": "Rating",
"ratingValue": 1,
"bestRating": 5,
"worstRating": 1
},
"author": {
"@type": "Person",
"name": "Billy Jean2"
}
},
{
"@type": "Review",
"dateCreated": "2026-03-28T10:42:22.000+00:00",
"datePublished": "2026-03-28T10:47:00.000+00:00",
"reviewBody": "This is my positive review about this poor product",
"name": "Review title",
"reviewRating": {
"@type": "Rating",
"ratingValue": 5,
"bestRating": 5,
"worstRating": 1
},
"author": {
"@type": "Person",
"name": "Billy Jean2"
}
},
{
"@type": "Review",
"dateCreated": "2026-03-27T10:42:14.000+00:00",
"datePublished": "2026-03-27T10:46:59.000+00:00",
"reviewBody": "This is my positive review about this poor product",
"name": "Review title",
"reviewRating": {
"@type": "Rating",
"ratingValue": 1,
"bestRating": 5,
"worstRating": 1
},
"author": {
"@type": "Person",
"name": "Billy Jean2"
}
},
{
"@type": "Review",
"dateCreated": "2026-03-26T10:42:29.000+00:00",
"datePublished": "2026-03-26T10:48:53.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"
}
},
{
"@type": "Review",
"dateCreated": "2026-03-26T05:18:36.000+00:00",
"datePublished": "2026-03-26T05:30:32.000+00:00",
"reviewBody": "This is my positive review about this poor product",
"name": "Review title",
"reviewRating": {
"@type": "Rating",
"ratingValue": 1,
"bestRating": 5,
"worstRating": 1
},
"author": {
"@type": "Person",
"name": "Billy Jean2"
}
},
{
"@type": "Review",
"dateCreated": "2026-03-25T06:06:42.000+00:00",
"datePublished": "2026-03-25T06:16:09.000+00:00",
"reviewBody": "",
"name": "",
"reviewRating": {
"@type": "Rating",
"ratingValue": 3,
"bestRating": 5,
"worstRating": 1
},
"author": {
"@type": "Person",
"name": "kpkp"
}
},
{
"@type": "Review",
"dateCreated": "2026-03-25T05:59:51.000+00:00",
"datePublished": "2026-03-25T06:01:58.000+00:00",
"reviewBody": "Prod location 36.2Prod location 36.2Prod location 36.2Prod location 36.2Prod location 36.2Prod location 36.2",
"name": "Prod location 36.2",
"reviewRating": {
"@type": "Rating",
"ratingValue": 2,
"bestRating": 5,
"worstRating": 1
},
"author": {
"@type": "Person",
"name": "rb2503"
}
}
]
}
</script><script type="application/ld+json" id="bv-geo-jsonld-ratings-data">
{
"@context": "https://schema.org",
"aggregateRating": {
"@type": "AggregateRating",
"bestRating": 5,
"ratingValue": 3.4320546163849155,
"reviewCount": 3076
}
}
</script><script type="application/ld+json" id="bv-geo-jsonld-questions-data">
{
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "Question 27?",
"dateCreated": "2019-04-15T13:54:06.000+00:00",
"author": {
"@type": "Person",
"name": "stgtest27"
},
"acceptedAnswer": {
"@type": "Answer",
"text": "This is my answer for this question.",
"dateCreated": "2026-03-20T10:38:06.000+00:00",
"author": {
"@type": "Person",
"name": "Billy Jean2"
},
"upvoteCount": 0
},
"answerCount": 582
},
{
"@type": "Question",
"name": "question8",
"dateCreated": "2026-02-17T04:41:37.000+00:00",
"author": {
"@type": "Person",
"name": "Anonymous"
},
"acceptedAnswer": {
"@type": "Answer",
"text": "test test test test test test test test test test",
"dateCreated": "2026-03-16T06:43:50.000+00:00",
"author": {
"@type": "Person",
"name": "Anonymous"
},
"upvoteCount": 0
},
"answerCount": 1
},
{
"@type": "Question",
"name": "Question test",
"dateCreated": "2020-01-13T10:22:50.000+00:00",
"author": {
"@type": "Person",
"name": "testqa"
},
"acceptedAnswer": {
"@type": "Answer",
"text": "answer is here",
"dateCreated": "2024-01-17T07:37:49.000+00:00",
"author": {
"@type": "Person",
"name": "bobishere"
},
"upvoteCount": 0
},
"answerCount": 5
},
{
"@type": "Question",
"name": "What is use of this product.",
"dateCreated": "2025-03-05T20:04:58.000+00:00",
"author": {
"@type": "Person",
"name": "Anonymous"
},
"acceptedAnswer": {
"@type": "Answer",
"text": "asdfnkll",
"dateCreated": "2025-03-18T18:35:38.000+00:00",
"author": {
"@type": "Person",
"name": "Anonymous"
},
"upvoteCount": 3001
},
"answerCount": 10
},
{
"@type": "Question",
"name": "Testing bv-loader-frame work change in lodash.template ?",
"dateCreated": "2025-07-10T05:53:50.000+00:00",
"author": {
"@type": "Person",
"name": "Anonymous"
},
"acceptedAnswer": {
"@type": "Answer",
"text": "test answer for bfd",
"dateCreated": "2025-07-10T07:56:00.000+00:00",
"author": {
"@type": "Person",
"name": "Anonymous"
},
"upvoteCount": 0
},
"answerCount": 2
},
{
"@type": "Question",
"name": "ADDING native question 2 for demo",
"dateCreated": "2025-02-04T17:24:48.000+00:00",
"author": {
"@type": "Person",
"name": "Anonymous"
},
"acceptedAnswer": {
"@type": "Answer",
"text": "testing new native answer",
"dateCreated": "2025-02-05T06:26:40.000+00:00",
"author": {
"@type": "Person",
"name": "Anonymous"
},
"upvoteCount": 0
},
"answerCount": 9
},
{
"@type": "Question",
"name": "aaa",
"dateCreated": "2025-04-25T06:32:24.000+00:00",
"author": {
"@type": "Person",
"name": "wowmy"
},
"acceptedAnswer": {
"@type": "Answer",
"text": "wjkedwkdkwdkwedjwedwjed",
"dateCreated": "2025-06-30T07:59:52.000+00:00",
"author": {
"@type": "Person",
"name": "testing123"
},
"upvoteCount": 0
},
"answerCount": 1
},
{
"@type": "Question",
"name": "This is my question about this product.",
"dateCreated": "2023-12-17T18:40:43.000+00:00",
"author": {
"@type": "Person",
"name": "Billy Jean2"
},
"acceptedAnswer": {
"@type": "Answer",
"text": "qf23rq2r22",
"dateCreated": "2023-12-18T12:30:21.000+00:00",
"author": {
"@type": "Person",
"name": "Vignesh!f"
},
"upvoteCount": 0
},
"answerCount": 9
},
{
"@type": "Question",
"name": "aa",
"dateCreated": "2025-04-10T10:41:54.000+00:00",
"author": {
"@type": "Person",
"name": "Anonymous"
},
"acceptedAnswer": {
"@type": "Answer",
"text": "AI_GENERATEDThis is a mock generated answer",
"dateCreated": "2025-04-15T09:18:37.000+00:00",
"author": {
"@type": "Person",
"name": "Anonymous"
},
"upvoteCount": 507
},
"answerCount": 2
},
{
"@type": "Question",
"name": "Native question 3 addition for demo",
"dateCreated": "2025-02-04T17:38:11.000+00:00",
"author": {
"@type": "Person",
"name": "Anonymous"
},
"acceptedAnswer": {
"@type": "Answer",
"text": "adding answer to native question",
"dateCreated": "2025-02-04T18:18:20.000+00:00",
"author": {
"@type": "Person",
"name": "Anonymous"
},
"upvoteCount": 0
},
"answerCount": 6
}
],
"@context": "https://schema.org/"
}
</script>Updated about 6 hours ago
What’s Next