NAV Navbar
shell php

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
email 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
email 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
email 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 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 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&currency=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&currency=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
email 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
email 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
shell php