Share of shelf
Share of shelf
Aggregates shelf unit counts by brand over a time period. Use this to understand brand visibility relative to competitors.
GET
Share of shelf
Authorizations
API key with sf_live_ prefix. Pass as Authorization: Bearer sf_live_...
Query Parameters
Lookback period in days (default 30).
Required range:
1 <= x <= 365Example:
30
Filter by project ID.
Example:
"prj_def456"
Comma-separated list of brand names to include.
Example:
"Coca-Cola,Pepsi,Dr Pepper"
Comma-separated list of categories to include.
Example:
"Beverages,Snacks"
Comma-separated list of ISO 3166-1 alpha-2 country codes.
Example:
"US,GB"
Comma-separated list of retail channels.
Example:
"grocery,convenience"
Response
Share-of-shelf report.