{"id":42474194,"url":"https://github.com/gntouts/eltrak","last_synced_at":"2026-01-28T10:13:40.708Z","repository":{"id":40558686,"uuid":"323669555","full_name":"gntouts/eltrak","owner":"gntouts","description":"eltrak intends to become a free to use API to get shipping status for Greek courier services.","archived":false,"fork":false,"pushed_at":"2022-11-26T19:16:45.000Z","size":104,"stargazers_count":13,"open_issues_count":0,"forks_count":4,"subscribers_count":4,"default_branch":"main","last_synced_at":"2023-03-10T08:42:16.072Z","etag":null,"topics":["acs","api-rest","courier","courier-tracking","elta","fastapi","greece","python","speedex"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gntouts.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-12-22T15:53:00.000Z","updated_at":"2023-01-04T11:03:42.000Z","dependencies_parsed_at":"2023-01-22T21:31:01.485Z","dependency_job_id":null,"html_url":"https://github.com/gntouts/eltrak","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"purl":"pkg:github/gntouts/eltrak","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gntouts%2Feltrak","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gntouts%2Feltrak/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gntouts%2Feltrak/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gntouts%2Feltrak/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gntouts","download_url":"https://codeload.github.com/gntouts/eltrak/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gntouts%2Feltrak/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28844011,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-28T07:39:25.367Z","status":"ssl_error","status_checked_at":"2026-01-28T07:39:24.487Z","response_time":57,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["acs","api-rest","courier","courier-tracking","elta","fastapi","greece","python","speedex"],"created_at":"2026-01-28T10:13:40.083Z","updated_at":"2026-01-28T10:13:40.695Z","avatar_url":"https://github.com/gntouts.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# eltrak\n\n## Heroku\n\nHeroku Free tier is now terminated, so the app is no longer publicly available. All links in the README using the `https://eltrak.herokuapp.com` URL are invalid. I will try to host it somewhere else soon. In the meantime, you can easily deploy `eltrak` yourself. Sorry for the inconvenience.\n\n## Introduction\n\n**eltrak** intends to become a free to use API to get shipping status for Greek courier services.\n\nCurrently, it supports **ACS, Elta, Geniki Taxydromiki, Speedex Courier, Skroutz Last Mile and EasyMail Courier**. Due to lack of tracking numbers in a variety of states to test with, some errors are to be expected.\n\n**Geniki Taxidromiki is causing Internal Server Errors due to Amazon Cloudfront blocking access from Heroku dynos. Trying to find a proxy solution.**\n\nOther Greek courier services will follow, if I can find more tracking codes.\n\n### Usage\n\nSimply, perform a GET request to the following URL:\n\n`https://eltrak.herokuapp.com/v2/track/[COURIER]/[TRACKINGNUMBER]`\n\nFor example in Python:\n\n```python\nimport requests\nres = requests.get('https://eltrak.herokuapp.com/v1/track/speedex/010011110101')\nprint(res.json())\n```\n\nOr if you don't know which courier has issued the tracking number you can use the following URL:\n\n`https://eltrak.herokuapp.com/v2/track-all/[TRACKINGNUMBER]`\n\n### Installation\n\n#### Deploy to Docker - pull from Docker Hub\n\n1. Pull the Docker image and start the container:\n\n   ```bash\n   docker pull gntouts/eltrak:latest\n   docker run -d -p 8888:80 eltrak:latest\n   ```\n\n#### Deploy locally\n\nIn order to run the server locally (or anywhere else) run the following commands:\n\n1. Clone the repository and change directory:\n\n   ```bash\n   git clone https://github.com/gntouts/eltrak.git\n   cd eltrak\n   ```\n\n2. Install requirements (it is recommended to use a virtual environment, see [venv](https://docs.python.org/3/library/venv.html) or [Miniconda](https://docs.conda.io/en/latest/miniconda.html)):\n   Because uvloop does not support Windows at the moment, you need to skip installing it if you are using a Windows machine.\n\n   For Windows:\n\n   `pip install -r src/req/windows-requirements.txt`\n\n   For Ubuntu and Debian:\n\n   `pip install -r src/req/requirements.txt`\n\n3. Activate your environment (if you used one) and run the server\n\n   ```bash\n   cd src\n   uvicorn app:app --port=8888\n   ```\n\n#### Deploy to Docker - build it yourself\n\n1. Clone the repository and change directory:\n\n   ```bash\n   git clone https://github.com/gntouts/eltrak.git\n   cd eltrak\n   ```\n\n2. Build the Docker image from the Dockerfile\n\n   `docker build -t eltrak .`\n\n3. Start the container\n\n   `docker run -dp 8888:80 eltrak`\n\n#### Deploy to Heroku\n\n1. Clone the repository and change directory:\n\n   ```bash\n   git clone https://github.com/gntouts/eltrak.git\n   cd eltrak\n\n2. Create a new app:\n\n   ```bash\n   heroku login\n   heroku apps:create --region eu eltrak\n   ```\n3. Set your deployment method:\n \n   ```bash\n   heroku container:login\n   heroku stack:set container -a eltrak\n   heroku git:remote -a eltrak\n   ```\n5. Build and push your app to Heroku\n\n   ```bash\n   git push heroku main\n   ```\n\n#### Other methods\n\nIt is also possible to deploy to Caprover using the captain-definition and the dockerfile.\n\n### Contributing\n\nAny help is welcome. Even if you just provide me with test tracking numbers.\n\n### Projects using `eltrak`\n\n- [gr-courier-tracking](https://github.com/gioiliop7/gr-courier-tracking)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgntouts%2Feltrak","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgntouts%2Feltrak","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgntouts%2Feltrak/lists"}