# EAN-DB Python client
This is a Python client for EAN-DB API.
[EAN-DB](https://ean-db.com) is an online API for product info lookups by EAN / UPC / ISBN.
Product info includes titles in various languages, categories, manufacturer, images and additional metadata.
For more information, please see [API docs](https://ean-db.com/docs) and [Database stats](https://ean-db.com/stats).
## Installation
```commandline
pip install eandb
```
## Usage
### Asynchronous client
```pycon
>>> from eandb.clients.v2 import EandbV2AsyncClient
>>> eandb_client = EandbV2AsyncClient(jwt='YOUR_JWT_GOES_HERE')
>>> response = await eandb_client.get_product('0016065024615')
```
### Synchronous client
```pycon
>>> from eandb.clients.v2 import EandbV2SyncClient
>>> eandb_client = EandbV2SyncClient(jwt='YOUR_JWT_GOES_HERE')
>>> response = eandb_client.get_product('0016065024615')
>>> response
ProductResponse(
balance=100, error=None,
product=Product(
barcode='0016065024615',
titles={'en': 'Pretty Tied Up'},
categories=[
Category(id='855', titles={'en': 'Music & Sound Recordings', ...})
],
manufacturer=Manufacturer(id=None, titles={'de': 'Geffen'}, wikidataId=None),
relatedBrands=[],
images=[Image(url='...')],
metadata=Metadata(
generic=Generic(
contributors=[Contributor(names={'en': "Guns N' Roses"}, type='artist')]
)
)
)
)
```
Raw data
{
"_id": null,
"home_page": "https://github.com/ean-db/python-client",
"name": "eandb",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8.1",
"maintainer_email": null,
"keywords": "barcode, ean, upc, isbn",
"author": "EAN-DB",
"author_email": "support@ean-db.com",
"download_url": "https://files.pythonhosted.org/packages/27/51/35f05d0fdc6d41cd0bcf69c81f13dbb7d8355ed237f09c2dbdd9c9f815a9/eandb-0.8.0.tar.gz",
"platform": null,
"description": "# EAN-DB Python client\n\nThis is a Python client for EAN-DB API.\n\n[EAN-DB](https://ean-db.com) is an online API for product info lookups by EAN / UPC / ISBN.\nProduct info includes titles in various languages, categories, manufacturer, images and additional metadata.\n\nFor more information, please see [API docs](https://ean-db.com/docs) and [Database stats](https://ean-db.com/stats).\n\n## Installation\n\n```commandline\npip install eandb\n```\n\n## Usage\n\n### Asynchronous client\n\n```pycon\n>>> from eandb.clients.v2 import EandbV2AsyncClient\n\n>>> eandb_client = EandbV2AsyncClient(jwt='YOUR_JWT_GOES_HERE')\n>>> response = await eandb_client.get_product('0016065024615')\n```\n\n### Synchronous client\n\n```pycon\n>>> from eandb.clients.v2 import EandbV2SyncClient\n\n>>> eandb_client = EandbV2SyncClient(jwt='YOUR_JWT_GOES_HERE')\n>>> response = eandb_client.get_product('0016065024615')\n>>> response\n\nProductResponse(\n balance=100, error=None, \n product=Product(\n barcode='0016065024615', \n titles={'en': 'Pretty Tied Up'}, \n categories=[\n Category(id='855', titles={'en': 'Music & Sound Recordings', ...})\n ],\n manufacturer=Manufacturer(id=None, titles={'de': 'Geffen'}, wikidataId=None),\n relatedBrands=[],\n images=[Image(url='...')], \n metadata=Metadata(\n generic=Generic(\n contributors=[Contributor(names={'en': \"Guns N' Roses\"}, type='artist')]\n )\n )\n )\n)\n```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python client for EAN-DB API",
"version": "0.8.0",
"project_urls": {
"Homepage": "https://github.com/ean-db/python-client",
"Repository": "https://github.com/ean-db/python-client"
},
"split_keywords": [
"barcode",
" ean",
" upc",
" isbn"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e19458fcdd910473efe6991f6196394cda525912a7c31e4f9975afe2148fb06b",
"md5": "033b094163e8c21aa2549d584078376a",
"sha256": "f6cfcfe650515034d20f5ba30b2ddae9ea888036944bf882d103cecab9b9c678"
},
"downloads": -1,
"filename": "eandb-0.8.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "033b094163e8c21aa2549d584078376a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8.1",
"size": 4866,
"upload_time": "2025-08-12T20:23:20",
"upload_time_iso_8601": "2025-08-12T20:23:20.790366Z",
"url": "https://files.pythonhosted.org/packages/e1/94/58fcdd910473efe6991f6196394cda525912a7c31e4f9975afe2148fb06b/eandb-0.8.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "275135f05d0fdc6d41cd0bcf69c81f13dbb7d8355ed237f09c2dbdd9c9f815a9",
"md5": "5ed7f462b84d18b150e5870d44fea437",
"sha256": "2727c914fa2128a039aa3c9efff27a9e7363656969d7ff253400415dc4192ebb"
},
"downloads": -1,
"filename": "eandb-0.8.0.tar.gz",
"has_sig": false,
"md5_digest": "5ed7f462b84d18b150e5870d44fea437",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8.1",
"size": 3728,
"upload_time": "2025-08-12T20:23:21",
"upload_time_iso_8601": "2025-08-12T20:23:21.994973Z",
"url": "https://files.pythonhosted.org/packages/27/51/35f05d0fdc6d41cd0bcf69c81f13dbb7d8355ed237f09c2dbdd9c9f815a9/eandb-0.8.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-12 20:23:21",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ean-db",
"github_project": "python-client",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "eandb"
}