Skip to main content
Shelfforce is a retail shelf analytics API that transforms shelf photos into structured, actionable product data. Submit an image of a retail shelf, and get back every product detected — with SKU identification, facing counts, pricing, promotional status, and brand-level share-of-shelf metrics.

​
Who is Shelfforce for?

Monitor shelf presence, share-of-shelf, and pricing compliance across retail locations. Track how your products are displayed relative to competitors.

​
Key capabilities

Submit shelf photos and receive structured product-level data in seconds. Supports JPEG, PNG, and WebP. Results include every detected SKU with brand, category, size, and confidence score.
Identify SKUs, brands, categories, sizes, and facing counts per product. Each detection includes shelf position (top, eye-level, middle, bottom) and fixture type.
Extract shelf-edge prices and match them to the correct products using spatial reasoning. Detects both regular and promotional pricing.
Create and assign field tasks to specific stores with due dates and compliance criteria. Track task lifecycle from pending through completion.
Compare detected shelf state against brand standards and promotions. Get pass/fail results per compliance check with actual vs. expected values.
Query share-of-shelf, store performance, and pricing reports via API. Filter by date range, brand, category, and location.

​
AI agent ready

Shelfforce is designed for machine-to-machine integration from the ground up.

OpenAPI Spec

Full OpenAPI 3.1 spec at /openapi.json for automatic tool discovery.

llms.txt

LLM-friendly context at /llms.txt optimized for agent comprehension.

Webhooks

Event-driven notifications for analysis completion, task updates, and more.

​
Get started

1

Get your API key

Sign up at shelfforce.ai and generate an API key from Settings.
2

Analyze your first image

Follow the Quickstart to submit a shelf photo and view the results.
3

Explore the API

Browse the full API Reference for every endpoint.