How to Use EcomSource.ai: The Complete Guide for Sellers, Developers & Sourcing Teams

Whether you're an FBA seller looking up your first UPC, a developer integrating product data into your app, or an enterprise sourcing team automating catalog enrichment — this guide covers everything you need to know about using EcomSource.ai.

By the end, you'll know how to:

• Look up any product using ASIN, UPC, EAN, or GTIN
• Use the Chrome Extension for on-page intelligence
• Make your first API call
• Run bulk lookups at scale
• Automate sourcing with AI agents

Let's dive in.

1. Getting Started: Your Free Account

Head to ecomsource.ai/signup/signup and create your free account. No credit card required. You'll immediately get access to:

• 50 free daily lookups via the website and Chrome Extension
• Full product detail pages with identifiers, variations, and specs
• Dashboard access to manage your API keys and usage

Your free tier resets every 24 hours — perfect for testing and small-scale research.

2. Looking Up Products on the Website

The fastest way to use EcomSource is the search bar on the homepage. Here's how:

Search by ASIN

1. 1Go to [ecomsource.ai](/)
2. 2Enter any Amazon ASIN (e.g., `B0BTJD6LCL`)
3. 3Select "ASIN" as the identifier type
4. 4Hit Search

You'll get a full product detail page with:

• Product title, brand, and category
• All identifiers — UPC, EAN, GTIN mapped to that ASIN
• Images and bullet points
• Dimensions and weight (item and package)
• Variation data — every color, size, and style variant
• Sales rank and category ranking

Search by UPC or EAN

Already have a barcode? Enter the UPC (e.g., 012345678901) or EAN and select the matching identifier type. EcomSource will resolve it to the matching Amazon ASIN(s) and show you the full product data.

Search by GTIN

GTIN-13 and GTIN-14 codes work too. Just paste them in and select "GTIN" — we'll handle the rest.

3. Using the Chrome Extension

The EcomSource UPC Lookup Extension lets you see product identifiers and data *directly on Amazon and Walmart pages* without leaving your browser.

Installation

1. 1Visit the [Chrome Web Store](https://chromewebstore.google.com/detail/upc-lookup/pglhhlcbcbmfebnagjgmbchpmgokbmpb)
2. 2Click "Add to Chrome"
3. 3Pin the extension to your toolbar

How It Works

• Browse any Amazon product page — the extension automatically detects the ASIN
• Click the extension icon to see the UPC, EAN, and variation data
• View all variations of that product without navigating away
• 50 free lookups per day — no login required for basic use

Pro Tips for the Extension

• Bulk browse: Open multiple Amazon tabs and click through them — the extension caches results for faster repeat lookups
• Walmart support: It works on Walmart product pages too, resolving UPCs back to Amazon ASINs
• Quick copy: Click any identifier to copy it to your clipboard instantly

4. The Dashboard: Your Command Center

After signing in, your dashboard/dashboard gives you full control:

Overview Tab

See your current plan, usage stats, and quick-access links to all features.

API Keys Tab

• Generate API keys — create an Access Key and Secret Key pair
• Manage keys — revoke or regenerate keys as needed
• Copy with one click — paste directly into your code or Postman

Subscription Tab

• View your current plan and billing cycle
• Upgrade or downgrade between Free, Basic ($29.99/mo), and Pro ($79.99/mo)
• See your remaining API credits

Product Search Tab

• Run lookups directly from the dashboard
• View detailed product results in a structured table
• Export data for your records

5. Making Your First API Call

EcomSource provides a REST API at https://api.ecomsource.ai/api/v1/. Here's how to make your first call:

Step 1: Get Your API Keys

Go to your Dashboard → API Keys/dashboard and create a new key pair. You'll get:

• X-Access-Key: Your public access key
• X-Secret-Key: Your private secret key

Step 2: Single Product Lookup

curl -X POST https://api.ecomsource.ai/api/v1/search/product \
  -H "Content-Type: application/json" \
  -H "X-Access-Key: your_access_key" \
  -H "X-Secret-Key: your_secret_key" \
  -d '{
    "identifier": "B0BTJD6LCL",
    "identifierType": "asin",
    "region": "EU",
    "refresh": false
  }'

Step 3: Understand the Response

The API returns a comprehensive JSON object including:

• Basic info: title, brand, manufacturer, category
• Identifiers: ASIN, UPC, EAN, GTIN — all mapped
• Media: image URLs (main and gallery)
• Dimensions: item weight, package weight, item dimensions, package dimensions
• Variations: full list of parent/child ASINs with their attributes
• Rankings: sales rank, category BSR, subcategory rankings
• Bullet points: feature descriptions from the listing

Supported Identifier Types

Supported Regions

6. Bulk Lookups via API

Need to look up hundreds or thousands of products? Use the bulk endpoint:

curl -X POST "https://api.ecomsource.ai/api/v1/search/bulk?locale=US" \
  -H "Content-Type: application/json" \
  -H "X-Access-Key: your_access_key" \
  -H "X-Secret-Key: your_secret_key" \
  -d '[
    { "identifier": "B0BTJD6LCL", "identifierType": "asin" },
    { "identifier": "B0BTJD6LCX", "identifierType": "asin" },
    { "identifier": "012345678901", "identifierType": "upc" }
  ]'

