sybersarki/local-market-price-checker
Domain:
socioeconomicRecord type:
software
Creator:
syb
Host:
A containerized Flask REST API for reporting and searching local market prices in Nigeria — built for the 3MTT Cloud Computing capstone (containerize & deploy).
# Local Market Price Checker
A simple REST API that lets people report and look up prices of everyday
items (food, commodities, etc.) across different local markets.
## Problem it solves
Buyers and traders often have no easy way to check what an item "should"
cost across nearby markets, which makes it easier to get overcharged or to
under-price goods unknowingly. This app lets anyone submit a price report
(item, market, location, price) and lets anyone else search reported
prices before they go shopping or selling.
## Tech stack
- **Python 3.12 / Flask** — REST API
- **SQLite** — lightweight embedded database (no external DB service needed)
- **Gunicorn** — production WSGI server
- **Docker** — containerization
- Deployed on **Render**
## Live demo
🔗 `local-market-price-checker.…`
🐳 **Docker Hub:** `hub.docker.com`
## API Endpoints
| Method | Endpoint | Description |
|--------|----------------------|------------------------------------------------|
| GET | `/` | Health check |
| POST | `/prices` | Add a new price report |
| GET | `/prices` | List/search price reports |
| GET | `/prices/ ` | Get a single price report |
| DELETE | `/prices/ ` | Delete a price report |
### Search / filter
`GET /prices` supports optional query params:
- `?item=rice`
- `?market=ariaria`
- `?location=aba`
These can be combined, e.g. `GET /prices?item=rice&location=aba`.
### Example: add a price report
```bash
curl -X POST localhost \
-H "Content-Type: application/json" \
-d '{
"item": "Rice (50kg bag)",
"market": "Ariaria Market",
"location": "Aba, Abia",
"price": 75000,
"unit": "bag"
}'
```
Response:
```json
{
"id": 1,
"item": "Rice (5 …