API Documentation

Integrate your system directly with our live inventory. Authenticate using your private key from the API Key tab.

Authentication

Authorization: Bearer YOUR_API_KEY

Base URL

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

Endpoints

GET / - Retrieve products.

• limit (max: 250)
• sku, upc (Exact match)
• cursor (Pagination)

Response Format

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

General Browsing:

{
    "meta": {
        "rate_limit_remaining": 299,
        "per_page": 250,
        "next_page_cursor": "..." 
    },
    "data": [ ... ]
}

Filtered Queries (SKU/UPC):

{
    "meta": {
        "rate_limit_remaining": 298,
        "total": 1,
        "per_page": 250
    },
    "data": [ ... ]
}

Data Fields

• sku, upc, asin (String) - Identifiers
• itemName, brand, size (String) - Product details
• msrp (Number) - Suggested retail price
• supplier_X_name, supplier_X_price, supplier_X_inventory - Flattened supplier data (sorted by price)

Rate Limit

Errors

• 401: Invalid API Key
• 429: Rate limit exceeded
• 500: Server error