Improved

Reviews V1: review, Q&A and media response fields explained

The Reviews V1 reference now describes fields that were undocumented or described wrongly:

  • Errors: the Errors guide lists the V1 error fields: error_type is the error class, uuid is the request ID to give Yotpo support, and s and r are internal fields you can ignore.
  • Reviews: on Create review (synchronous) and Retrieve reviews for a user, user_type now explains User and AnonymousUser, review title and text note that they're returned HTML-encoded, and fields such as user_vote, new and account.domain are described. Social posting fields, mentions and Location_idx are marked as legacy.
  • Create review: on Create review, creation_request_id is returned only when request ID tracking is on. Use it to match the review_create webhook to your request. It can't be used to look up the review.
  • Q&A: on Retrieve questions and answers for a product, sorted_public_answers now states its order (net votes, then newest day first), and the asker's and answerer's score and badges are marked as legacy. There and on Retrieve product questions, is_social_connected is marked as legacy (always false).
  • Visual UGC: on Product images, the video fields are marked "video only" and are null for images. ref_id and post.hashtag_name are described, and product_info, tagged_products[].social_links and shop_owner are marked as legacy (always null). There and on Photos by album, tagged_products[].score, reviews_count and permission_request_status are described.

Request and response formats haven't changed.