{"id":15893589,"url":"https://github.com/alexdlaird/amazon-orders","last_synced_at":"2026-06-12T03:01:45.584Z","repository":{"id":215829304,"uuid":"739464341","full_name":"alexdlaird/amazon-orders","owner":"alexdlaird","description":"A Python library (and CLI) for Amazon order history, line items, and transactions","archived":false,"fork":false,"pushed_at":"2026-06-05T18:34:54.000Z","size":3315,"stargazers_count":149,"open_issues_count":9,"forks_count":41,"subscribers_count":5,"default_branch":"develop","last_synced_at":"2026-06-05T20:12:34.883Z","etag":null,"topics":["amazon","beautifulsoup","cli","order-history","python","receipts","web-scraping"],"latest_commit_sha":null,"homepage":"https://amazon-orders.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alexdlaird.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.rst","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"alexdlaird","patreon":"alexdlaird","custom":["https://www.paypal.me/alexdlaird"]}},"created_at":"2024-01-05T16:21:11.000Z","updated_at":"2026-06-05T18:34:57.000Z","dependencies_parsed_at":"2024-02-14T21:29:11.726Z","dependency_job_id":"226d5275-e62e-4721-a992-d528ade97338","html_url":"https://github.com/alexdlaird/amazon-orders","commit_stats":null,"previous_names":["alexdlaird/amazon-orders-python","alexdlaird/amazon-orders"],"tags_count":77,"template":false,"template_full_name":null,"purl":"pkg:github/alexdlaird/amazon-orders","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexdlaird%2Famazon-orders","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexdlaird%2Famazon-orders/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexdlaird%2Famazon-orders/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexdlaird%2Famazon-orders/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alexdlaird","download_url":"https://codeload.github.com/alexdlaird/amazon-orders/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexdlaird%2Famazon-orders/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34226629,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-12T02:00:06.859Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["amazon","beautifulsoup","cli","order-history","python","receipts","web-scraping"],"created_at":"2024-10-06T08:12:09.777Z","updated_at":"2026-06-12T03:01:45.577Z","avatar_url":"https://github.com/alexdlaird.png","language":"Python","funding_links":["https://github.com/sponsors/alexdlaird","https://patreon.com/alexdlaird","https://www.paypal.me/alexdlaird"],"categories":["cli","Utilities","Quick reference"],"sub_categories":["Calendars"],"readme":"\u003cp align=\"center\"\u003e\u003cimg alt=\"amazon-orders - A Python library (and CLI) for Amazon order history\" src=\"https://amazon-orders.readthedocs.io/_images/logo.png\" /\u003e\u003c/p\u003e\n\n[![Version](https://img.shields.io/pypi/v/amazon-orders)](https://pypi.org/project/amazon-orders)\n[![Python Versions](https://img.shields.io/pypi/pyversions/amazon-orders.svg)](https://pypi.org/project/amazon-orders)\n[![Coverage](https://img.shields.io/codecov/c/github/alexdlaird/amazon-orders)](https://codecov.io/gh/alexdlaird/amazon-orders)\n[![Build](https://img.shields.io/github/actions/workflow/status/alexdlaird/amazon-orders/build.yml)](https://github.com/alexdlaird/amazon-orders/actions/workflows/build.yml)\n[![Docs](https://img.shields.io/readthedocs/amazon-orders)](https://amazon-orders.readthedocs.io)\n[![GitHub License](https://img.shields.io/github/license/alexdlaird/amazon-orders)](https://github.com/alexdlaird/amazon-orders/blob/main/LICENSE)\n\n`amazon-orders` is an unofficial library that provides a Python API (and CLI) for Amazon order history, line items, and transactions.\n\nOnly the English, `.com` version of Amazon is officially supported. Other Amazon domains can be\ntargeted by passing `domain` to [`AmazonSession`](https://amazon-orders.readthedocs.io/api.html#amazonorders.session.AmazonSession)\n(or `--domain` on the CLI), and other English-based sites may work by chance — see\n[Known Limitations](https://amazon-orders.readthedocs.io/index.html#known-limitations) for details.\n\n\u003e **Note:** This package works by parsing data from Amazon's consumer-facing website. A periodic build validates\n\u003e functionality to ensure its stability, but as Amazon provides no official API to use, older versions of this\n\u003e package may break at any time, so it's recommended that you use the latest version.\n\n## Installation\n\n`amazon-orders` is available on [PyPI](https://pypi.org/project/amazon-orders/) and can be installed and/or upgraded using `pip`:\n\n```sh\npip install amazon-orders --upgrade\n```\n\nThat's it! `amazon-orders` is now available as a package to your Python projects and from the command line.\n\nIf pinning, be sure to use a wildcard for the [minor version](https://semver.org/) (ex. `==4.4.*`, not `==4.4.0`) to\nensure you always get the latest stable release.\n\n## Basic Usage\n\nYou'll use [`AmazonSession`](https://amazon-orders.readthedocs.io/api.html#amazonorders.session.AmazonSession) to\nauthenticate your Amazon account, then [`AmazonOrders`](https://amazon-orders.readthedocs.io/api.html#amazonorders.orders.AmazonOrders)\nand [`AmazonTransactions`](https://amazon-orders.readthedocs.io/api.html#amazonorders.transactions.AmazonTransactions)\nto interact with account data. [`get_order_history`](https://amazon-orders.readthedocs.io/api.html#amazonorders.orders.AmazonOrders.get_order_history)\nand [`get_order`](https://amazon-orders.readthedocs.io/api.html#amazonorders.orders.AmazonOrders.get_order) are good places to start.\n\n```python\nfrom amazonorders.session import AmazonSession\nfrom amazonorders.orders import AmazonOrders\n\namazon_session = AmazonSession(\"\u003cAMAZON_EMAIL\u003e\",\n                               \"\u003cAMAZON_PASSWORD\u003e\")\namazon_session.login()\n\namazon_orders = AmazonOrders(amazon_session)\n\n# Get orders from a specific year\norders = amazon_orders.get_order_history(year=2023)\n\n# Or use time filters for recent orders\norders = amazon_orders.get_order_history(time_filter=\"last30\")  # Last 30 days\norders = amazon_orders.get_order_history(time_filter=\"months-3\")  # Past 3 months\n\nfor order in orders:\n    print(f\"{order.order_number} - {order.grand_total}\")\n```\n\nIf the fields you're looking for aren't populated with the above, set `full_details=True` (or pass `--full-details` to\nthe `history` CLI command), since by default it is `False` (enabling it slows down querying, since an additional\nrequest for each order is necessary). Have a look at the [Order](https://amazon-orders.readthedocs.io/api.html#amazonorders.entity.order.Order) entity's docs to see what fields are only\npopulated with full details.\n\n### Command Line Usage\n\nYou can also run any command available to the main Python interface from the command line:\n\n```sh\namazon-orders login\namazon-orders history --year 2023\namazon-orders history --last-30-days\namazon-orders history --last-3-months\n```\n\n### Automating Authentication\n\nAuthentication can be automated by (in order of precedence) storing credentials in environment variables, passing them\nto [`AmazonSession`](https://amazon-orders.readthedocs.io/api.html#amazonorders.session.AmazonSession), or storing them\nin [`AmazonOrdersConfig`](https://amazon-orders.readthedocs.io/api.html#amazonorders.conf.AmazonOrdersConfig). The\nenvironment variables `amazon-orders` looks for are:\n\n- `AMAZON_USERNAME`\n- `AMAZON_PASSWORD`\n- `AMAZON_OTP_SECRET_KEY` (see [docs for usage](https://amazon-orders.readthedocs.io/api.html#amazonorders.session.AmazonSession.otp_secret_key))\n\nTo enable **WAF auto-solve** via a third-party integration, install with the relevant extra:\n\n```sh\npip install amazon-orders[capsolver]\npip install amazon-orders[anticaptcha]\npip install amazon-orders[2captcha]\n```\n\nSee [Solving WAF Challenges](https://amazon-orders.readthedocs.io/waf.html) for details.\n\nTo enable **browser-based challenge handling** (ACIC and JavaScript bot-detection pages) via\na headless browser, install with the `browser` extra:\n\n```sh\npip install amazon-orders[browser]\nplaywright install chromium\n```\n\nSee [Browser Automation](https://amazon-orders.readthedocs.io/browser.html) for details.\n\nFor **legacy Captcha auto-solve** on Python \u003c=3.12, install with `captcha` extra:\n\n```sh\npip install amazon-orders[captcha]\n```\n\nSee [Login Challenges](https://amazon-orders.readthedocs.io/troubleshooting.html#login-challenges) for details.\n\n## Documentation\n\nFor more advanced usage, `amazon-orders`'s official documentation is available\nat [Read the Docs](http://amazon-orders.readthedocs.io).\n\n## Contributing\n\nIf you would like to get involved, be sure to review\nthe [Contribution Guide](https://github.com/alexdlaird/amazon-orders/blob/main/CONTRIBUTING.rst).\n\nWant to contribute financially? If you've found `amazon-orders`\nuseful, [sponsorship](https://github.com/sponsors/alexdlaird) would\nalso be greatly appreciated!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexdlaird%2Famazon-orders","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexdlaird%2Famazon-orders","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexdlaird%2Famazon-orders/lists"}