UPCBarcodeLookup

Swift package for UPC, GTIN, ISBN and EAN barcode lookup using the API provided by EAN-Search.org

Features

• lookup details for a specific GTIN, UPC or EAN barcode in our database: barcodeLookup(ean: )
• lookup details for a specific ISBN 10 in our database: isbnLookup(isbn: )
• just check the issuing country on any barcode: issuingCountryLookup(ean: )
• verify the checksum of a barcode verifyChecksum(ean: ean)
• get all products with a certain prefix: barcodePrefixSearch(prefix: )
• search products matching some keywords: keywordSearch(keywords: )
• restrict a keyword search to a product category: categorySearch(keywords: , category: )
• find products with similar names: similarProductSearch(keywords: )
• generate a PNG barcode image: generateBarcodeImage(ean: , width: , height: )
• find the Amazon ASIN for a barcode and vice versa: findAsinForEan(ean: ), findEanForAsin(asin: )
• find the Library of Congress control number (LCCN) for a barcode and vice versa: findLccnForEan(ean: ), findEanForLccn(lccn: )

Installation

Just add UPCBarcodeLookup as a dependency in your Product.swift.

dependencies: [
    .package(url: "https://github.com/eansearch/UPCBarcodeLookup.git", branch: "main")
]

Usage

Initialize the API instance with your API token.

With all methods returning a result list, you need to page through the results if there are more than 10.

Example

import UPCBarcodeLookup

let token = ProcessInfo.processInfo.environment["EAN_SEARCH_API_TOKEN"]!
let ean = "5099750442227" // a GTIN, UPC or EAN code, eg from your barcode scanner

let upcLookup = UPCBarcodeLookup(apiToken: token)

do {
    let product = try await upcLookup.barcodeLookup(ean: ean)
    print ("EAN \(ean) is " + (product?.name ?? "not found"))
    print ("EAN \(ean) has Google category ID " + (product?.googleCategoryId ?? "unknown"))

    let country = try await upcLookup.issuingCountryLookup(ean: ean)
    print ("EAN \(ean) was issued in " + (country))

    let ok = try await upcLookup.verifyChecksum(ean: ean)
    print ("EAN \(ean) checksum OK = \(ok)")

    let range = try await upcLookup.barcodePrefixSearch(prefix: "50997504422")
    print("Prefix range: 50997504422*")
    for product in range {
        print ("EAN \(product.ean) is \(product.name)")
    }

   let products = try await upcLookup.keywordSearch(keywords: "Bananaboat")
    print("Keyword: Bananaboat:")
    for product in products {
        print ("EAN \(product.ean) is \(product.name)")
    }

    let cat = try await upcLookup.categorySearch(keywords: "Thriller", category: 45)
    print("Keyword Thriller in category Music:")
    for product in cat {
        print ("EAN \(product.ean) is \(product.name)")
    }

    let similar = try await upcLookup.similarProductSearch(keywords: "Apple iPhone 16GB robust")
    print("Similar search:")
    for product in similar {
        print ("EAN \(product.ean) is \(product.name)")
    }

    let asin = try await upcLookup.findAsinForEan(ean: "5099750442227")
    print ("ASIN is \(asin ?? "not found")")
    let ean2 = try await upcLookup.findEanForAsin(asin: "B00005NUZN")
    print ("EAN for ASIN is \(ean2 ?? "not found")")

    let lccn = try await upcLookup.findLccnForEan(ean: "9780815346333")
    print ("LCCN is \(lccn ?? "not found")")
    let ean3 = try await upcLookup.findEanForLccn(lccn: "2020691629")  // returns the first EAN if there are several
    print ("EAN for LCCN is \(ean3 ?? "not found")")

    let png = try await upcLookup.generateBarcodeImage(ean: ean, width: 400, height: 300)!

    let fileManager = FileManager.default
    var documentURL = try! fileManager.url(for: .documentDirectory, in: .userDomainMask, appropriateFor: nil, create: true)
    documentURL = documentURL.appendingPathComponent("barcode.png")
    try! png.write(to: documentURL)

    print("Credits remaining: ", upcLookup.creditsRemaining())
} catch {
    print ("Error: \(error)")
}