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 |
| createdRFC | DateTime/String | No | Same as created but in format RFC 3339 |
| published | DateTime/String | No | If the review is not yet published, it’ll contain the string pending |
| publishedRFC | DateTime/String | No | Same as published but in format RFC 3339 |
| edited | DateTime | Yes | DateTime the review was edited |
| editedRFC | DateTime | Yes | Same as edited but in format RFC 3339 |
| removedRFC | DateTime | Yes | DateTime the review was removed in format RFC 3339 (only available if the review is removed) |
| 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 |
| createdRFC | DateTime | No | Same as created but in format RFC 3339 |
| published | DateTime | No | DateTime the comment was published |
| publishedRFC | DateTime | No | Same as published but in format RFC 3339 |
| 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 |
| createdRFC | DateTime | No | Same as created but in format RFC 3339 |
| 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 |
Product Object
| Name | Type | Optional | Description |
|---|---|---|---|
| id | Integer | No | Internal product ID |
| sku | String | No | SKU of the product |
| item_group | String | Yes | Used to group similar products together |
| gtin | String | Yes | GTIN of the product |
| mpn | String | Yes | MPN of the product |
| brand | String | Yes | Brand of the product |
| title | String | Yes | Title of the product |
| description | String | Yes | Description of the product |
| categories | ProductCategory object | Yes | Product categories |
| price | Float | Yes | Price of the product |
| retail_price | Float | Yes | Retail price of the product |
| currency | String | Yes | Currency of the product |
| product_link | String | Yes | Url link to the product’s page |
| images | ProductImage object | Yes | Product images |
| attributes | ProductAttribute object | Yes | Customer attributes |
| num_reviews | Integer | No | Number of product reviews |
| average_rating | Float | No | Average rating of the product reviews |
| created | DateTime | No | Creation date of the product |
| createdRFC | DateTime | No | Same as created but in format RFC 3339 |
ProductImage Object
| Name | Type | Optional | Description |
|---|---|---|---|
| caption | String | No | Caption of the image |
| original | String | No | Url of the image original size |
| normal | String | No | Url of the image normal size, max width 600px |
| large | String | No | Url of the image thumbnail large size 160x160 |
| small | String | No | Url of the image thumbnail small size 96x96 |
| created | DateTime | No | Creation date of the image |
| createdRFC | DateTime | No | Same as created but in format RFC 3339 |
ProductReview Object
| Name | Type | Optional | Description |
|---|---|---|---|
| id | Integer | No | Internal product review ID |
| title | String | No | Title of the review |
| content | String | No | Content of the review |
| rating | Integer | No | Rating of the review |
| order_id | String | Yes | Order number for the review |
| user | User object | No | Author of the review |
| user_location | String | Yes | Location of the user |
| attributes | ProductAttribute | Yes | Custom attributes |
| images | ProductImage | Yes | Array of customer product images |
| solicited | Integer | No | Defines if the review was solicited or not, values are Yes/No |
| votes | Integer | No | Number of votes |
| num_positive_votes | Integer | No | Number of positive votes |
| num_negative_votes | Integer | No | Number of negative votes |
| published | DateTime | No | Publication date of the product |
| publishedRFC | DateTime | No | Same as published but in format RFC 3339 |
| created | DateTime | No | Creation date of the product |
| createdRFC | DateTime | No | Same as created but in format RFC 3339 |
| product | Product object | No | Product of the review |
| updated_for | ProductReview object | Yes | If this is an updated review, this will contain the original review |
| removedRFC | DateTime | Yes | DateTime the product review was removed in format RFC 3339 (only available if the product review is removed) |
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",
"createdRFC" : "2015-11-06T12:01:45-07:00",
"published" : "2015-11-06 12:01:45",
"publishedRFC" : "2015-11-06T12:01:45-07:00",
"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",
"createdRFC": "2016/04/25T04:07:38-07:00",
"published": "2016/04/25 04:07:38",
"publishedRFC": "2016/04/25T04:07:38-07:00",
"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",
"createdRFC" : "2015-11-06T12:01:45-07:00",
"published" : "2015-11-07 12:01:45",
"publishedRFC" : "2015-11-07T12:01:45-07:00",
"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) |
| deleted | false | returns only deleted 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",
"createdRFC":"2016\/01\/25T06:31:47-07:00",
"published":"2016\/01\/25 06:31:47",
"publishedRFC":"2016\/01\/25T06:31:47-07:00",
"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",
"createdRFC": "2017\/07\/10T12:45:44-07:00",
"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",
"createdRFC": "2017\/07\/07T02:31:44-07:00",
"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",
"createdRFC": "2017\/07\/05T11:07:31-07:00",
"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",
"publishedRFC": "2017/01/04T03:35:20-07:00",
"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",
"createdRFC": "2017\/06\/30T02:57:59-07:00",
"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 | true | order id of the purchase |
| order_date | true | 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);
The above command returns (Array of Product Object) JSON structured like this:
{
"products": [
{
"id": 26,
"sku": "4770",
"item_group": "4770_group",
"gtin": null,
"mpn": null,
"brand": "Nintendo",
"title": "Nintendo Switch Super Mario Bundle",
"description": null,
"categories": [
{
"category_name": "Gaming"
}
],
"price": 529,
"retail_price": null,
"currency": "USD",
"product_link": "https://xyz.xyz/ProductDetail/4770",
"images": [
{
"url": "https://xyz.xyz/img/4770.jpg"
}
],
"attributes": [],
"num_reviews": 26,
"average_rating": 4.54,
"created": "2018/07/13 01:18:35",
"createdRFC": "2018/07/13T01:18:35-07:00"
}
],
"count": 10,
"start": 0,
"query": null,
"status": "OK",
"success": true
}
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 |
| sku | null | retrieve the given product by sku |
| gtin | null | retrieve the given product by gtin |
| mpn | null | retrieve the given product by mpn |
| 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 |
|---|---|---|
| sku | true | product sku |
| item_group | false | product item group |
| gtin | false | product gtin |
| mpn | false | product mpn |
| title | true | product title |
| description | false | product description |
| brand | false | product brand |
| categories | false | categories this product belongs to, comma separated |
| currency | false | product currency |
| price | false | product price |
| retail_price | false | product retail price |
| product_link | false | product link |
| image_url | false | product image url |
| 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/product/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 ProductReview Object) JSON structured like this:
{
"product_reviews": [
{
"id": 26147,
"title": "VERY VERY FUN",
"content": "I bought 2 of these, we use them both everyday",
"rating": 5,
"order_id": "XYZ123",
"user": {
"username": "user123",
"firstName": "John",
"lastName": "D",
"thumbnail": "https://www.sitejabber.com/img/stock_photos/536/thumbnail_small.1582290982.jpg",
"profilePage": "https://www.sitejabber.com/users/user123",
"numReviews": 0,
"numHelpfulVotes": 0
},
"user_location": null,
"attributes": [],
"images": [
{
"caption": "",
"original": "https://www.sitejabber.com/img/products/4770/picture_25.1615306739.jpg",
"normal": "https://www.sitejabber.com/img/products/4770/thumbnail_25_normal.1615306739.jpg",
"large": "https://www.sitejabber.com/img/products/4770/thumbnail_25_large.1615306739.jpg",
"small": "https://www.sitejabber.com/img/products/4770/thumbnail_25_small.1615306739.jpg",
"created": "2020/02/18 08:19:04",
"createdRFC": "2020/02/18T08:19:04-07:00"
},
{
"caption": "",
"original": "https://www.sitejabber.com/img/products/4770/picture_26.1615306741.jpg",
"normal": "https://www.sitejabber.com/img/products/4770/thumbnail_26_normal.1615306740.jpg",
"large": "https://www.sitejabber.com/img/products/4770/thumbnail_26_large.1615306741.jpg",
"small": "https://www.sitejabber.com/img/products/4770/thumbnail_26_small.1615306741.jpg",
"created": "2020/02/19 08:19:04",
"createdRFC": "2020/02/19T08:19:04-07:00"
}
],
"solicited": "Yes",
"votes": 0,
"num_positive_votes": 0,
"num_negative_votes": 0,
"published": "2019/11/06 06:00:02",
"publishedRFC": "2019/11/06T06:00:02-07:00",
"created": "2019/11/05 08:41:29",
"createdRFC": "2019/11/05T08:41:29-07:00",
"product": {
"id": 26,
"sku": "4770",
"item_group": "4770_group",
"gtin": null,
"mpn": null,
"brand": "Nintendo",
"title": "Nintendo Switch Super Mario Bundle",
"description": null,
"categories": [
{
"category_name": "Gaming"
}
],
"price": 529,
"retail_price": null,
"currency": "USD",
"product_link": "https://xyz.xyz/ProductDetail/4770",
"images": [
{
"url": "https://xyz.xyz/img/4770.jpg"
}
],
"attributes": [],
"num_reviews": 26,
"average_rating": 4.54,
"created": "2018/07/13 01:18:35",
"createdRFC": "2018/07/13T01:18:35-07:00"
}
},
],
"count": 1,
"start": 0,
"query": null,
"status": "OK",
"success": true
}
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 |
| sku | false | retrieve reviews for the given product sku |
| item_group | false | retrieve reviews for the given group of products, if specified sku is ignored |
| q | false | retrieve product reviews matching given keyword |
| brand | false | retrieve products matching brand |
| categories | false | retrieve products in the given categories |
| only_photos | false | retrieve product reviews containing customer product images, default 0 (1=Yes, 0=No) |
| price_range | false | retrieve products in the given prices [min],[max] |
| reviews_range | false | retrieve products with the given number of reviews [min],[max] |
| deleted | false | returns only deleted product reviews (0 or 1) |
| date_from | false | start date in format (yyyy-mm-dd hh:mm:ss) [hh:mm:ss] is optional |
| date_to | false | end date in format (yyyy-mm-dd hh:mm:ss) [hh:mm:ss] is optional |
Add Product Review
curl -H "user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582" -F "sku=26" -F "title=playstation" -F "content=very%20good" -F "rating=5" -F "caption1=my%20flowers" -F "caption2=more%20flowers" -F "image1=https://img.server.xyz/image.jpg" -F "image2=@/home/filename.jpg" "https://api.sitejabber.com/v1/businesses/yourdomain.com/product/reviews/add?client_token=myapikey"
<?php
$header = [
'user_token: 5922b0ad07f849330de5af5c07fdd27ead7f4582'
];
$data = [
'sku' => '26',
'title' => 'playstation',
'content' => 'very good',
'rating' => '5',
'image1' => curl_file_create('/home/filename.jpg', 'image/jpg', 'filename.jpg'),
'caption1' => 'my flowers',
'image2' => 'https://img.server.xyz/image.jpg',
'caption2' => 'more flowers'
];
$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);
The above command returns (Status Object) JSON structured like this:
{
"product_review": {
"id": 26147,
"title": "VERY VERY FUN",
"content": "I bought 2 of these, we use them both everyday",
"rating": 5,
"order_id": "XYZ123",
"user": {
"username": "user123",
"firstName": "John",
"lastName": "D",
"thumbnail": "profile-default@2x.png",
"profilePage": "https://www.sitejabber.com/users/user123",
"numReviews": 0,
"numHelpfulVotes": 0
},
"user_location": null,
"attributes": [],
"images": [
{
"caption": "My flowers",
"original": "https://www.sitejabber.com/img/products/26/picture_66.1617116820.jpg",
"normal": "https://www.sitejabber.com/img/products/26/thumbnail_66_normal.1617116820.jpg",
"large": "https://www.sitejabber.com/img/products/26/thumbnail_66_large.1617116820.jpg",
"small": "https://www.sitejabber.com/img/products/26/thumbnail_66_small.1617116820.jpg",
"created": "2020/03/30 08:07:00",
"createdRFC": "2020-03-30T08:07:00-03:00"
},
{
"caption": "More flowers",
"original": "https://www.sitejabber.com/img/products/26/picture_67.1617116820.jpg",
"normal": "https://www.sitejabber.com/img/products/26/thumbnail_67_normal.1617116820.jpg",
"large": "https://www.sitejabber.com/img/products/26/thumbnail_67_large.1617116820.jpg",
"small": "https://www.sitejabber.com/img/products/26/thumbnail_67_small.1617116820.jpg",
"created": "2020/03/30 08:07:00",
"createdRFC": "2020-03-30T08:07:00-03:00"
}
],
"solicited": "Yes",
"votes": 0,
"num_positive_votes": 0,
"num_negative_votes": 0,
"published": "2019/11/06 06:00:02",
"publishedRFC": "2019/11/06T06:00:02-07:00",
"created": "2019/11/05 08:41:29",
"createdRFC": "2019/11/05T08:41:29-07:00",
"product": {
"id": 26,
"sku": "4770",
"item_group": "4770_group",
"gtin": null,
"mpn": null,
"brand": "Nintendo",
"title": "Nintendo Switch Super Mario Bundle",
"description": null,
"categories": [
{
"category_name": "Gaming"
}
],
"price": 529,
"retail_price": null,
"currency": "USD",
"product_link": "https://xyz.xyz/ProductDetail/4770",
"images": [
{
"url": "https://xyz.xyz/img/4770.jpg"
}
],
"attributes": [],
"num_reviews": 26,
"average_rating": 4.54,
"created": "2018/07/13 01:18:35",
"createdRFC": "2018/07/13T01:18:35-07:00"
}
},
"status": "OK",
"success": true
}
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 |
|---|---|---|
| sku | true | product SKU |
| title | true | product review title |
| content | true | product review content |
| rating | true | product review rating |
| order_id | false | product review order id |
| first_name | false | first name of the user writing the review |
| last_name | false | last name of the user writing the review |
| false | email 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 |
| image{n} | false | can be used to send multiple images (image1, image2, …., image{n}) it can be image binary data or url pointing to image file, the image are uploaded in the order specified |
| caption{n} | false | can be used to set a caption for the image (caption1, caption2, …., caption{n}) |
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",
"createdRFC":"2017\/06\/13T13:47:39-07:00",
"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",
"createdRFC":"2017\/06\/13T14:47:39-07:00",
"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 |