vellen/sofia-supermarkets-api

An API to retrieve products information from supermarkets in Sofia, Bulgaria.

sofia-supermarkets-api

An API to retrieve products information from supermarkets in Sofia.

If you like my work, you can buy me a coffee.

Websites using the API

• Алкохол на оферта

Supported supermarkets

• Billa

Gets products information from https://ssbbilla.site/. Images are retrieved based on the first result in google image search.

• Fantastico

Downloads the pdf brochures available on https://www.fantastico.bg/special-offers and parses the products information in them. Images are retrieved based on the first result in google image search.

• Kaufland

Gets products information from https://www.kaufland.bg/.

• Lidl

Gets products information from https://www.lidl.bg/.

• T-Market

Gets products information from https://tmarketonline.bg/.

• METRO
• Kam Market
• CBA
• ProMarket
• Hit Max

Tech Stack

• Kotlin
• Gradle
• Spring Boot

Running Locally

Install JDK 15 or above from here

• Unix ./gradlew bootRun
• Windows gradlew.bat bootRun

The following environment variables need to be set prior to running

• DB_USERNAME
• DB_PASSWORD
• GOOGLE_API_KEY
• CLOUDINARY_API_SECRET

Navigate to http://localhost:8080/swagger-ui.html to check the API documentation and test the endpoints