Reviews API - How to Edit Reviews Data with API Calls

Link: https://support.brilliantdirectories.com/support/solutions/articles/12000097913

The API allows getting, creating, updating, deleting and searching reviews on the website. However, only one widget can be updated at a time.

Available Endpoints


Below is a list of the available endpoints for the Reviews:


  • https://example.com/api/v2/users_reviews/get/{id}
  • https://example.com/api/v2/users_reviews/create
  • https://example.com/api/v2/users_reviews/update
  • https://example.com/api/v2/users_reviews/delete/{id}
  • https://example.com/api/v2/users_reviews/search


Get a Review

Read the data of a single user review based on the review_id.


Endpoint


GET https://example.com/api/v2/user_reviews/get/{id}

curl -H "Authorization: YOUR_API_KEY" "https://example.com/api/v2/user_reviews/get/{id}"


Example Request:


GET https://example.com/api/v2/users_reviews/get?property=review_id&property_value=39


Query Parameters:

propertyThe property key (eg., review_id).
property_valueThe value associated with the property.






Example Response:


{
"status": "success",
"message": [
{
"review_id": "43",
"user_id": "2",
"review_title": "Great person to work with",
"review_description": "<p>I had a wonderful experience working with this company. </p>",
"review_worked": "",
"service_id": "0",
"review_name": "Jake Umbrella",
"review_email": "[email protected]",
"review_added": "20250227154004",
"review_approved": "",
"ip": "200.189.18.127",
"cookie": "",
"httpr": "california/los-angeles/top-level-category/sample-member-2/writeareview",
"member_id": "21",
"review_token": "432e8e7d5346b37a420bf3a7b3a62752",
"review_updated": "20250227154004",
"rating_overall": "5",
"rating_service": "5",
"rating_response": "5",
"rating_expertise": "5",
"rating_results": "5",
"rating_language": "5",
"revision_timestamp": "2025-02-27 16:42:20",
"formname": "member_review",
"url_origin_pars": "/california/los-angeles/top-level-category/sample-member-2/writeareview"
}
],
"total": 1,
"current_page": 1
}



Create a Review

Add a new user review to the database.

Parameter Notes: The user_id and review_title are required for the API to create the review. When using Postman, select the 'Body' tab, choose 'form-data', and enter the parameters.




Endpoint:


POST https://example.com/api/v2/users_reviews/create

curl -H "Authorization: YOUR_API_KEY" "https://example.com/api/v2/users_reviews/create"


Example Request:


{
"user_id": "2",
"review_title": "Excellent Restaurant",
"review_description": "What makes this restaurant stand out is its versatility. Whether you're craving comfort food like a juicy, plant-based burger with crispy sweet potato fries or something light and refreshing like a quinoa and avocado salad, they have it all.",
"rating_overall": "5",
"rating_service": "5",
"rating_response": "5",
"rating_expertise": "5",
"review_images": "https:\/\/images.pexels.com\/photos\/4374579\/pexels-photo-4374579.jpeg,https:\/\/images.pexels.com\/photos\/6541578\/pexels-photo-6541578.jpeg",
"send_review_email": "1",
"review_email": "[email protected]",
"review_name": "Anita",
"rating_results": "5",
"auto_import_review_image": "1"
}



Query Parameters:


user_idThe ID of the member receiving the review.
review_titleThe title of the review.
review_description:The content of the review
send_review_emailNotifies the member. Set the value to 1 to send an email notification.
rating_overallUse values 1-5, where 1 means Very Poor and 5 means Excellent.
rating_serviceUse values 1-5.
rating_responseUse values 1-5.
rating_expertiseUse values 1-5.
rating_resultsUse values 1-5.
review_emailThe email address of the reviewer.
review_nameThe name of the reviewer submitting the review.
review_imagesURLs of images related to the review. Separate multiple URLs with commas.
auto_import_review_imageAutomatically import an image for the review. Set the value to 1.



Example Response:


