Introduction
Welcome to the home of Sitejabber’s API documentation. Here you will find all required details on our APIs, including accessible objects, request formats, authentication methods, and error codes. If you have any additional questions, please email biz@sitejabber.com
Schema definition
Definition of the schema returned in JSON by the API endpoints.
Login Object
Name | Type | Optional | Description |
---|---|---|---|
token | String | No | Token used in subsequent calls as user identifier |
expire | DateTime | No | When the token will expire |
user | User object | No | User logged in into the system |
Url Object
Name | Type | Optional | Description |
---|---|---|---|
name | String | No | Name of the business |
urlAddress | String | No | Url of the site |
displayAddress | String | No | Url of the site without http:// |
urlProfilePage | String | No | Url of the site’s profile page |
averageRating | Array | No | Array of Rating object |
numReviews | Array | No | Array of NumReviews object |
phone | String | Yes | Phone of the site |
String | Yes | Email of the site | |
address | Address object | No | Address of the site |
Address Object
Name | Type | Optional | Description |
---|---|---|---|
streetAddress | String | Yes | Street address |
streetAddress2 | String | Yes | Street address second line |
city | String | Yes | City |
state | String | Yes | State |
postalCode | String | Yes | Postal code |
country | String | Yes | Country |
completeAddress | String | Yes | All fields defining the complete address |
NumReviews Object
Name | Type | Optional | Description |
---|---|---|---|
type | String | No | Possible values: total, fiveStars, fourStars, threeStars, twoStars, oneStar |
rating | Integer | No | Number of reviews |
Review Object
Name | Type | Optional | Description |
---|---|---|---|
reviewNo | Integer | No | Review number, identifier |
rating | Array | No | Array of Rating object |
title | String | No | Title for the review |
content | String | No | Content for the review |
tip | String | Yes | Tip for the review |
order_id | String | Yes | Order ID for the review |
created | DateTime/String | No | Review creation date |
published | DateTime/String | No | If the review is not yet published, it’ll contain the string pending |
edited | DateTime | Yes | DateTime the review was edited |
updated_for | Review object | Yes | If this is an updated review, this will contain the original review |
source | String | Yes | Only available for solicited reviews, indicates the source, can be one of the following: BCC, CSV, WEBHOOK, CHECKOUT_WIDGET, OTHER |
author | User object | No | Author of the review |
Rating Object
Name | Type | Optional | Description |
---|---|---|---|
type | String | No | Possible values: overall, service, value, shipping, returns, quality |
rating | Float | No | Float value between 1 and 5 |
User Object
Name | Type | Optional | Description |
---|---|---|---|
username | String | No | Username of the user |
firstName | String | No | First name of the user |
lastName | String | No | First letter of last name of the user |
thumbnail | String | No | Relative path of the user’s thumbnail image |
profilePage | String | No | Url of the user’s profile page |
numReviews | Integer | No | Number of reviews written by the user |
numHelpfulVotes | Integer | No | Number of helpful votes received |
String | Yes | Only available for solicited reviews and when the email of the user was provided by the business |
Comment Object
Name | Type | Optional | Description |
---|---|---|---|
content | String | No | Content of the comment |
num_votes | Integer | No | Number of votes received |
activated | Boolean | No | 0 - not activated, 1 - activated |
created | DateTime | No | DateTime the comment was created |
published | DateTime | No | DateTime the comment was published |
author | User object | No | Author of the comment |
Message Object
Name | Type | Optional | Description |
---|---|---|---|
subject | String | No | Subject of the message |
body | String | No | Body of the message |
review | Review object | Yes | Review this message belongs to, if any |
created | DateTime | No | Creation date of the message |
recipient | User object | No | User who received the message |
sender | User object | No | User who sent the message |
Partner Object
Name | Type | Optional | Description |
---|---|---|---|
url | String | No | Url link to access the requested review page |
hash | String | No | Hash identifier for the requested review page |
expire | DateTime | No | When the link will expire |
All responses includes the Status object
Status Object
Name | Type | Optional | Description |
---|---|---|---|
status | String | No | OK if everything went good, ERROR if there was an error processing the request |
success | Boolean | No | true or false |
errorCode | Integer | Yes | Error code, only present when status is ERROR |
errorReason | String | Yes | Error message, only present when status is ERROR |
Authentication
To authorize, use this code:
curl -d "email=myemail&password=mypassword" "https://api.sitejabber.com/v1/login?client_token=myapikey"
<?php
$post = [
'email' => 'myemail',
'password' => 'mypassword'
];
$url = 'https://api.sitejabber.com/v1/login?client_token=myapikey';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, TRUE);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($post));
$res = curl_exec($ch);
curl_close($ch);
?>
The above command returns (Login Object) JSON structured like this:
{
"token": "5922b0ad07f849330de5af5c07fdd27ead7f4582",
"expire": "2017-06-06 13:04:39",
"user": {
"username":"myusername",
"firstName":"name",
"lastName":"P",
"thumbnail":"default_profile_photo.png",
"profilePage":"https:\/\/www.sitejabber.com\/users\/myusername",
"numReviews":0,
"numHelpfulVotes":0
},
"status": "OK",
"success": true
},
The token is to be used in subsequent calls
HTTP Request
POST https://api.sitejabber.com/v1/login
Business info
Get info for a given business
curl -H "user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582" "https://api.sitejabber.com/v1/businesses/yourdomain.com?client_token=myapikey"
<?php
$header = [
'user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582'
];
$url = 'https://api.sitejabber.com/v1/businesses/yourdomain.com?client_token=myapikey';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$res = curl_exec($ch);
curl_close($ch);
The above command returns (Url Object) JSON structured like this:
{
"name":"Business",
"urlAddress":"http:\/\/yourdomain.com",
"displayAddress":"yourdomain.com",
"urlProfilePage":"https:\/\/www.sitejabber.com\/reviews\/www.yourdomain.com",
"averageRating":[
{
"type":"overall",
"rating":1.85
},
{
"type":"service",
"rating":1.64
},
{
"type":"value",
"rating":1.89
},
{
"type":"shipping",
"rating":2.21
},
{
"type":"returns",
"rating":1.55
},
{
"type":"quality",
"rating":2
}
],
"numReviews":[
{
"type":"total",
"rating":1088
},
{
"type":"fiveStars",
"rating":146
},
{
"type":"fourStars",
"rating":35
},
{
"type":"threeStars",
"rating":21
},
{
"type":"twoStars",
"rating":58
},
{
"type":"oneStar",
"rating":828
}
],
"phone":"",
"email":"",
"address":{
"streetAddress":"FakeStreet",
"streetAddress2":"",
"city":"FakeCity",
"state":"CA",
"postalCode":"",
"country":"USA",
"completeAddress":"FakeCity, CA, USA"
},
"status":"OK",
"success":true
}
This endpoint retrieves information for the given business
HTTP Request
GET https://api.sitejabber.com/v1/businesses/yourdomain.com
Get info for several businesses
curl -H "user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582" "https://api.sitejabber.com/v1/businesses/bulk?client_token=myapikey&businesses=%5B%22business1.com%22%2C%22business2.com%22%2C%22business3.com%22%5D"
<?php
$header = [
'user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582'
];
$businesses = ['business1.com', 'business2.com', 'business3.com'];
$url = 'https://api.sitejabber.com/v1/businesses/bulk?client_token=myapikey&businesses=' . urlencode(json_encode($businesses));
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$res = curl_exec($ch);
curl_close($ch);
The above command returns (Array of Url Object) JSON structured like this:
{
"urls":[
{
"name":"Business1",
"urlAddress":"http:\/\/business1.com",
"displayAddress":"business1.com",
"urlProfilePage":"https:\/\/www.sitejabber.com\/reviews\/www.business1.com",
"averageRating":[
{
"type":"overall",
"rating":1.85
},
{
"type":"service",
"rating":1.64
},
{
"type":"value",
"rating":1.89
},
{
"type":"shipping",
"rating":2.21
},
{
"type":"returns",
"rating":1.55
},
{
"type":"quality",
"rating":2
}
],
"numReviews":[
{
"type":"total",
"rating":1088
},
{
"type":"fiveStars",
"rating":146
},
{
"type":"fourStars",
"rating":35
},
{
"type":"threeStars",
"rating":21
},
{
"type":"twoStars",
"rating":58
},
{
"type":"oneStar",
"rating":828
}
],
"phone":"",
"email":"",
"address":{
"streetAddress":"FakeStreet",
"streetAddress2":"",
"city":"FakeCity",
"state":"CA",
"postalCode":"",
"country":"USA",
"completeAddress":"FakeCity, CA, USA"
}
},
{
"name":"Business2",
"urlAddress":"http:\/\/business2.com",
"displayAddress":"business2.com",
"urlProfilePage":"https:\/\/www.sitejabber.com\/reviews\/www.business2.com",
"averageRating":[
{
"type":"overall",
"rating":4.15
},
{
"type":"service",
"rating":4.26
},
{
"type":"value",
"rating":4.11
},
{
"type":"shipping",
"rating":4.22
},
{
"type":"returns",
"rating":4.19
},
{
"type":"quality",
"rating":4.34
}
],
"numReviews":[
{
"type":"total",
"rating":807
},
{
"type":"fiveStars",
"rating":514
},
{
"type":"fourStars",
"rating":147
},
{
"type":"threeStars",
"rating":33
},
{
"type":"twoStars",
"rating":38
},
{
"type":"oneStar",
"rating":75
}
],
"phone":"",
"email":"support@business2.com",
"address":{
"streetAddress":"FakeStreet",
"streetAddress2":"",
"city":"FakeCity",
"state":"CA",
"postalCode":"94403",
"country":"USA",
"completeAddress":"FakeCity, CA 94403, USA"
}
},
{
"name":"Business3",
"urlAddress":"http:\/\/business3.com",
"displayAddress":"business3.com",
"urlProfilePage":"https:\/\/www.sitejabber.com\/reviews\/www.business3.com",
"averageRating":[
{
"type":"overall",
"rating":3.46
},
{
"type":"service",
"rating":3.16
},
{
"type":"value",
"rating":2.48
},
{
"type":"shipping",
"rating":2.76
},
{
"type":"returns",
"rating":2.35
},
{
"type":"quality",
"rating":2.75
}
],
"numReviews":[
{
"type":"total",
"rating":3061
},
{
"type":"fiveStars",
"rating":1656
},
{
"type":"fourStars",
"rating":334
},
{
"type":"threeStars",
"rating":96
},
{
"type":"twoStars",
"rating":163
},
{
"type":"oneStar",
"rating":812
}
],
"phone":"(123) 456-7890",
"email":"",
"address":{
"streetAddress":"FakeStreet",
"streetAddress2":"",
"city":"FakeCity",
"state":"OK",
"postalCode":"73104",
"country":"",
"completeAddress":"FakeCity, OK 73104"
}
}
],
"status":"OK",
"success":true
}
This endpoint retrieves information for up to 20 businesses at a time
HTTP Request
GET https://api.sitejabber.com/v1/businesses/bulk
Query Parameters
Parameter | Required | Description |
---|---|---|
businesses | true | all businesses to be queried encoded and json format |
Reviews
Get reviews of a business
curl -H "user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582" "https://api.sitejabber.com/v1/businesses/yourdomain.com/reviews?client_token=myapikey"
<?php
$header = [
'user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582'
];
$url = 'https://api.sitejabber.com/v1/businesses/yourdomain.com/reviews?client_token=myapikey';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$res = curl_exec($ch);
curl_close($ch);
The above command returns (Array of Review Object) JSON structured like this:
[
{
"reviewNo" : "3",
"rating" : [
{
"type" : "overall",
"rating" : "5"
},
{
"type" : "service",
"rating" : "5"
},
{
"type" : "value",
"rating" : "4"
},
{
"type" : "shipping",
"rating" : "5"
},
{
"type" : "returns",
"rating" : "5"
},
{
"type" : "quality",
"rating" : "5"
}
],
"title" : "Best business ever!",
"content" : "Everyone should buy from here.",
"tip" : "Don't forget to use coupons at check out.",
"order_id" : "XHD39545",
"created" : "2015-11-06 12:01:45",
"published" : "2015-11-06 12:01:45",
"edited" : "",
"updated_for" : {
"reviewNo" : 1,
"rating" : [
{
"type" : "overall",
"rating" : 3
},
{
"type" : "service",
"rating" : null
},
{
"type" : "value",
"rating" : null
},
{
"type" : "shipping",
"rating" : null
},
{
"type" : "returns",
"rating" : null
},
{
"type" : "quality",
"rating" : null
}
],
"title" : "Best business ever ever!",
"content" : "Everyone should buy in this site.",
"tip" : null,
"order_id": "XHD39545",
"created": "2016/04/25 04:07:38",
"published": "2016/04/25 04:07:38",
"edited": "",
"author": {
"username" : "user123",
"firstName" : "John",
"lastName" : "D",
"thumbnail" : "users/user123/thumbnail123.jpg",
"profilePage" : "https://www.sitejabber.com/users/user123",
"numReviews" : "10",
"numHelpfulVotes" : "5"
},
"author" : {
"username" : "user123",
"firstName" : "John",
"lastName" : "D",
"thumbnail" : "users/user123/thumbnail123.jpg",
"profilePage" : "https://www.sitejabber.com/users/user123",
"numReviews" : "10",
"numHelpfulVotes" : "5"
}
},
{
"reviewNo" : "4",
"rating" : [
{
"type" : "overall",
"rating" : "5"
},
{
"type" : "service",
"rating" : "5"
},
{
"type" : "value",
"rating" : "4"
},
{
"type" : "shipping",
"rating" : "5"
},
{
"type" : "returns",
"rating" : "5"
},
{
"type" : "quality",
"rating" : "5"
}
],
"title" : "Best business ever!",
"content" : "Everyone should buy from here.",
"tip" : "Don't forget to use coupons at check out.",
"order_id" : "XHD39546",
"created" : "2015-11-06 12:01:45",
"published" : "2015-11-07 12:01:45",
"source" : "CHECKOUT_WIDGET",
"author" : {
"username" : "user123",
"firstName" : "John",
"lastName" : "D",
"thumbnail" : "users/user123/thumbnail123.jpg",
"profilePage" : "https://www.sitejabber.com/users/user123",
"numReviews" : "10",
"numHelpfulVotes" : "5",
"email" : "john@example.com"
}
}
]
This endpoint retrieves all reviews.
HTTP Request
GET https://api.sitejabber.com/v1/businesses/yourdomain.com/reviews
Query Parameters
Parameter | Default | Description |
---|---|---|
start | 0 | starting offset |
count | 10 | number of reviews to be included |
q | null | search reviews by keyword (title, content) |
labels | null | search reviews with the specified comma separated labels |
date_from | null | start date in format (yyyy-mm-dd hh:mm:ss) [hh:mm:ss] is optional |
date_to | null | end date in format (yyyy-mm-dd hh:mm:ss) [hh:mm:ss] is optional |
unpublished | false | include unpublished reviews (0 or 1) |
updated | false | search updated reviews (0 or 1) |
order | DESC | ASC/DESC order of the reviews, ascending or descending on the creation date |
Publish an unpublished review
curl -H "user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582" -d "review_no=2" "https://api.sitejabber.com/v1/businesses/yourdomain.com/reviews/publish?client_token=myapikey"
<?php
$header = [
'user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582'
];
$post = [
'review_no' => '2'
];
$url = 'https://api.sitejabber.com/v1/businesses/yourdomain.com/reviews/publish?client_token=myapikey';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, TRUE);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($post));
$res = curl_exec($ch);
curl_close($ch);
The above command returns JSON structured like this:
{
"status":"OK",
"success":true
}
HTTP Request
POST https://api.sitejabber.com/v1/businesses/yourdomain.com/reviews/publish
Data
Parameter | Required | Description |
---|---|---|
review_no | true | number of review to be published |
Flag a review
curl -H "user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582" -d "review_no=2&reason=personal_info&message=Privacy%20policy%20violation" "https://api.sitejabber.com/v1/businesses/yourdomain.com/reviews/flag?client_token=myapikey"
<?php
$header = [
'user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582'
];
$post = [
'review_no' => '2',
'reason' => 'personal_info',
'message' => 'Privacy policy violation'
];
$url = 'https://api.sitejabber.com/v1/businesses/yourdomain.com/reviews/flag?client_token=myapikey';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, TRUE);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($post));
$res = curl_exec($ch);
curl_close($ch);
The above command returns (Status Object) JSON structured like this:
{
"status":"OK",
"success":true
}
HTTP Request
POST https://api.sitejabber.com/v1/businesses/yourdomain.com/reviews/flag
Data
Parameter | Required | Description |
---|---|---|
review_no | true | number of review to be flagged |
reason | true | reason can be one of the following: language, personal_info, personal_attack, second_hand, another_biz, other. language: Review contains profanity, lewdness, or bigotry personal_info: Review contains personal information personal_attack: Review contains personal attacks second_hand: Review describes second-hand experience another_biz: Review was intended for another business other: Other |
message | true | feedback message explaining the reason |
Review Comments
Get comment
curl -H "user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582" "https://api.sitejabber.com/v1/businesses/yourdomain.com/review/comments?client_token=myapikey&review_no=2"
<?php
$header = [
'user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582'
];
$url = 'https://api.sitejabber.com/v1/businesses/yourdomain.com/review/comments?client_token=myapikey&review_no=2';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$res = curl_exec($ch);
curl_close($ch);
The above command returns (Array of Comment Object) JSON structured like this:
{
"comments":[
{
"content":"my new comment",
"num_votes":0,
"activated":1,
"created":"2016\/01\/25 06:31:47",
"published":"2016\/01\/25 06:31:47",
"author":{
"username":"user123",
"firstName":"John",
"lastName":"D",
"thumbnail":"users/user123/thumbnail123.jpg",
"profilePage":"https://www.sitejabber.com/users/user123",
"numReviews":0,
"numHelpfulVotes":0
}
}
],
"status":"OK",
"success":true
}
HTTP Request
GET https://api.sitejabber.com/v1/businesses/yourdomain.com/review/comments
Query Parameters
Parameter | Required | Description |
---|---|---|
review_no | true | number of review to fetch comments from |
Add comment to review
curl -H "user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582" -d "review_no=2&text=my%20new%20comment" "https://api.sitejabber.com/v1/businesses/yourdomain.com/review/comments/add?client_token=myapikey"
<?php
$header = [
'user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582'
];
$post = [
'review_no' => '2',
'text' => 'my new comment'
];
$url = 'https://api.sitejabber.com/v1/businesses/yourdomain.com/review/comments/add?client_token=myapikey';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, TRUE);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($post));
$res = curl_exec($ch);
curl_close($ch);
The above command returns (Status Object) JSON structured like this:
{
"status":"OK",
"success":true
}
HTTP Request
POST https://api.sitejabber.com/v1/businesses/yourdomain.com/review/comments/add
Data
Parameter | Required | Description |
---|---|---|
review_no | true | number of review to which comment will be added |
text | true | text of the comment |
Messages
Get messages
curl -H "user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582" "https://api.sitejabber.com/v1/businesses/yourdomain.com/messages?client_token=myapikey&username=user"
<?php
$header = [
'user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582'
];
$url = 'https://api.sitejabber.com/v1/businesses/yourdomain.com/messages?client_token=myapikey&username=user';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$res = curl_exec($ch);
curl_close($ch);
The above command returns (Array of Message Object) JSON structured like this:
{
"messages":[
{
"subject": "Re: Business - 348289THX",
"body": "My new message4",
"review": null,
"created": "2017\/07\/10 12:45:44",
"recipient": {
"username": "user123",
"firstName": "John",
"lastName": "D",
"thumbnail": "default_profile_photo.png",
"profilePage": "https://www.sitejabber.com/users/user123",
"numReviews": 0,
"numHelpfulVotes": 1
},
"sender": {
"username": "user3",
"firstName": "John",
"lastName": "F",
"thumbnail": "default_profile_photo.png",
"profilePage": "https://www.sitejabber.com/users/user3",
"numReviews": 0,
"numHelpfulVotes": 1
}
},
{
"subject": "Re: Business - 348289THX",
"body": "My new message3",
"review": null,
"created": "2017\/07\/07 02:31:44",
"recipient": {
"username": "user123",
"firstName": "John",
"lastName": "D",
"thumbnail": "default_profile_photo.png",
"profilePage": "https://www.sitejabber.com/users/user123",
"numReviews": 0,
"numHelpfulVotes": 1
},
"sender": {
"username": "user3",
"firstName": "John",
"lastName": "F",
"thumbnail": "default_profile_photo.png",
"profilePage": "https://www.sitejabber.com/users/user3",
"numReviews": 0,
"numHelpfulVotes": 1
}
},
{
"subject": "Re: Business - 348289THX",
"body": "My new message2",
"review": null,
"created": "2017\/07\/05 11:07:31",
"recipient": {
"username": "user123",
"firstName": "John",
"lastName": "D",
"thumbnail": "default_profile_photo.png",
"profilePage": "https://www.sitejabber.com/users/user123",
"numReviews": 0,
"numHelpfulVotes": 1
},
"sender": {
"username": "user3",
"firstName": "John",
"lastName": "F",
"thumbnail": "default_profile_photo.png",
"profilePage": "https://www.sitejabber.com/users/user3",
"numReviews": 0,
"numHelpfulVotes": 1
}
},
{
"subject": "Business - 348289THX",
"body": "My new message1",
"review": {
"reviewNo": 3,
"rating": [
{
"type": "overall",
"rating": 2
},
{
"type": "service",
"rating": null
},
{
"type": "value",
"rating": null
},
{
"type": "shipping",
"rating": null
},
{
"type": "returns",
"rating": null
},
{
"type": "quality",
"rating": null
}
],
"title": "Dissapointed",
"content": "Dissapointed.",
"tip": null,
"order_id": "348289THX",
"published": "2017/01/04 03:35:20",
"edited": "",
"author": {
"username": "user123",
"firstName": "John",
"lastName": "D",
"thumbnail": "default_profile_photo.png",
"profilePage": "https://www.sitejabber.com/users/user123",
"numReviews": 0,
"numHelpfulVotes": 1
}
},
"created": "2017\/06\/30 02:57:59",
"recipient": {
"username": "user123",
"firstName": "John",
"lastName": "D",
"thumbnail": "default_profile_photo.png",
"profilePage": "https://www.sitejabber.com/users/user123",
"numReviews": 0,
"numHelpfulVotes": 1
},
"sender":{
"username": "user3",
"firstName": "John",
"lastName": "F",
"thumbnail": "default_profile_photo.png",
"profilePage": "https://www.sitejabber.com/users/user3",
"numReviews": 0,
"numHelpfulVotes": 1
}
}
],
"count":4,
"start":0,
"status":"OK",
"success":true
}
HTTP Request
GET https://api.sitejabber.com/v1/businesses/yourdomain.com/messages
Query Parameters
Parameter | Default | Description |
---|---|---|
start | 0 | starting offset |
count | 10 | number of messages to be included |
username | empty | get messages for specific user if given |
folder | inbox | inbox/sent for received or sent messages |
order | DESC | ASC/DESC order of the messages, ascending or descending |
Send message to user
curl -H "user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582" -d "review_no=2&subject=hello&body=my%20new%20message" "https://api.sitejabber.com/v1/businesses/yourdomain.com/message/send?client_token=myapikey"
<?php
$header = [
'user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582'
];
$post = [
'review_no' => '2',
'subject' => 'hello'
'body' => 'my new message'
];
$url = 'https://api.sitejabber.com/v1/businesses/yourdomain.com/message/send?client_token=myapikey';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, TRUE);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($post));
$res = curl_exec($ch);
curl_close($ch);
The above command returns (Status Object) JSON structured like this:
{
"status":"OK",
"success":true
}
HTTP Request
POST https://api.sitejabber.com/v1/businesses/yourdomain.com/message/send
Data
Parameter | Required | Description |
---|---|---|
review_no | true | number of review whose author will receive a message |
username | true | author that will receive a message |
subject | true | subject of the message |
body | true | content of the message |
Review Requests
Create review request
curl -H "user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582" -d "email=test@test.com&order_id=XHS2854&order_date=2017-04-28&first_name=John&last_name=Doe" "https://api.sitejabber.com/v1/businesses/yourdomain.com/review/request/add?client_token=myapikey"
<?php
$header = [
'user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582'
];
$post = [
'email' => 'test@test.com',
'order_id' => 'XHS2854',
'order_date' => '2017-04-28',
'first_name' => 'John',
'last_name' => 'Doe',
'return_link' => 1
];
$url = 'https://api.sitejabber.com/v1/businesses/yourdomain.com/review/request/add?client_token=myapikey';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, TRUE);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($post));
$res = curl_exec($ch);
curl_close($ch);
The above command returns (Status Object) JSON structured like this:
{
"status":"OK",
"success":true,
"link":"https://www.sitejabber.com/requested-review/request-key"
}
HTTP Request
POST https://api.sitejabber.com/v1/businesses/yourdomain.com/review/request/add
Data
Parameter | Required | Description |
---|---|---|
true | email of the customer | |
order_id | false | order id of the purchase |
order_date | false | order date of the purchase in yyyy-mm-dd format |
first_name | false | first name of the customer |
last_name | false | last name of the customer |
labels | false | comma separated labels to attach to the review after it’s completed by the customer |
return_link | false | (1 => true, 0 => false), if true, returns the link to complete the review, and doesn’t send the review request email |
Partners
Get write review link
Get the link to write a review for the given business
curl -H "user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582" "https://api.sitejabber.com/v1/partners/yourdomain.com/write-link/get?client_token=myapikey"
<?php
$header = [
'user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582'
];
$url = 'https://api.sitejabber.com/v1/partners/yourdomain.com/write-link/get?client_token=myapikey';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$res = curl_exec($ch);
curl_close($ch);
The above command returns (Partner Object) JSON structured like this:
{
"url":"https:\/\/www.sitejabber.com\/requested-review\/?hash=efadba6a49",
"hash":"efadba6a49",
"expire":"2018\/01\/13 10:48:37",
"status":"OK",
"success":true
}
HTTP Request
GET https://api.sitejabber.com/v1/partners/yourdomain.com/write-link/get
Get edit review link
Get the link to edit a review for the given user
curl -H "user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582" "https://api.sitejabber.com/v1/partners/yourdomain.com/edit-link/get?client_token=myapikey&email=user@email.com"
<?php
$header = [
'user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582'
];
$url = 'https://api.sitejabber.com/v1/partners/yourdomain.com/edit-link/get?client_token=myapikey&email=user@email.com';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$res = curl_exec($ch);
curl_close($ch);
The above command returns JSON structured like this:
{
"link":"https:\/\/www.sitejabber.com\/edit-review\/yourdomain.com\/1295",
"status":"OK",
"success":true
}
HTTP Request
GET https://api.sitejabber.com/v1/partners/yourdomain.com/edit-link/get
Products
Get Products
curl -H "user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582"
https://api.sitejabber.com/v1/businesses/yourdomain.com/products?client_token=myapikey
<?php
$header = [
'user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582'
];
$url = 'https://api.sitejabber.com/v1/businesses/yourdomain.com/products?client_token=myapikey';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$res = curl_exec($ch);
curl_close($ch);
This endpoint retrieves all products.
HTTP Request
GET https://api.sitejabber.com/v1/businesses/yourdomain.com/products
Query Parameters
Parameter | Default | Description |
---|---|---|
start | 0 | starting offset |
count | 10 | number of reviews to be included |
q | null | retrieve products matching given keyword |
brand | null | retrieve products matching brand |
categories | null | retrieve products in the given categories |
price_range | null | retrieve products in the given prices [min],[max] |
reviews_range | null | retrieve products with the given number of reviews [min],[max] |
product_id | null | retrieve the given product ID |
Add Product
curl -H "user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582"
-d "brand=sony&title=playstation&categories=games,ps3&price=129&attributes=pros:usability,automatic,control|cons:slow,big|user
%20experience:novice,expert" https://api.sitejabber.com/v1/businesses/yourdomain.com/products/add?client_token=myapikey
<?php
$header = [
'user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582'
];
$data = [
'brand' => 'sony',
'title' => 'playstation',
'categories' => 'games,ps3',
'price' => '129',
'attributes => 'pros:usability,automatic,control|cons:slow,big|user experience:novice,expert'
];
$url = 'https://api.sitejabber.com/v1/businesses/yourdomain.com/products/add?client_token=myapikey';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
$res = curl_exec($ch);
curl_close($ch);
This endpoint adds a new product.
HTTP Request
POST https://api.sitejabber.com/v1/businesses/yourdomain.com/products/add
Post Parameters
Parameter | Required | Description |
---|---|---|
title | true | product title |
brand | false | product brand |
categories | false | categories this product belongs to, comma separated |
price | false | product price |
retail_price | false | product retail price |
product_link | false | product link |
attributes | false | custom attributes for the product |
Attributes format: attribute_name1;type;required:option1,option2,…,optionN|attribute_name2;type;required:option1,….|….|attribute_nameN;type;required:option1,…
Remove Product
curl -H "user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582" -d "product_id=32" https://api.sitejabber.com/v1/businesses/yourdomain.com/products/remove?client_token=myapikey
<?php
$header = [
'user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582'
];
$data = [
'product_id' => '32'
];
$url = 'https://api.sitejabber.com/v1/businesses/yourdomain.com/products/remove?client_token=myapikey';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$res = curl_exec($ch);
curl_close($ch);
This endpoint removes a product.
HTTP Request
POST https://api.sitejabber.com/v1/businesses/yourdomain.com/products/remove
Post Parameters
Parameter | Required | Description |
---|---|---|
product_id | true | product ID |
Add Product Image
curl -H "user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582" -F "product_id=33" -F "qqfile=@/home/filename.jpg" \
https://api.sitejabber.com/v1/businesses/yourdomain.com/product/images/add?client_token=myapikey
<?php
$header = [
'user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582'
];
$data = [
'qqfile' => curl_file_create('/home/filename.jpg', 'image/jpg', 'filename.jpg'),
'product_id' => '33'
];
$url = 'https://api.sitejabber.com/v1/businesses/yourdomain.com/product/images/add?client_token=myapikey';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$res = curl_exec($ch);
curl_close($ch);
This endpoint adds a new image to an existing product.
HTTP Request
POST https://api.sitejabber.com/v1/businesses/yourdomain.com/product/images/add
Post Parameters
Parameter | Required | Description |
---|---|---|
product_id | true | product ID |
qqfile | true | image file |
The data needs to be sent using multipart POST data
Remove Product Image
curl -H "user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582" -F "product_id=32" \
-F "image_id=1947a3a48e7e17ee48b7d6bed20ea7a5" \
https://api.sitejabber.com/v1/businesses/yourdomain.com/product/images/remove?client_token=myapikey
<?php
$header = [
'user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582'
];
$data = [
'product_id' => '32',
'image_id' => '1947a3a48e7e17ee48b7d6bed20ea7a5'
];
$url = 'https://api.sitejabber.com/v1/businesses/yourdomain.com/product/images/remove?client_token=myapikey';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$res = curl_exec($ch);
curl_close($ch);
This endpoint removes a product image.
HTTP Request
POST https://api.sitejabber.com/v1/businesses/yourdomain.com/product/images/remove
Post Parameters
Parameter | Required | Description |
---|---|---|
product_id | true | product ID |
image_id | true | image ID |
Product Reviews
Get Product Reviews
curl -H "user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582"
https://api.sitejabber.com/v1/businesses/yourdomain.com/product/reviews?client_token=myapikey
<?php
$header = [
'user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582'
];
$url = 'https://api.sitejabber.com/v1/businesses/yourdomain.com/reviews?client_token=myapikey';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$res = curl_exec($ch);
curl_close($ch);
This endpoint get all product reviews.
HTTP Request
GET https://api.sitejabber.com/v1/businesses/yourdomain.com/product/reviews
Query Parameters
Parameter | Required | Description |
---|---|---|
start | 0 | starting offset |
count | 10 | number of reviews to be included |
q | null | retrieve products matching given keyword |
brand | null | retrieve products matching brand |
categories | null | retrieve products in the given categories |
price_range | null | retrieve products in the given prices [min],[max] |
reviews_range | null | retrieve products with the given number of reviews [min],[max] |
date_from | null | start date in format (yyyy-mm-dd) |
date_to | null | end date in format (yyyy-mm-dd) |
Add Product Review
curl -H "user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582" -d "product_id=12&title=playstation&content=very
%20good&rating=5&user_name=john&user_location=us&attributes=pros:usability|cons:bad"
https://api.sitejabber.com/v1/businesses/yourdomain.com/product/reviews/add?client_token=myapikey
<?php
$header = [
'user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582'
];
$data = [
'product_id' => '12',
'title' => 'playstation',
'content' => 'very good',
'rating' => '5',
'user_name' => 'john',
'user_location' => 'us',
'attributes => 'pros:usability|cons:bad'
];
$url = 'https://api.sitejabber.com/v1/businesses/yourdomain.com/reviews/add?client_token=myapikey';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
$res = curl_exec($ch);
curl_close($ch);
This endpoint adds a new product review.
HTTP Request
POST https://api.sitejabber.com/v1/businesses/yourdomain.com/product/reviews/add
Post Parameters
Parameter | Required | Description |
---|---|---|
product_id | true | product ID |
title | true | product review title |
content | true | product review content |
rating | true | product review rating |
user_name | false | name of the user writing the review |
user_location | false | location of the user writing the review |
attributes | false | values of attributes defined for the product |
Add Product Review Vote
curl -H "user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582" -d "review_id=22&vote=positive"
https://api.sitejabber.com/v1/businesses/yourdomain.com/product/reviews/vote?client_token=myapikey
<?php
$header = [
'user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582'
];
$data = [
'review_id' => '21',
'vote' => 'positive'
];
$url = 'https://api.sitejabber.com/v1/businesses/yourdomain.com/product/reviews/vote?client_token=myapikey';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
$res = curl_exec($ch);
curl_close($ch);
This endpoint makes a new vote on the given product review.
HTTP Request
POST https://api.sitejabber.com/v1/businesses/yourdomain.com/product/reviews/vote
Post Parameters
Parameter | Required | Description |
---|---|---|
review_id | true | product review ID |
vote | true | type of vote (positive/negative) |
Get top rated product
curl -H "user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582" "https://api.sitejabber.com/v1/businesses/yourdomain.com/product/reviews/top-rated?client_token=myapikey&category_name=Tablets¤cy=CAD"
<?php
$header = [
'user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582'
];
$url = 'https://api.sitejabber.com/v1/businesses/yourdomain.com/product/reviews/top-rated?client_token=myapikey&category_name=Tablets¤cy=CAD';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$res = curl_exec($ch);
curl_close($ch);
The above command returns JSON structured like this:
{
"products":[
{
"id":1,
"sku":"9998",
"brand":"Asus",
"title":"Asus i3 Laptop",
"categories":[
{
"category_name":"Laptops"
}
],
"price":99,
"retail_price":null,
"currency":"USD",
"product_link":"https:\/\yourdomain.com/asus-laptop",
"images":[
{
"url":"https:\/\/yourdomain.com/img/asus-laptop.jpg"
}
],
"attributes":[
],
"num_reviews":10,
"average_rating":3.5,
"created":"2017\/06\/13 13:47:39",
"category_name":"Laptops"
},
{
"id":2,
"sku":"9999",
"brand":"Sony",
"title":"Playstation 4",
"categories":[
{
"category_name":"Games"
}
],
"price":99,
"retail_price":null,
"currency":"USD",
"product_link":"https:\/\yourdomain.com/playstation-4",
"images":[
{
"url":"https:\/\/yourdomain.com/img/playstation.jpg"
}
],
"attributes":[
],
"num_reviews":14,
"average_rating":4.2,
"created":"2017\/06\/13 14:47:39",
"category_name":"Games"
},
....
],
"status":"OK",
"success":true
}
This endpoint get the top rated product for a given category. If no category is specified, all categories are returned with their respective top rated product.
HTTP Request
GET https://api.sitejabber.com/v1/businesses/yourdomain.com/product/reviews/top-rated
Post Parameters
Parameter | Required | Description |
---|---|---|
category_name | false | The name of category to get the top rated product |
currency | false | Add currency filter, used to filter by country |
Privacy
Access customer information
curl -H "user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582" -d "email=john@example.com" "https://api.sitejabber.com/v1/businesses/yourdomain.com/privacy/access?client_token=myapikey&email=john@example.com"
<?php
$header = [
'user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582'
];
$url = 'https://api.sitejabber.com/v1/businesses/yourdomain.com/privacy/access?client_token=myapikey&email=john@example.com';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$res = curl_exec($ch);
curl_close($ch);
The above command returns JSON structured like this:
{
"categories": [
"Identifiers": {,
"name": "John Doe",
"email": "john@example.com",
"address": "N/A",
"SSN": "N/A",
"accountName": "N/A",
"passportNumber": "N/A",
"driversLicense": "N/A",
"alias": "John Doe",
"uniqueIdentifier": "foobar",
"onlineIdentifier": "foobar",
"ipAddress": "8.8.8.256"
},
"Customer records information": {
"name": "John Doe"
"address": "N/A",
"phone": "456-xyz-4564",
"signature": "N/A",
"SSN": "N/A",
"passportNumber": "N/A",
"driversLicense": "N/A",
"stateCard": "N/A",
"insurance": "N/A",
"education": "N/A",
"employment": "N/A",
"bankAccountNumber": "N/A",
"creditDebitCards": "N/A",
"medicalInfo": "N/A",
"healthInsurance": "N/A"
},
"Protected classification info (race, gender)": "N/A",
"Commercial info": {
"productsOrServicesPurchased": [
{
"website": "example.com",
"title": "TV 65\" QLED Smart 4k",
"orderId": 'XYZ-1',
"orderDate": '2017-05-01T16:15:14-03:00'
},
{
"website": "example.com",
"title": "Mini Home Theater Sound Bar System",
"orderId": 'XYZ-2',
"orderDate": '2017-05-01T16:15:14-03:00'
}
]
},
"Biometric info": "N/A",
"Internet or electronic activity": {
"browsingHistory": "N/A",
"searchHistory": "N/A",
"consumerInteractions": [
"example.com"
]
},
"Geolocation data": "N/A",
"Audio, electric, visual, thermal, olfactory": "N/A",
"Professional or employment related": "N/A",
"Education info": "N/A",
"Inferences": "N/A",
],
"status":"OK",
"success":true
}
HTTP Request
GET https://api.sitejabber.com/v1/businesses/yourdomain.com/privacy/access
Query Parameters
Parameter | Required | Description |
---|---|---|
true | user’s email |
Remove customer information
curl -H "user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582" -d "email=john@example.com" "https://api.sitejabber.com/v1/businesses/yourdomain.com/privacy/remove?client_token=myapikey"
<?php
$header = [
'user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582'
];
$post = [
'email' => 'john@example.com'
];
$url = 'https://api.sitejabber.com/v1/businesses/yourdomain.com/privacy/remove?client_token=myapikey';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, TRUE);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($post));
$res = curl_exec($ch);
curl_close($ch);
The above command returns JSON structured like this:
{
"status":"OK",
"success":true
}
HTTP Request
POST https://api.sitejabber.com/v1/businesses/yourdomain.com/privacy/remove
Data
Parameter | Required | Description |
---|---|---|
true | user’s email |
Rate Limit
You are allowed 1000 calls per hour for each unique user token.
You can’t make more than 10 calls in a 10 second window, and you can’t make more than 1000 calls in a 1 hour window.
If you exceed your rate limit for a given endpoint, you’ll get a 429 “Too many requests” error code.
Errors
The Sitejabber API uses the following error codes:
Error Code | Reason |
---|---|
101 | Client token invalid |
102 | Client token access revoked |
201 | Email or password invalid |
202 | User access has been disabled |
203 | User token missing or invalid |
204 | User session is invalid |
205 | Fatal error creating user access |
206 | User access is invalid |
207 | User token is expired |
301 | Business not available |
302 | Missing parameter |
303 | Limit exceeded |
304 | Email already exists |
305 | The review does not exist |
306 | Parameter bad formatted |
307 | User not found |
308 | Insufficient permissions |
399 | Unexpected error |
401 | Product does not exist |
402 | Image does not exist |
403 | Product review does not exist |
404 | Can vote only once every 24 hours |
429 | Rate limit, too many requests |