Go back to Partigi API Documentation

reviews/index

Returns a list of reviews obtained from the given conditions..

URL:

http://www.partigi.com/api/v1/reviews/index.format

Formats:

atom, json (more about JSON responses)

HTTP Methods:

GET

Authentication Mode:

read-only

Parameters:

Required:

• user_id: The ID or the login of the user from which retrieve the reviews.

or

• item_id: The ID or the nicetitle of the item from which to retrieve the reviews.
• item_type: The type of the item (see item types page). (Only required if you use item_id).

Optional: 

• item_type: The type of the item (see item types page). (Only optional if you use user_id).
• per_page: The number of results per page to retrieve, from 1 up to 100. By default retrieves 10 elements.
• page: The page from which retrieve the results. By default is 1.
• status: Filter reviews by the status (see available review status page). The default value is all.
• purchased_status: Filter reviews by the purchased_status (see available review status page). The default value is all.
• order: The order in which to return the reviews (asc or desc), sorted by time of modification.
• rating: The rating given by the user to the item reviewed. All the reviews returned will have that rating.
• from_rating: The minimum rating given by the user to the item reviewed. All the reviews returned will have at least that rating or a value greater.
• upto_rating: The maximum rating given by the user to the item reviewed. All the reviews returned will have that value at most.

Example requests:

•  http://www.partigi.com/api/v1/reviews/index.atom?item_id=pulp-fiction&item_type=film&status=1 would retrieve all the 'I have seen' reviews for Pulp Fiction.

Go back to Partigi API Documentation