Retrieve data in JSON

This section provides sample request to retrieve structured data in the JSON format.

To retrieve data in the JSON format, send application/ld+json 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: application/ld+json' \
--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

{
    "reviews": {
        "@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"
                }
            }
        ]
    },
    "ratings": {
        "@context": "https://schema.org",
        "aggregateRating": {
            "@type": "AggregateRating",
            "bestRating": 5,
            "ratingValue": 3.4320546163849155,
            "reviewCount": 3076
        }
    }
}