💻 API Documentation

RESTful API for UPC and barcode lookup. Simple, fast, and reliable.

Getting Started

Base URL

            https://searchupcdata.com/api
          

Authentication

For programmatic API access, you need to include an API key in your requests. Create a free account and generate your API key from the API Keys page.

Include your API key in the Authorization header:

              Authorization: Bearer YOUR_API_KEY
            

Response Format

All API responses are returned in JSON format. Successful requests return a 200 status code along with the requested data.

Rate Limiting & Usage Quotas

API usage is tracked per API key with monthly quotas based on your pricing tier:

Free Tier: 1,000 requests per month
Starter Tier: 10,000 requests per month
Pro Tier: 100,000 requests per month
Enterprise Tier: Unlimited requests

API Endpoints

GET /api/products/:upc

Get product information by UPC code

Parameters

upc (string, required) - The UPC code to look up

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://searchupcdata.com/api/products/7865578655204

Example Response

{
  "id": "e062a65b-5661-4662-ba70-6775e55d2556",
  "upc": "7865578655204",
  "name": "Taqwa XXXL Steamed Basmati Rice",
  "description": "Delicious steamed basmati rice 10lb",
  "imageUrl": "https://...",
  "brand": "Taqwa",
  "category": "Rice"
}

GET /api/products/search

Search products by UPC code, name, or brand

Parameters

query (string, required) - Search term (UPC, product name, or brand)

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://searchupcdata.com/api/products/search?query=rice"

GET /api/products/search/advanced

Advanced search with filters for brand and category

Parameters

query (string, optional) - Search term

brand (string, optional) - Filter by brand name

category (string, optional) - Filter by category

GET /api/products/brands

Get list of all unique brands in the database

GET /api/products/categories

Get list of all unique categories in the database

Error Handling

When an error occurs, the API will return an appropriate HTTP status code along with an error message in JSON format.

Common Error Codes

401

Unauthorized

API key missing or invalid. Include a valid API key in the Authorization header.

403

Forbidden

Your API key has been deactivated. Contact support for assistance.

404

Not Found

The requested product does not exist in our database.

429

Quota Exceeded

Monthly quota exceeded. Upgrade your plan or wait for next month's reset.

500

Internal Server Error

An unexpected error occurred. Please try again later.

Ready to Get Started?

Create a free account and start integrating our UPC lookup API today.

Try Free Search View All Features