We provide a RESTful API to access our huge repository of reviews summarized by sentiment analysis. Send us simple HTTP requests and we will send back basic XML responses, which means you can interact with our API from any language.
- Data Formats
- Currently supported: XML, JSON [.js]
JSON requests also allow use of callback function using 'callback' parameter.
- To start with, we support HTTP Basic Authentication. Username and password are authentication parameters, required in all the methods. (Please Register here to have one)
- HTTP status codes
200 OK Everything is fine. 400 Bad Request Invalid request. Response will be an error message explaining the reason. 401 Not Authorized Authentication credentials are missing or invalid. 404 Not Found Resource does not exist or you're requesting an invalid URI. 500 Internal Server Error Oops! we did something wrong. Please contact us at firstname.lastname@example.org
- Rate Limit
- None. Please let us know beforehand if you will be generating huge amount of traffic to our site.
- Get List of Products
Returns list of products given a category. Possible use to generate product listing.Parameters:
- category (Required Parameter): one of [camera, cellphone, flatpaneltv, mp3player]
- page (Optional): Page number
- count (Optional): How many products to return per page. Minimum value can be 10 while maximum can be 30.
Response: For each product following values are returned
- Name, QuarkRank, buzz, navigation specifactions (eg. opticalzoom for cameras)
- Top 5 features and Worst 3 features for this product from review sentiment analysis
- Matching amazon's asin and shopping.com's product id
- Get information for a product
To get complete detail for a given product.
This can be used in two ways:
- Using the sku of the product at quarkrank
- Using amazon's asin or shopping.com's product ID
- id (Required): sku of the product at quarkrank/amazon/shopping.com
- site (Optional): This is required parameter if you are using amazon or shopping.com id. Value is one of [amazon, shopping]
- all_features(Optional): How many features to return for this product. Minimum value is 10 and you can ask for all with value "true". Default value is 10.
- Name, QuarkRank, buzz, navigation specifications (eg. opticalzoom for cameras)
- Top 5 features and Worst 3 features , top 10 features (buzz wize) from review sentiment analysis
- Matching Amazon's asin and Shopping.com's product id
- Top 10 snippets for each feature.
Mapping of feature name to snippets is done using feature id. Each of the feature contains an attribute feature_id
Each bundle of snippets, is wrapped with element name snippet_[snippet_id]
- Product Search
Returns the matching products for this search string
Output: Matching items with same details as in item listing
Each "product" item will contain additional attribute product_type which tells category of product
- Get snippets for a feature
Returns the first 100 snippets for this featureExample:
- Get List of Products
- Ruby on Rails
ActiveResource can be used to access our RESTful API in Ruby on Rails.
Note : You need to apply this tiny patch to ActiveResource.Following is the sample usage :Loading...