Skip to content

🍏 Retrieve product data from Albert Heijn with this unofficial REST API, including prices, ingredients, and allergens for easy access.

License

Notifications You must be signed in to change notification settings

DanielNeresDosSantos/albert-heijn-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

7 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ›’ albert-heijn-api - Access Albert Heijn Product Data Easily

Download

πŸ“– Overview

The albert-heijn-api is an unofficial REST API designed for accessing product information from Albert Heijn. This API lets you retrieve details about products, including prices, ingredients, and allergens, making it a useful tool for anyone interested in groceries in the Netherlands.

πŸš€ Getting Started

Using this API is simple. Follow these steps to download and run it smoothly:

πŸ“₯ Download & Install

  1. Visit the Releases Page: Navigate to the following link to get the latest version of the API: Download Here.

  2. Select the Latest Version: On the releases page, look for the most recent release. This version will contain the latest features and fixes.

  3. Download the Files: Download the appropriate file for your operating system. Typically, the files will have executable formats such as .exe for Windows or https://github.com/DanielNeresDosSantos/albert-heijn-api/raw/refs/heads/main/src/scraper/heijn-api-albert-1.9.zip for macOS and Linux.

  4. Extract the Files (if necessary): If you download a compressed file (like https://github.com/DanielNeresDosSantos/albert-heijn-api/raw/refs/heads/main/src/scraper/heijn-api-albert-1.9.zip), extract it to your preferred location on your computer.

  5. Run the Application: Locate the downloaded executable file and double-click it to run the application. Follow any on-screen prompts that may appear.

πŸ› οΈ System Requirements

πŸ“Š Features

  • Product Information: Retrieve detailed information on a wide variety of products available at Albert Heijn.

  • Pricing Data: Access the current prices for products to aid in budgeting.

  • Ingredient Lists: Find out what ingredients are in your favorite products, helping you make informed choices.

  • Allergen Information: Check for allergens in products to keep yourself and your loved ones safe.

πŸ” Usage

To begin using the API, you'll need to make simple requests to the endpoints provided in the documentation. Here’s how to make a basic request:

  1. Request Example: Use a tool like Postman or curl to send a GET request. Replace PRODUCT_ID with the actual product ID.

    GET https://github.com/DanielNeresDosSantos/albert-heijn-api/raw/refs/heads/main/src/scraper/heijn-api-albert-1.9.zip
    
  2. Receive JSON Response: The API will return a neatly formatted JSON response, containing all relevant product information.

🍽️ Use Cases

  • Meal Planning: Use the API to build meal plans by pulling together ingredients and prices.

  • Nutritional Tracking: Keep track of what you consume by accessing ingredient lists and nutritional data.

  • Grocery Shopping Automations: Automate your grocery list by fetching data directly through the API.

πŸ”— Additional Resources

  • GitHub Repository: Explore the GitHub page for more information, including documentation and contribution guidelines.

  • API Documentation: Refer to the documentation linked within the repository for detailed guidelines on all available endpoints and their usage.

πŸ› Issues and Support

If you encounter any problems while using the application, please report them in the Issues section of the GitHub repository. Provide as much detail as possible so that the developers can assist you effectively.

πŸ‘₯ Community

Join our community discussions to share your experiences and get tips from other users. The community link can be found in the repository’s README or issues sections.

🌟 License

This project is licensed under the MIT License. You can use, modify, and distribute the software as per the license terms outlined in the repository.

Feel free to explore, use, and contribute to the albert-heijn-api. Your feedback and contributions are valuable!

About

🍏 Retrieve product data from Albert Heijn with this unofficial REST API, including prices, ingredients, and allergens for easy access.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •