eansearch

Crates.ioeansearch
lib.rseansearch
version1.0.2
sourcesrc
created_at2023-08-01 13:19:02.400429
updated_at2024-04-22 19:58:30.065761
descriptionSearch the EAN barcode database at Ean-Search.org. Search for products by EAN number or product name, verify barcodes or generate barcode images.
homepage
repositoryhttps://github.com/eansearch/rust-eansearch/
max_upload_size
id931855
size34,740
Jan Willamowius (eansearch)

documentation

README

EANSearch

Search for products by EAN barcode or product name / keywords

Features

  • Search by EAN code
  • Lookup by ISBN code (ISBN-10 or ISBN-13)
  • Search by name or keyords
  • restrict search by product category
  • get the issuing country for the barcode
  • verify barcode checksum
  • get PNG image for the EAN barcode

How to use

// search by EAN barcode, product name in English
let eansearch = EANSearch::new(&token);
let product = eansearch.barcode_lookup(5099750442227, Some(1));
let product = product.unwrap(); // unwrap result
let product = product.unwrap();
println!("EAN {} is {}", product.ean, product.name);

// search by ISBN code
let eansearch = EANSearch::new(&token);
let book = eansearch.isbn_lookup(1119578884);
let book = book.unwrap(); // unwrap result
let book = book.unwrap();
println!("ISBN-13 {} is {}", book.ean, book.name);

// now find all products with the keyword 'bananaboat'
let product_list = eansearch.product_search("bananaboat", Some(1), None);
for p in &product_list.unwrap() {
	println!("EAN {:0>13} is {} ({})", p.ean, p.name, p.category_name);
}

// only find 'bananaboat' products from the 'Music' category
let product_list = eansearch.category_search(45, Some("bananaboat"), Some(1), None);

// download a EANs that start with 509975044xxx
let product_list = eansearch.barcode_prefix_search(509975044, Some(1), None);

// find the country where a barcode was issued
let country_lookup = eansearch.issuing_country(5099750442227);

// check if this is really a valid barcode
let checksum_ok = eansearch.verify_checksum(5099750442227);

// get A PNG image of the barcode to display eg. on a website
let img = eansearch.barcode_image(5099750442227, None, None);

To use the library, you need an account and obtain an API token.

See https://www.ean-search.org/ean-database-api.html

Commit count: 12

cargo fmt