Skip to content

Retrieve summary

Get a summary of all ratings.

GET /1.0/ratings_summary.json

Query parameters

They should be passed as query parameters to the URL. (ex.: ?id=1&code=abc)

id int (required)

The unique webshop ID.

code string (required)

Your personal API code.

Example response

    "status": "success",
    "message": "Rating summary successfully retrieved!",
    "data": {
        "amount": 26,
        "rating_average": 4.194546, // Ratings scale 1-5
        "ratings_average": {
            "shippingtime": 4.851756,
            "customerservice": 4.658711,
            "pricequality": 3.678985,
            "aftersale": 4.087224

Response statuses

status message Explanation
success Ratings summary successfully retrieved!
error Not all obligated variables are set. One or more of the required variables (id, code) has/have not been set.
error Incorrect authentication credentials. The combination id and code is invalid.
error Unexpected error while processing. Please contact WebwinkelKeur. An unexpected error has occurred. This will probably only be solvable by the WebwinkelKeur team.

Example code


$id = 1;
$code = '123456789abc123456789';

$curl = curl_init(

curl_setopt_array($curl, [

$response = curl_exec($curl);

if ($response !== false) {
    $data = json_decode($response, true);

    $data will look similar to the format below:

    $data = [
        "status" => "success",
        "message" => "Ratings summary successfully retrieved!",
        "data" => See example
} else {
    // An error occurred