{
"status": "success",
"message": {
"review_id": "46",
"user_id": "2",
"review_title": "Excellent Restaurant",
"review_description": "What makes this restaurant stand out is its versatility. Whether you're craving comfort food like a juicy, plant-based burger with crispy sweet potato fries or something light and refreshing like a quinoa and avocado salad, they have it all.",
"service_id": "0",
"review_name": "Anita",
"review_email": "[email protected]",
"review_status": "0",
"review_added": "20250227223422",
"ip": "54.86.50.139",
"httpr": "united-states-of-america/los-angeles/top-level-category/sample-member-2",
"member_id": "0",
"review_token": "670f38aff12bb1922d4b142e9719dad4",
"review_updated": "20250227223422",
"rating_overall": "5",
"rating_service": "5",
"rating_response": "5",
"rating_expertise": "5",
"rating_results": "5",
"spoken_language": "1",
"rating_language": "5",
"review_images": "https://images.pexels.com/photos/4374579/pexels-photo-4374579.jpeg,https://images.pexels.com/photos/6541578/pexels-photo-6541578.jpeg",
"send_review_email": "1",
"auto_import_review_image": "1",
"user_schema": {
"user_id": "2",
"first_name": "Sample",
"last_name": "Member 2",
"email": "[email protected]",
"company": "Sample Member Inc.",
"phone_number": "555-555-5555",
"about_me": "<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit....</p>",
"featured": "0",
"modtime": "2025-02-27 17:09:44",
"subscription_id": "1"
},
"users_portfolio_schema": [
{
"photo_id": "8",
"user_id": "2",
"file": "aphoto-8.jpeg",
"photo_token": "e7ee09b6871303cd66c5033a6fac5ab4",
"photo_date_added": "20250227223428",
"image_imported": "2"
},
{
"photo_id": "9",
"user_id": "2"
}
]
}
}


Update a Review

Update a user review record and its related data in the database.

Parameter Notes: Use review_id to update the review content.


Endpoint:


PUT https://example.com/api/v2/users_reviews/update

curl -H "Authorization: YOUR_API_KEY" "https://example.com/api/v2/users_reviews/update"


Example Request:


{
"user_id": "2",
"review_title": "It's no surprise it has 3 Michelin stars!",
"review_id": "46",
}


Query Parameters:

review_idThe ID of the review.



Example Response:


{
"status": "success",
"message": {
"review_id": "46",
"user_id": "2",
"review_title": "It's no surprise it has 3 Michelin stars!",
"review_description": "What makes this restaurant stand out is its versatility. Whether you're craving comfort food like a juicy, plant-based burger with crispy sweet potato fries or something light and refreshing like a quinoa and avocado salad, they have it all.",
"service_id": "0",
"review_name": "Anita",
"review_email": "[email protected]",
"review_status": "0",
"review_added": "20250227223422",
"ip": "54.86.50.139",
"httpr": "united-states-of-america/los-angeles/top-level-category/sample-member-2",
"member_id": "0",
"review_token": "670f38aff12bb1922d4b142e9719dad4",
"review_updated": "20250227223422",
"rating_overall": "5",
"rating_service": "5",
"rating_response": "5",
"rating_expertise": "5",
"rating_results": "5",
"spoken_language": "1",
"rating_language": "5",
"recommend": "0",
"revision_timestamp": "2025-02-27 22:34:22",
"formname": "member_review",
"user_schema": {
"user_id": "2",
"first_name": "Sample",
"last_name": "Member 2",
"email": "[email protected]",
"company": "Sample Member Inc.",
"phone_number": "555-555-5555",
"address1": "123 S Main St",
"city": "Los Angeles",
"zip_code": "90012",
"state_code": "CA",
"state_ln": "California",
"country_code": "US",
"country_ln": "United States Of America",
"website": "http%3A%2F%2Fwww.mywebsite.com",
"twitter": "http%3A%2F%2Fwww.twitter.com%2Ftwitter",
"facebook": "http%3A%2F%2Fwww.facebook.com",
"linkedin": "http%3A%2F%2Fwww.linkedin.com",
"quote": "This is a sample listing. Think of the possibilities!",
"experience": "2006",
"affiliation": "Cash\rVisa\rMastercard\rAmerican Express",
"awards": "2022 Biggest Smile Award\r2022 Best Customer Service",
"about_me": "<p>Lorem ipsum dolor sit amet...</p>",
"featured": "0",
"modtime": "2025-02-27 17:09:44",
"subscription_id": "1",
"filename": "united-states-of-america/los-angeles/top-level-category/sample-member-2",
"password": "$2a$11$28a5d0f12b0ea67767ad3u6x8ACx/uYv6Hw6wOekvj37yqhreyAB2",
"active": "2",
"token": "bc93bdc6e1467d9cc28e2b14259f5d41",
"ref_code": "Manually Added",
"signup_date": "20150704164637",
"cookie": "f5945dfe74212cffc1c1be1d5d272bb8",
"last_login": "20210908005032",
"position": "Co-Founder",
"instagram": "http%3A%2F%2Fwww.instagram.com",
"credentials": "Certified Happiness Expert\rProfessional Problem Solver",
"bitly": "0",
"profession_id": "1",
"verified": "0",
"nationwide": "0",
"listing_type": "Individual",
"lat": "34.05203440",
"lon": "-118.24387620",
"parent_id": "0"
},
"users_portfolio_schema": [
{
"photo_id": "8",
"user_id": "2",
"file": "aphoto-8.jpeg",
"photo_token": "e7ee09b6871303cd66c5033a6fac5ab4",
"photo_date_added": "20250227223428",
"status": "1",
"order": "1",
"image_imported": "2"
},
{
"photo_id": "9",
"user_id": "2",
"file": "aphoto-9.jpeg",
"photo_token": "6874e29211983fcf0a9135b42cb6d50e",
"photo_date_added": "20250227223428",
"status": "1",
"order": "0",
"image_imported": "2"
}
]
}
}


