Request
curl -X POST https://api.shelfforce.ai/v1/analyses \
-H "Authorization: Bearer sf_live_..." \
-H "Content-Type: application/json" \
-d '{
"image_url": "https://example.com/shelf.jpg",
"store_id": "store_abc123"
}'200 OKResponse
{
"id": "analysis_7xK2m",
"status": "completed",
"products": [
{
"brand": "Coca-Cola",
"name": "Coca-Cola Original 500ml",
"facings": 4,
"position": "middle",
"price": 1.99,
"currency": "USD",
"on_sale": false
},
{
"brand": "Pepsi",
"name": "Pepsi Max 500ml",
"facings": 3,
"position": "middle",
"price": 1.89,
"currency": "USD",
"on_sale": true
}
],
"summary": {
"total_products": 12,
"total_facings": 38,
"brands_detected": 6
}
}Everything you need to build on shelf data
Shelf Analysis
Submit shelf images and receive structured product data — brands, SKUs, facings, prices, and compliance scores.
Product Detection
Automatic SKU identification, facing counts, shelf position, and price extraction from shelf photos.
Task Management
Create audit tasks, assign them to stores and field reps, and track completion programmatically.
Store Management
Full CRUD operations for retail locations — create, update, search, and organize stores by region or channel.
Reports & Analytics
Query share of shelf, compliance scores, and store performance. Export as PDF, CSV, or PowerPoint.
Webhooks
Real-time notifications when analyses complete, tasks update, or compliance thresholds are breached.
Built for AI Agents
First-class support for LLM tool use, autonomous workflows, and agent-to-agent integrations.
OpenAPI spec for automatic tool discovery
llms.txt for context injection
Idempotency keys for safe retries
Webhook-driven workflows