Documentation

This API provides a simple way to get shopping lists. Perfect for educational projects, testing and prototyping applications where shopping list functionality is required.

The API does not require authentication and is completely free. You can use it in your projects without restrictions.

If you pass the GET parameter '?purchases=all' to the API, it will return all purchases in the database. With the GET parameter '?date=YYYY-MM-DD', the API will return the shopping list for the specified date and the total purchase amount. GET parameters '?date1=YYYY-MM-DD&date2=YYYY-MM-DD' will allow the API to return the shopping list in the range from 'date1' to 'date2'.

Main Features

  • Generating shopping lists
  • Simple HTTP interface
  • JSON response format
  • No authentication required
  • Free and without limitations
  • CORS support

Response Format


{"purchases":
[{"id":"1","item_name":"Bread","amount":"1.20","purchased_at":"2025-11-01"},{"id":"2","item_name":"Milk","amount":"2.50","purchased_at":"2025-11-01"},{"id":"3","item_name":"Cheese","amount":"4.80","purchased_at":"2025-11-01"},{"id":"4","item_name":"Apples","amount":"3.10","purchased_at":"2025-11-01"},{"id":"5","item_name":"Meat","amount":"7.90","purchased_at":"2025-11-01"},{"id":"6","item_name":"Coffee","amount":"5.50","purchased_at":"2025-11-02"},{"id":"7","item_name":"Tea","amount":"2.30","purchased_at":"2025-11-02"}, ...}]
}

{"Purchases for 2025-11-01":
[{"item_name":"Bread","amount":"1.20"},{"item_name":"Milk","amount":"2.50"},{"item_name":"Cheese","amount":"4.80"},{"item_name":"Apples","amount":"3.10"},{"item_name":"Meat","amount":"7.90"}]
}

{"Total purchases for 2025-11-01":"19.50"}

{"Purchases for 2025-11-01":
[{"item_name":"Bread","amount":"1.20"},{"item_name":"Milk","amount":"2.50"},{"item_name":"Cheese","amount":"4.80"},{"item_name":"Apples","amount":"3.10"},{"item_name":"Meat","amount":"7.90"},{"item_name":"Coffee","amount":"5.50"},{"item_name":"Tea","amount":"2.30"},{"item_name":"Chocolate","amount":"3.75"},{"item_name":"Flour","amount":"1.80"},{"item_name":"Rice","amount":"2.10"},{"item_name":"Sugar","amount":"2.60"},{"item_name":"Salt","amount":"0.90"},{"item_name":"Butter","amount":"3.40"},{"item_name":"Chicken","amount":"6.80"},{"item_name":"Cookies","amount":"2.20"},{"item_name":"Yogurt","amount":"1.50"},{"item_name":"Kefir","amount":"1.70"},{"item_name":"Bananas","amount":"2.90"},{"item_name":"Oranges","amount":"3.30"},{"item_name":"Pears","amount":"3.00"}]
}

{"Total purchases from 2025-11-01 to 2025-11-04":"63.25"}