{"uid":"cap_gEXdZrVzYTQeJLuYDtoIU","slug":"share-of-shelf-1ebe1156","name":"Share Of Shelf","description":"Measure each brand's market share within a category by product count. Shows digital shelf dominance.","url":"https://api.syntalic.com/v1/marketing/share-of-shelf","method":"GET","headers":{},"bodySchema":{"type":"object","required":["category"],"properties":{"country":{"enum":["us","ca"],"type":"string","default":"us","example":"us","description":"Country (us or ca)"},"category":{"type":"string","example":"electronics","minLength":1,"description":"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."},"category_id":{"type":"integer","example":1,"minimum":1,"description":"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."}},"additionalProperties":false},"responseSchema":{"type":"object"},"example":null,"exampleRequest":null,"tags":["x402","shopping"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ocrtiplailMrBoF6olS43","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Measures each brand's share of a product category by product count, revealing digital shelf dominance across retailers.","exampleAgentPrompt":"What's the share of shelf for each brand in the US electronics category — which brands have the most products listed and who dominates the digital shelf?","exampleUseCases":null,"resultDescription":"Returns each brand's share of the category expressed as a proportion of total product count, along with product counts per brand, revealing which brands have the strongest digital shelf presence within the specified category and country.","failureModes":["Category not recognized or cannot be resolved — returns an error if the fuzzy resolver cannot map the input to a canonical category","Invalid country code — only 'us' and 'ca' are accepted","category_id not found — if a pinned category_id does not exist in the catalog","Empty category with no products — may return empty or zero-count results","Rate limit or payment failure — 402 response if payment is not processed correctly"],"whenToPreferThis":"Use this endpoint when you need to understand brand-level product count distribution within a category — i.e., how many SKUs each brand has relative to competitors. Prefer this over Brand Tracker (which focuses on price/stock time-series for a single brand) or Competitive Landscape (which lists individual products) when the goal is a high-level brand dominance snapshot by product count.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:43:21.296Z","isFirstParty":false}