# Barcode Lookup (`igview-owner/barcode-lookup`) Actor Extract complete product metadata, high-resolution image galleries, specifications, and live retailer prices using barcodes or keywords. Supports bulk processing and automated price analytics across major online stores. - **URL**: https://apify.com/igview-owner/barcode-lookup.md - **Developed by:** [Sachin Kumar Yadav](https://apify.com/igview-owner) (community) - **Categories:** E-commerce, Automation - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Barcode Lookup and Product Search API Get structured, real-time product data by barcode or search query. This Apify actor allows you to scan UPC, EAN, ISBN, or GTIN identifiers, or search for products by name to retrieve comprehensive specifications, online pricing, store availability, images, and nutrition details. Whether you are building an inventory management platform, comparing prices across major retailers, performing product research, or enriching an e-commerce database, this tool delivers clean and organized data within seconds. --- ### Why Choose This Actor? Unlike single-purpose tools, this actor provides a robust, multi-source approach to product data retrieval: * **Dual Search Functionality**: Input either a barcode (UPC, EAN, ISBN-13, GTIN) or standard keywords. The actor automatically resolves the input and retrieves matching products. * **Bulk Processing**: Process up to 50 queries per execution, allowing you to scale your lookups. * **Real-Time Price Comparison**: Extract live prices from leading retailers including Amazon, Walmart, Best Buy, Home Depot, Target, and others. * **Price Statistics**: Automatically calculate the lowest, highest, and average pricing across all online stores. * **High-Resolution Images**: Retrieve main product images and secondary image galleries for your application. * **Smart Performance Cache**: Store results in an internal cache for up to 48 hours, preventing duplicate external requests and accelerating subsequent runs. * **Amazon Affiliate Integration**: Automatically format Amazon store links with pre-configured affiliate parameters. --- ### Quick Start #### Lookup by Barcode Retrieve product details using numeric barcodes: ```json { "queries": [ "194253236313", "037000740797", "810055171064" ] } ```` #### Search by Keyword Find products by name or descriptive queries: ```json { "queries": [ "wireless earbuds", "airpods", "apple watch" ] } ``` #### Mixed Batch Mix barcodes and search phrases in the same list: ```json { "queries": [ "194253236313", "airpods", "810055171064", "apple watch" ] } ``` *** ### Input Parameters The actor accepts a single object with the following configuration: | Parameter | Type | Required | Description | |---|---|---|---| | queries | Array of strings | Yes | A list of barcodes (UPC, EAN, ISBN, GTIN) or product keywords. Supports up to 50 queries. | #### Supported Identifier Formats - **UPC-A**: 12-digit Universal Product Code (standard in the United States and Canada) - **EAN-13**: 13-digit European Article Number (used internationally) - **ISBN-13**: 13-digit International Standard Book Number (used for books and publications) - **GTIN**: Global Trade Item Number (ranging from 8 to 14 digits) *** ### Output Data Structure The returned dataset contains detailed fields grouped logically for easy consumption: #### Identifiers and Barcodes - **query**: The search query or barcode originally entered. - **barcode**: The primary resolved barcode (UPC-A or EAN-13). - **upcA**: Resolved UPC-A format. - **ean13**: Resolved EAN-13 format. - **asin**: Amazon Standard Identification Number. - **mpn**: Manufacturer Part Number. - **model**: Model number. #### Product Specifications - **title**: Full name of the product. - **brand**: Brand name. - **manufacturer**: Manufacturer name. - **category**: Array of categories or breadcrumbs. - **description**: Detailed product description text. - **features**: Array of key highlights or bulleted features. - **author**: Author name (for books). - **artist**: Artist name (for music and media). #### Physical Attributes - **color**: Product color. - **weight**: Weight of the product. - **dimensions**: Dimensions of the product (length, width, height). #### Media Assets - **productImage**: URL of the main product image. - **images**: Array of all available high-resolution product image URLs. #### Pricing and Availability - **lowestPrice**: Lowest price found among online retailers. - **highestPrice**: Highest price found among online retailers. - **averagePrice**: Calculated average price across all stores. - **totalStores**: Total number of online stores selling the item. - **onlineStores**: Array of store objects containing storeName, storePrice, and storeUrl (with Amazon links containing affiliate tags). #### Health and Ingredients - **ingredients**: String containing ingredient text (when available). - **nutritionFacts**: String containing nutrition facts and nutritional breakdown (when available). *** ### Sample Output ```json { "barcode": "037000740797", "upcA": "037000740797", "ean13": "0037000740797", "title": "Metamucil Psyllium GLP-1 Friendly Fiber Supplement with Sugar Powder - Orange - 3g Fiber per Serving - 30.4oz", "brand": null, "manufacturer": "Metamucil", "author": null, "artist": null, "category": [ "Health Care", "Fitness & Nutrition", "Vitamins & Supplements" ], "description": "Metamucil is the only fiber leading brand^ made with psyllium husk fiber for 4 health benefits in 1 easy daily fiber supplement*. · Plant-Based Psyllium Husk Fiber · Real Sugar · Smooth-Texture for Easy Mixing · Refreshing Orange Flavor · 2.4 Grams Soluble Fiber Per Serving *THESE STATEMENTS HAVE NOT BEEN EVALUATED BY THE FOOD AND DRUG ADMINISTRATION. THIS PRODUCT IS NOT INTENDED TO DIAGNOSE, TREAT, CURE, OR PREVENT ANY DISEASE. Diets low in saturated fat and cholesterol that include 7 grams of soluble fiber per day from psyllium husk, as in Metamucil, may reduce the risk of heart disease by lowering cholesterol. One serving of Metamucil has 2.4 grams of this soluble fiber. ^Procter & Gamble calculation based in part on data reported by NielsenIQ through its ScanTrack Service for the Fiber Supplements (branded only) for the 52-weeks period ending, 6/01/24 for the Total U.S. Market xAOC, according to the NielsenIQ standard product hierarchy. Copyright 2024, Nielsen Consumer LLC. **Survey of 291 adults who reported feeling lighter and more energetic after the Metamucil Two Week Challenge.", "features": [], "images": [ "https://images.barcodelookup.com/1396/13969613-1.jpg" ], "productImage": "https://images.barcodelookup.com/1396/13969613-1.jpg", "mpn": "14765973", "model": null, "asin": null, "color": "multi", "dimensions": null, "weight": "2.36 lb", "ingredients": "Sucrose, Psyllium Husk, Citic Acid, Natural And Artifical Orange Flavor, Yellow 6", "nutritionFacts": "Energy 95.833333333333 kcal, Carbohydrates 95.833333333333 g, Sugars 66.666666666667 g, Salt 0.10416666666667 g.", "onlineStores": [ { "storeName": "buybuy BABY", "storePrice": "$15.49", "storeUrl": "https://www.bedbathandbeyond.com/store/product/metamucil-original-smooth-texture-72-dosage-multihealth-fiber/1012713851?skuId=12713851" }, { "storeName": "Bed Bath & Beyond", "storePrice": "$15.49", "storeUrl": "https://www.bedbathandbeyond.com/store/product/metamucil-original-smooth-texture-72-dosage-multihealth-fiber/1012713851?skuId=12713851" }, { "storeName": "Harmon Face Values", "storePrice": "$15.49", "storeUrl": "https://www.harmondiscount.com/037000740797-Metamucil-Original-Smooth-Texture-72-Dosage-MultiHealth-Fiber/p/037000740797?utm_source=googleshopping" }, { "storeName": "Shopko", "storePrice": "$16.99", "storeUrl": "http://www.shopko.com/catalog/product.jsp?productId=88727" }, { "storeName": "Vitacost.com", "storePrice": "$17.49", "storeUrl": "http://clickserve.dartsearch.net/link/click?lid=43700049338235428" }, { "storeName": "Walmart", "storePrice": "$16.98", "storeUrl": "https://www.walmart.com/ip/Metamucil-Fiber-Supplement-Psyllium-Husk-Fiber-Powder-for-Digestive-Health-Real-Sugar-72-Servings/16564842" } ], "totalStores": 6, "lowestPrice": 15.49, "highestPrice": 17.49, "averagePrice": "16.32", "query": "037000740797", "status": "success", "fromCache": false } ``` *** ### Dataset Views The actor configures four pre-built dataset views on the Apify platform to help visualize and filter your data: 1. **Product Overview**: Displays key metadata including barcode, image, title, brand, manufacturer, category, pricing ranges, and store counts. 2. **Pricing and Stores**: Offers a detailed look at competitor pricing, summarizing lowest, highest, and average values with full merchant lists. 3. **Product Details**: Focuses on physical specifications and identification numbers, including UPC, EAN, ASIN, MPN, dimensions, and weights. *** ### Common Use Cases - **E-Commerce Catalog Enrichment**: Automatically fill gaps in your product inventory with descriptions, high-quality images, and manufacturer details. - **Competitor Price Monitoring**: Track pricing fluctuations across retail sites to implement dynamic pricing models. - **Warehouse and Inventory Control**: Scan and lookup barcode identifiers to update catalog records automatically. - **Product and Market Research**: Aggregated retail listings to identify vendor trends, average market value, and competitor positioning. *** ### Get Free Apify Credits New to the Apify platform? Sign up via the following link to receive $5 in free platform credits: [Sign up for Apify Credits](https://apify.com?fpr=ykgg9c) *** ### Support If you have questions, feedback, or need help with this Barcode Lookup Actor, please contact us or open an issue on the Apify Console. # Actor input Schema ## `queries` (type: `array`): Enter barcodes (UPC, EAN, GTIN) or product search terms. You can mix both! Examples: '810055171064', '037000740797' ## Actor input object example ```json { "queries": [ "037000740797" ] } ``` # Actor output Schema ## `overview` (type: `string`): View complete product information including barcode, image, title, brand, manufacturer, category, description, physical attributes, and pricing statistics. ## `pricing` (type: `string`): View lowest, highest, and average prices across all online stores with full store details including names, prices, and URLs. ## `details` (type: `string`): View detailed product information including barcode formats (UPC-A, EAN-13), MPN, model, ASIN, author, artist, features, and all product images. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "queries": [ "037000740797" ] }; // Run the Actor and wait for it to finish const run = await client.actor("igview-owner/barcode-lookup").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "queries": ["037000740797"] } # Run the Actor and wait for it to finish run = client.actor("igview-owner/barcode-lookup").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "queries": [ "037000740797" ] }' | apify call igview-owner/barcode-lookup --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=igview-owner/barcode-lookup", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Barcode Lookup", "description": "Extract complete product metadata, high-resolution image galleries, specifications, and live retailer prices using barcodes or keywords. Supports bulk processing and automated price analytics across major online stores.", "version": "0.0", "x-build-id": "jPwzapVfJEyZEERBa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/igview-owner~barcode-lookup/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-igview-owner-barcode-lookup", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/igview-owner~barcode-lookup/runs": { "post": { "operationId": "runs-sync-igview-owner-barcode-lookup", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/igview-owner~barcode-lookup/run-sync": { "post": { "operationId": "run-sync-igview-owner-barcode-lookup", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "queries" ], "properties": { "queries": { "title": "Barcodes or Search Terms", "minItems": 1, "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Enter barcodes (UPC, EAN, GTIN) or product search terms. You can mix both! Examples: '810055171064', '037000740797'", "items": { "type": "string" }, "default": [ "037000740797" ] } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```