Bulk Best Practices

• Batch size: Send up to 20 identifiers per request for optimal performance
• Rate limiting: The API supports high throughput — but space requests 100ms apart for stability
• Mixed types: You can mix ASINs, UPCs, and EANs in the same bulk request
• Error handling: Failed lookups return a null result with an error message — your batch won't fail because of one bad identifier

7. Real-Time Offers & Buy Box Data

Want live pricing? Use the offers endpoint:

curl -X POST https://api.ecomsource.ai/api/v1/search/offers \
  -H "Content-Type: application/json" \
  -H "X-Access-Key: your_access_key" \
  -H "X-Secret-Key: your_secret_key" \
  -d '{
    "identifier": "B0BTJD6LCL",
    "identifierType": "asin",
    "region": "EU",
    "countryCode": "UK"
  }'

This returns:

• Buy Box price and seller
• All active offers with prices, shipping, and condition
• FBA vs. FBM breakdown
• Offer count across new and used conditions

This is the same data that powers competitive pricing tools — now available directly via API.

8. Using EcomSource with Postman

We provide a ready-made Postman collection for easy testing:

1. 1Download our [Postman Collection](/ecomsource.ai-postman_collection.json)
2. 2Import it into Postman
3. 3Set the `access_key` and `secret_key` variables in the collection settings
4. 4Start making requests — all endpoints are pre-configured

The collection includes:

• Single Product Lookup — search by ASIN with full parameters
• Bulk Product Lookup — multi-product batch request
• Real-time Offers — live pricing and Buy Box data

9. Integration Patterns & Use Cases

For FBA Sellers

1. 1Product Research: Look up competitor ASINs to find their UPCs and source the same products
2. 2Catalog Matching: Match your inventory UPCs to Amazon ASINs before listing
3. 3Price Monitoring: Use the offers endpoint to track competitor pricing daily
4. 4Variation Mapping: Understand the full variation family before committing to a product line

For Developers

1. 1Build a product database: Pipe API results into your database for a custom product catalog
2. 2Power search features: Let users search by barcode and get rich product data
3. 3Feed AI models: Use structured product data to train recommendation engines
4. 4Automate enrichment: Enrich sparse product records with full Amazon data

For Enterprise & Sourcing Teams

1. 1Supplier verification: Cross-reference supplier UPCs against Amazon listings
2. 2Catalog enrichment: Fill in missing product attributes (dimensions, images, categories)
3. 3Market analysis: Analyze sales rankings across categories and regions
4. 4Compliance: Verify product identifiers match across marketplaces

10. Automating with AI Agents

EcomSource's API is designed to be consumed by AI sourcing agents. Here's a typical automation flow:

1. 1Agent receives a sourcing request — e.g., "Find profitable products in the Kitchen category under $25"
2. 2Agent queries EcomSource — searches by category, filters by price and sales rank
3. 3Agent analyzes variations — identifies which color/size variants sell best
4. 4Agent checks offers — gets real-time pricing and Buy Box data
5. 5Agent generates a report — recommends top products with profit margins

Example: Python Integration

API_URL = "https://api.ecomsource.ai/api/v1/search/product" HEADERS = { "Content-Type": "application/json", "X-Access-Key": "your_access_key", "X-Secret-Key": "your_secret_key" }

def lookup_product(asin): payload = { "identifier": asin, "identifierType": "asin", "region": "US" } response = requests.post(API_URL, json=payload, headers=HEADERS) return response.json()

# Look up a product product = lookup_product("B0BTJD6LCL") print(f"Title: {product['title']}") print(f"UPC: {product.get('upc', 'N/A')}") print(f"Sales Rank: {product.get('salesRank', 'N/A')}") ```

Example: JavaScript / Node.js Integration

const response = await fetch(
  "https://api.ecomsource.ai/api/v1/search/product",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-Access-Key": "your_access_key",
      "X-Secret-Key": "your_secret_key"
    },
    body: JSON.stringify({
      identifier: "B0BTJD6LCL",
      identifierType: "asin",
      region: "US"
    })
  }

const product = await response.json(); console.log(product); ```

Pricing Plans at a Glance

Tips for Getting the Most Out of EcomSource

1. 1Start with the free tier — test the search, explore the data, and try the Chrome Extension before committing
2. 2Use the Postman collection — fastest way to explore the API without writing code
3. 3Cache strategically — product catalog data changes slowly; cache it for 24-48 hours to reduce API calls
4. 4Use refresh sparingly — the `refresh: true` flag forces a live scrape which costs more credits; only use when you need the absolute latest data
5. 5Leverage variations — one parent ASIN lookup gives you data on dozens of child products
6. 6Monitor your usage — the dashboard shows real-time credit consumption so you never hit unexpected limits

Ready to Start?

Whether you need a quick UPC lookup or a full-scale product intelligence pipeline, EcomSource.ai has you covered.

• [Create your free account →](/signup)
• [Explore the API docs →](/docs)
• [Install the Chrome Extension →](https://chromewebstore.google.com/detail/upc-lookup/pglhhlcbcbmfebnagjgmbchpmgokbmpb)
• [View pricing plans →](/pricing)

1.6 Billion+ products. Real-time data. One API.