Embed FMCG Intelligence Into Your Platform

Full API access to AI-powered shelf recognition, order optimization, customer segmentation, and route planning. White-label ready. Sub-account management built in.

Start Free Trial View API Documentation

shelf-recognition.sh

POST/v1/recognize

{
  "product": "shelf-recognition",
  "image_url": "https://cdn.example.com/shelf.jpg",
  "store_id": "STR-4821",
  "options": {
    "detect_brands": true,
    "planogram_check": true
  }
}

API-First Architecture

Every capability is available through clean, versioned REST APIs. No UI dependency. Build the experience your customers need.

RESTful API Design

Clean, predictable endpoints following REST conventions. JSON request/response format, standard HTTP status codes, and comprehensive error messages.

Dual Authentication

Choose between HMAC signatures for service-to-service calls or JWT bearer tokens for user-context requests. Both provide enterprise-grade security.

Real-Time Webhooks

Subscribe to events across all products. Receive real-time notifications for completed analyses, generated orders, segment changes, and route optimizations.

Sub-Account Management

Manage multiple client organizations under your parent account. Each sub-account gets isolated data, independent usage tracking, and configurable credit allocations.

Create and manage sub-accounts via API
Allocate credits from your pool to each sub-account
Per-sub-account usage reporting and billing
Complete data isolation between sub-accounts
White-label — your clients see your brand, not ours

Your Account

Vendor Platform

50,000 credits|5 products

Acme Foods

ACM-001

5,000/mo

Isolated data

Northwind

NWD-001

10,000/mo

Isolated data

Globex

GLX-001

Unlimited

Isolated data

Credit pooling·Data isolation·Usage tracking

Integration in Four Steps

From API key to production in a single afternoon.

Get API Credentials

Set Up Authentication

Implement HMAC signature generation or JWT token flow. Verify connectivity with our sandbox environment.

Integrate Product APIs

Call the product APIs you need — shelf recognition, order suggestions, segmentation, caller ID, or route optimization. Each is independent.

Configure Webhooks

Subscribe to events for asynchronous operations. Receive results via webhooks instead of polling for long-running tasks.

Real-Time Event System

Subscribe to events across all products. Each webhook delivery includes a signature for verification, a unique event ID for deduplication, and automatic retries with exponential backoff.

Webhook Flow

Your App

API Call

FMCG Cloud

Process

Webhook

Your Server

recognition.completedPOST → your-server.com/webhooks

order.suggestedPOST → your-server.com/webhooks

credit.deductedPOST → your-server.com/webhooks

Key Benefits for Software Vendors

RESTful APIs with comprehensive documentation
Sub-account management — bill your clients through your platform
Credit pooling — buy credits in bulk, allocate to sub-accounts
HMAC-authenticated service-to-service calls
No UI dependency — use our APIs, build your own experience

Start Building with FMCG Cloud

Get your API credentials and start integrating today. Full sandbox access with no credit card required.

Start Free Trial View API Documentation