Skip to main content
GET
/
v1
/
marketing
/
share-of-shelf
See brand market share within a category
curl --request GET \
  --url https://api.crushrewards.dev/v1/marketing/share-of-shelf
{}

Documentation Index

Fetch the complete documentation index at: https://crushrewards.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

​
category
string
required

Product category (e.g., electronics, grocery, beauty). Fuzzy human-readable input — the resolver maps it through tier 1-4 (id → exact name → trigram → embedding kNN) to a canonical category_id. Pair with category_id if you have a deterministic id from a prior call.

Minimum string length: 1
​
category_id
integer

Deterministic category id. When set, bypasses the fuzzy resolver cascade and uses tier 1 (id lookup) directly. Agents that learned a canonical id from a prior call's resolved.category_id should pin it here for round-trip stability.

Required range: x >= 1
​
country
enum<string>
default:us

Country (us or ca)

Available options:
us,
ca

Response

Share of shelf data

The response is of type object.