{"uid":"cap_cztjnS4wG4j0YqwauDAbZ","slug":"api-crushrewards-dev-e80935d4","name":"Crush Rewards Share-of-Shelf API","description":"Real-time pricing, promotions, and competitive intelligence across US and Canadian retailers — exposed as paid API endpoints and MCP tools that AI agents can call directly, with x402 and MPP micropayments per query.","url":"https://api.crushrewards.dev/v1/marketing/share-of-shelf","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"type":"json"},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"country":"us","category":"beauty"}}},"response":{"_truncated":true,"_originalSize":35089}},"exampleRequest":{"country":"us","category":"beauty"},"tags":["x402"],"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_ByTIsQUYPT_WwNQgtp1Qq","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":"Returns share-of-shelf marketing insights — brand and product visibility metrics — for a given product category and country.","exampleAgentPrompt":"What's the share-of-shelf breakdown for brands in the beauty category in the US? I want to see which brands dominate shelf presence.","exampleUseCases":null,"resultDescription":"Returns share-of-shelf marketing insights for brands and products within the specified category, including brand visibility and product presence metrics across retailers. The response includes a resolved canonical category identifier for use in subsequent calls.","failureModes":["Missing required 'category' parameter returns a 400 validation error","Unrecognized category string that fails all fuzzy resolver tiers (id, exact, trigram, embedding) returns an error or empty results","Invalid country value (not 'us' or 'ca') returns a 400 validation error","category_id that does not exist in the database returns a not-found error","Payment not included or insufficient USDC returns a 402 Payment Required error"],"whenToPreferThis":"Use this endpoint when you need to understand how brands are distributed across shelf space within a product category — for competitive analysis, brand benchmarking, or retail marketing intelligence. Prefer over price or promo endpoints when the goal is visibility and presence rather than pricing. If you already have a canonical category_id from a prior call, pass it directly to bypass fuzzy matching and improve stability.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:30:48.931Z","isFirstParty":false}