Please note: We have not updated our database since long time. Contact us for more.

API Documentation

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.

Protocol
REST
Data Formats
Currently supported: XML, JSON [.js]
JSON requests also allow use of callback function using 'callback' parameter.
Authentication
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
200OKEverything is fine.
400Bad RequestInvalid request. Response will be an error message explaining the reason.
401Not AuthorizedAuthentication credentials are missing or invalid.
404Not FoundResource does not exist or you're requesting an invalid URI.
500Internal Server ErrorOops! we did something wrong. Please contact us at quarkrank@gmail.com
Rate Limit
None. Please let us know beforehand if you will be generating huge amount of traffic to our site.
Methods
  1. 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

    Response example:

    Loading...



  2. 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

    Parameters:
    • 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.

    Output:
    • 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]

    Response example:

    Loading...


  3. Product Search

    Returns the matching products for this search string


    Parameters: None
    Output: Matching items with same details as in item listing
    Each "product" item will contain additional attribute product_type which tells category of product


  4. Get snippets for a feature

    Returns the first 100 snippets for this feature

    Example:
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...