{"uid":"cap_mvkq9itoRUtyph0zxgNWZ","slug":"syntalic-promo-intelligence-d3750f39","name":"Syntalic Promo Intelligence","description":"Analyze promotional activity within a category - promo frequency, average and max discount depth - over a date range. Pivot the breakdown with `aggregate_by`: default `brand` ranks brands within the category; `retailer` ranks retailers (use together with `brand=<name>` to answer 'which retailers run the deepest promos on Brand X in Category Y'). The response key mirrors the dimension: `brands: [...]` or `retailers: [...]`.","url":"https://api.syntalic.com/v1/marketing/promo-intelligence","method":"GET","headers":{},"bodySchema":{"type":"object","required":["category"],"properties":{"to":{"type":"string","format":"date","example":"2026-05-01","description":"End date (ISO 8601, defaults to now)"},"from":{"type":"string","format":"date","example":"2026-04-01","description":"Start date (ISO 8601, defaults to 30 days ago)"},"brand":{"type":"string","example":"Apple","minLength":1,"description":"Optional brand filter — limit aggregation to products of this brand (case-insensitive)"},"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."},"aggregate_by":{"enum":["brand","retailer"],"type":"string","default":"brand","example":"retailer","description":"Group-by dimension. `brand` (default) ranks brands within the category. `retailer` ranks retailers — pair with `brand` to answer 'which retailers run the deepest promos on Brand X'."}},"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_-_EBWWBzQ6MgO1vPXKXUu","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":"Analyzes promotional activity within a product category — promo frequency, average discount depth, and max discount — aggregated by brand or retailer over a date range.","exampleAgentPrompt":"Which retailers have been running the deepest promotions on Apple products in the electronics category over the last 30 days in the US? Rank them by average discount depth.","exampleUseCases":null,"resultDescription":"Returns a list of brands or retailers ranked by promotional activity within the requested category, including promo frequency (how often items go on sale), average discount percentage, and maximum discount depth observed over the specified date range. The response key mirrors the aggregation dimension: `brands: [...]` for brand aggregation or `retailers: [...]` for retailer aggregation.","failureModes":["Unrecognized or ambiguous category name fails to resolve through fuzzy matching — returns an error or empty results","Date range too narrow returns sparse or zero promo activity","Invalid country code (outside 'us'/'ca') returns a validation error","Brand name not found in the specified category returns an empty result set","Missing required `category` parameter returns a 400 validation error"],"whenToPreferThis":"Use this endpoint when you need to understand the promotional landscape within a product category — who discounts most aggressively, how deep discounts go, and how frequently promotions occur. It is the right choice over Deal Finder (which returns live discounted products) or Brand Tracker (which tracks a single brand's metrics over time) when the goal is cross-brand or cross-retailer comparison of promotional behavior. Especially useful for competitive benchmarking, retailer partnership analysis, or identifying which retailers most aggressively promote a specific brand.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:37:27.704Z","isFirstParty":false}