Delete a Review

Search Reviews and their related data from the database.
Parameter Notes: Use review_id to delete the review.


Endpoint:


DELETE https://example.com/api/v2/user_reviews/delete

curl -H "Authorization: YOUR_API_KEY" "https://example.com/api/v2/user_reviews/delete"


Example Request:


{
"review_id": "2",
}


Query Parameters:

review_idThe ID of the review.



Example Response:


{
"status": "success",
"message": "users_reviews record was deleted"
}


Search a Review

Search Reviews and their related data from the database.
Parameter Notes: Use review_id to search for the review.


Endpoint:


POST https://example.com/api/v2/users_reviews/search

curl -H "Authorization: YOUR_API_KEY" "https://example.com/api/v2/users_reviews/search"


Example Request:


{
"review_id": "39",
}


Query Parameters:

review_idThe ID of the review.


Example Response:


{
"status": "success",
"message": "<hr> <div class=\"module search_result\">\r\n <div class=\"col-md-3 xs-text-center\">\r\n <a href=\"/côte-d-ivoire/abidjan/top-level-category/jake-umbrella\"><img class=\"img-rounded xs-bmargin review_photo\" src=\"/images/default-photo.webp\"></a>\r\n </div>\r\n <div class=\"col-md-9 xs-text-center\">\r\n <a class=\"h3 bold\" href=\"/côte-d-ivoire/abidjan/top-level-category/jake-umbrella\">Jake Umbrella</a>\r\n <h3 class=\"bold tmargin\"><a href=\"/côte-d-ivoire/abidjan/top-level-category/jake-umbrella/reviews/41\">A truly great person</a></h3>\r\n <div class=\"row\">\r\n <div class=\"col-sm-6\">\r\n <ul class=\"list-unstyled nomargin\">\r\n <li>\r\n <p class=\"bold pull-left\">Overall Rating</p>\r\n <div class=\"star_rating pull-right\">\r\n <i class=\"fa fa-star\"></i>\r\n <i class=\"fa fa-star\"></i>\r\n <i class=\"fa fa-star\"></i>\r\n <i class=\"fa fa-star\"></i>\r\n <i class=\"fa fa-star\"></i>\r\n </div>\r\n <div class=\"clearfix\"></div>\r\n </li>\r\n </ul>\r\n </div>\r\n </div>\r\n <p>Greatness!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!</p>\r\n <div class=\"nopad pull-left recent-member-image\" style=\"width: 35px;height: 35px;margin-right: 5px;\">\r\n <img class=\"img-rounded lazyloader\" loading=\"lazy\" width=\"35\" height=\"35\" alt=\"Admin User - Blog Author\" src=\"/images/default-photo.webp\" style=\"display: inline-block;\">\r\n </div>\r\n <p class=\"small tmargin\" style=\"line-height: 35px;\">\r\n Submitted by Admin User - Blog Author on 02/18/2025 </p>\r\n \r\n </div>\r\n <div class=\"clearfix\"></div>\r\n </div>\r\n <div class=\"module search_result\">\r\n <div class=\"col-md-3 xs-text-center\">\r\n <a href=\"/côte-d-ivoire/abidjan/top-level-category/jake-umbrella\"><img class=\"img-rounded xs-bmargin review_photo\" src=\"/images/default-photo.webp\"></a>\r\n </div>\r\n <div class=\"col-md-9 xs-text-center\">\r\n <a class=\"h3 bold\" href=\"/côte-d-ivoire/abidjan/top-level-category/jake-umbrella\">Jake Umbrella</a>\r\n <h3 class=\"bold tmargin\"><a href=\"/côte-d-ivoire/abidjan/top-level-category/jake-umbrella/reviews/40\">Wonderful</a></h3>\r\n <div class=\"row\">\r\n <div class=\"col-sm-6\">\r\n <ul class=\"list-unstyled nomargin\">\r\n <li>\r\n <p class=\"bold pull-left\">Overall Rating</p>\r\n <div class=\"star_rating pull-right\">\r\n <i class=\"fa fa-star\"></i>\r\n <i class=\"fa fa-star\"></i>\r\n <i class=\"fa fa-star\"></i>\r\n <i class=\"fa fa-star\"></i>\r\n <i class=\"fa fa-star\"></i>\r\n </div>\r\n <div class=\"clearfix\"></div>\r\n </li>\r\n </ul>\r\n </div>\r\n </div>\r\n <p>she is wonderful</p>\r\n <p class=\"small tmargin\" style=\"line-height: 35px;\">\r\n Submitted by Coffee on 02/06/2025 </p>\r\n \r\n </div>\r\n <div class=\"clearfix\"></div>\r\n </div>\r\n <div class=\"module search_result\">\r\n <div class=\"col-md-3 xs-text-center\">\r\n <a href=\"/united-states-of-america/los-angeles/top-level-category/sample-member-2\"><img class=\"img-rounded xs-bmargin review_photo\" src=\"/images/default-photo.webp\"></a>\r\n </div>\r\n <div class=\"col-md-9 xs-text-center\">\r\n <a class=\"h3 bold\" href=\"/united-states-of-america/los-angeles/top-level-category/sample-member-2\">Sample Member 2</a>\r\n <h3 class=\"bold tmargin\"><a href=\"/united-states-of-america/los-angeles/top-level-category/sample-member-2/reviews/38\">Great person to work with</a></h3>\r\n <div class=\"row\">\r\n <div class=\"col-sm-6\">\r\n <ul class=\"list-unstyled nomargin\">\r\n <li>\r\n <p class=\"bold pull-left\">Overall Rating</p>\r\n <div class=\"star_rating pull-right\">\r\n <i class=\"fa fa-star\"></i>\r\n <i class=\"fa fa-star\"></i>\r\n <i class=\"fa fa-star\"></i>\r\n <i class=\"fa fa-star\"></i>\r\n <i class=\"fa fa-star\"></i>\r\n </div>\r\n <div class=\"clearfix\"></div>\r\n </li>\r\n </ul>\r\n </div>\r\n </div>\r\n <p>I had a wonderful experience working with this company. They were very professional and I would recommend them to my friends and family. They were on time, responsive and completed the job within budget. I'm very pleased that I went with this company. </p>\r\n <p class=\"small tmargin\" style=\"line-height: 35px;\">\r\n Submitted by Sample Reveiwer on 08/13/2024 </p>\r\n \r\n </div>\r\n <div class=\"clearfix\"></div>\r\n </div>\r\n <div class=\"module search_result\">\r\n <div class=\"col-md-3 xs-text-center\">\r\n <a href=\"/united-states-of-america/los-angeles/top-level-category/sample-member-3\"><img class=\"img-rounded xs-bmargin review_photo\" src=\"/images/default-photo.webp\"></a>\r\n </div>\r\n <div class=\"col-md-9 xs-text-center\">\r\n <a class=\"h3 bold\" href=\"/united-states-of-america/los-angeles/top-level-category/sample-member-3\">Sample Member 3</a>\r\n <h3 class=\"bold tmargin\"><a href=\"/united-states-of-america/los-angeles/top-level-category/sample-member-3/reviews/39\">Great person to work with</a></h3>\r\n <div class=\"row\">\r\n <div class=\"col-sm-6\">\r\n <ul class=\"list-unstyled nomargin\">\r\n <li>\r\n <p class=\"bold pull-left\">Overall Rating</p>\r\n <div class=\"star_rating pull-right\">\r\n <i class=\"fa fa-star\"></i>\r\n <i class=\"fa fa-star\"></i>\r\n <i class=\"fa fa-star\"></i>\r\n <i class=\"fa fa-star\"></i>\r\n <i class=\"fa fa-star\"></i>\r\n </div>\r\n <div class=\"clearfix\"></div>\r\n </li>\r\n </ul>\r\n </div>\r\n </div>\r\n <p>I had a wonderful experience working with this company. They were very professional and I would recommend them to my friends and family. They were on time, responsive and completed the job within budget. I&#39;m very pleased that I went with this company. &nbsp;</p>\r\n <p class=\"small tmargin\" style=\"line-height: 35px;\">\r\n Submitted by Sample Reveiwer on 08/13/2024 </p>\r\n \r\n </div>\r\n <div class=\"clearfix\"></div>\r\n </div>\r\n",
"total_reviews": "4",
"total_pages": 1
}