An asynchronous request that retrieves existing user data in the Yotpo system. User data is sent as a JSON file to the account email address associated with the Yotpo account utoken.
Note:
To check for existing data about a specific customer, the merchant's utoken should be passed as the
utokenand the customer's email address should be passed as the
What happens next?
If you received a 200 OK response and the data exists endpoint returned a response attribute of "has_data": true, you'll receive the user data via an email sent to the email address associated with the account utoken. The email contains a link to a JSON file which includes any existing user data as shown in the response below:
Notes:
- The link to the user data JSON file will expire 48 hours after the request is generated.
- The User Data JSON includes any orders metadata collected upon order creation.
{
reviews: [
{
id: 32,
title: "This product changed my life",
content: "I can't reccomend this product enough!",
images: [ ],
social_shares: [ ]
}
],
orders: [
{
id: 44,
external_order_id: "1524729980",
name: "Randy S.",
email: "[email protected]",
"customer_properties": {
"state": "New York",
"country": "USA",
"address": "123 Main Street",
"phone_number": "555-555-5555"
}
],
questions: [
{
id: 4,
content: "Do you have this in white?"
}
],
answers: [
{
id:8
content: Yes! We have this product in every color!
}
],
uploaded_on_site: [
{
id: "39712118",
image_url: "https://ddcfq0gxiontw.cloudfront.net/Account/208659/39711849/original.png?1523443483"
}
],
photo_imports: null
}Note:
If your response came back with a 200 | OK code and you haven't received an email from Yotpo within 24 hours, please reach out to Yotpo support for assistance.
Response Param | Description |
|---|---|
Reviews | The reviews array includes data on reviews associated with the queried account. |
| The review ID |
| The review title |
| The review content |
| Any customer photos included with the review |
| Social media network where the review was shared |
Orders | The orders array includes data on orders associated with the queried account. |
| Yotpo's internal order ID |
| Your eCommerce platform order ID (e.g. Shopify order ID). |
| The customer's name |
| The customer's email address |
| Orders metadata includes customer |
Questions | The questions array includes data on questions asked by reviewers per the queried account. |
| The question ID |
| The question content |
Answers | The answers array includes data on questions asked by reviewers per the queried account. |
| The answer ID |
| The answer content |
Uploaded On Site | Photos uploaded by customers through your on-site UGC or Product gallery |
| The photo upload ID |
| The image URL of the uploaded image |
Photo Imports | Photos imported to Yotpo via .csv upload |