Barcode Lookup by tanatasa.SG

Turn a barcode into a product name.

This Actor is built by tanatasa.SG, a Singapore beauty and personal care store that combines curated retail with practical product data technology. It is designed for sellers, catalog teams, e-commerce operators, developers, and automation workflows that need a simple way to identify a product from a barcode.

What this Actor does

Provide a barcode, and the Actor returns a clean JSON result with the product name and any available product metadata.

It supports common numeric barcode formats such as:

• UPC
• EAN
• GTIN
• ISBN-style product codes

Example barcode:

{
  "barcode": "4002293401102"
}

Example result:

{
  "barcode": "4002293401102",
  "productName": "Product name from barcode lookup",
  "brand": "Brand name if available",
  "category": "Category if available",
  "ean": "4002293401102",
  "upc": "4002293401102",
  "gtin": "04002293401102",
  "source": "barcode-database"
}

Use cases

This Actor is useful for:

• Product name lookup from barcode
• Beauty product catalog enrichment
• Marketplace listing preparation
• Barcode scanner backends
• Inventory and stock workflows
• Product matching across channels
• E-commerce data cleaning
• Retail automation
• Simple API workflows for product identification

Although tanatasa.SG focuses on beauty, skincare, wellness, and personal care products, this Actor can be used for general product barcode lookup when data is available.

Input

Field	Type	Required	Description
barcode	string	Yes	UPC, EAN, GTIN, or ISBN-style barcode. Use digits only.

The barcode should be sent as a string, not a number, so leading zeroes are preserved.

Example input

{
  "barcode": "4002293401102"
}

Output

The Actor returns and stores a structured result.

Field	Description
barcode	The barcode submitted for lookup
productName	Product name found from the barcode
brand	Brand name, if available
category	Product category, if available
ean	EAN, if available
upc	UPC, if available
gtin	GTIN, if available
source	Data source identifier

Not every barcode has complete metadata. In many cases, only the product name may be available.

How to use this Actor

You can use this Actor in two ways:

1. Run it normally from Apify Console
2. Call it as a Standby API endpoint

Option 1: Run from Apify Console

Open the Actor input form and enter:

{
  "barcode": "4002293401102"
}

Run the Actor.

After the run finishes, open the default dataset to view the result.

Option 2: Use the Standby API

This Actor supports Apify Standby mode. That means it can respond like a web API.

You need an Apify API token to call the endpoint. You can find it in:

Apify Console > Settings > Integrations

The base Standby URL is:

https://tanatasa-sg--barcode-lookup.apify.actor

GET endpoint

GET /lookup?barcode=YOUR_BARCODE

Full example using the token query parameter shown by Apify:

$curl "https://tanatasa-sg--barcode-lookup.apify.actor/lookup?barcode=4002293401102&token=<YOUR_API_TOKEN>"

You can also place the token first:

$curl "https://tanatasa-sg--barcode-lookup.apify.actor/lookup?token=<YOUR_API_TOKEN>&barcode=4002293401102"

GET example response

{
  "barcode": "4002293401102",
  "productName": "Product name from barcode lookup",
  "brand": "Brand name if available",
  "category": "Category if available",
  "ean": "4002293401102",
  "upc": "4002293401102",
  "gtin": "04002293401102",
  "source": "barcode-database"
}

POST endpoint

POST /lookup

Example:

curl -X POST "https://tanatasa-sg--barcode-lookup.apify.actor/lookup?token=<YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"barcode":"4002293401102"}'

Alternative authorization header

Instead of putting the token in the URL, you can send it as an authorization header:

curl -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  "https://tanatasa-sg--barcode-lookup.apify.actor/lookup?barcode=4002293401102"

Important: Apify token vs lookup key

The Apify token is required to call this Actor through Apify.

It is not the same as a barcode data provider API key.

Most users only need their Apify token. If a future version of this Actor supports user-provided lookup keys for higher limits, that key will be entered separately as a secret input.

Error responses

If no barcode is provided:

{
  "error": "Missing barcode. Use barcode, upc, ean, gtin, or isbn."
}

If the barcode format is invalid:

{
  "error": "Barcode must be 8 to 14 digits."
}

If no product is found:

{
  "error": "No product name found for this barcode."
}

Notes and limitations

This Actor depends on external product data availability. Some barcodes may not have a match. Some matched products may have incomplete brand, category, UPC, EAN, or GTIN information.

For best results:

• Use numeric barcodes only
• Send the barcode as a string
• Preserve leading zeroes
• Use UPC, EAN, GTIN, or ISBN-style barcodes
• Expect occasional missing or incomplete records

About tanatasa.SG

tanatasa.SG is a Singapore beauty and personal care store focused on trustworthy products, practical recommendations, and everyday skincare needs.

Alongside retail, we build simple technology tools that help improve beauty product discovery, product catalog quality, barcode lookup, and e-commerce operations.

Our Apify tools are shaped by real seller-side problems: identifying products, cleaning product data, matching listings, and making beauty retail workflows faster and more reliable.

Data source

Product lookup data is provided by UPCitemdb.