Supplier DB V2

API Documentation

Use our API to integrate your system with our live product database. All requests must be authenticated using your private API key.

Authentication

Include your API key in the Authorization header for every request. You can generate and manage your key in the "API Key" tab.

Authorization: Bearer YOUR_API_KEY

Base URL

https://supplier-api-977359606390.us-central1.run.app

Endpoints & Parameters

GET /

Returns a paginated list of products. You can filter by SKU or UPC.

• page (optional, default: 1) - The page number to retrieve.
• limit (optional, default: 250, max: 250) - The number of items to return per page.
• sku (optional) - Filter results for a single product by its SKU.
• upc (optional) - Filter results for a single product by its UPC.

Response Format

All successful requests will return a JSON object with meta and data keys.

{
    "meta": {
        "total": 1287,
        "current_page": 1,
        "total_pages": 6,
        "per_page": 250,
        "rate_limit_remaining": 299
    },
    "data": [
        {
            "sku": "12345",
            "upc": "012345678901",
            "itemName": "Example Perfume",
            "brand": "Designer Brand",
            "size": "100ml",
            "asin": "B08X44T43G",
            "msrp": 95.00,
            "supplier_1_name": "Main Distributor",
            "supplier_1_price": 75.99,
            "supplier_1_inventory": 150,
            "supplier_2_name": "Secondary Wholesaler",
            "supplier_2_price": 78.50,
            "supplier_2_inventory": 45
        },
        ...
    ]
}

Data Object Fields

Error Responses

If a request fails, the API will return a JSON object with an error key.

• 401 Unauthorized: The API key is missing, invalid, or has been revoked.

  { "error": "Unauthorized: Invalid API key." }

• 429 Too Many Requests: The user has exceeded the 300 requests per day limit.

  { "error": "You have exceeded the 300 requests in 24 hrs limit!" }

• 500 Internal Server Error: An unexpected error occurred on the server.

  { "error": "An unexpected error occurred." }

Example Request (cURL)

# Get page 2 with 50 items per page
curl -L -X GET "https://supplier-api-977359606390.us-central1.run.app?page=2&limit=50" \
     -H "Authorization: Bearer YOUR_API_KEY"

Example Request (Filtering by SKU)

# Get a single product by its SKU
curl -L -X GET "https://supplier-api-977359606390.us-central1.run.app?sku=PRODUCT-SKU-123" \
     -H "Authorization: Bearer YOUR_API_KEY"