{"uid":"cap_iAl9LDG6Egdl3W4dP8KG9","slug":"brand-tracker-d042c2d2","name":"Brand Tracker","description":"Track a brand's average/min/max price, product count, in-stock count, and promo count day-by-day across a date range.","url":"https://api.syntalic.com/v1/marketing/brand-tracker","method":"GET","headers":{},"bodySchema":{"type":"object","required":["brand"],"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":"Brand name (e.g., Sony, Samsung, Nike)"},"country":{"enum":["us","ca"],"type":"string","default":"us","example":"us","description":"Country (us or ca)"}},"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_OA-C38rf8nlWsEMCxz73F","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":"Tracks a brand's average, min, and max price, product count, in-stock count, and promo count day-by-day across a specified date range.","exampleAgentPrompt":"Can you pull day-by-day pricing and promo stats for Nike in the US from April 1 to May 1, 2026 — I want to see the average, min, and max price, plus how many products were in stock and on promotion each day?","exampleUseCases":null,"resultDescription":"Returns a time-series dataset broken down by day, showing for the specified brand: average price, minimum price, maximum price, total product count, number of in-stock products, and number of products on promotion — covering each day within the requested date range.","failureModes":["Brand name not found or unrecognized — returns empty dataset or 404","Invalid date format — returns 400 validation error","Date range too large — may time out or return partial data","Unsupported country code — returns 400 validation error","Missing required 'brand' parameter — returns 400 validation error"],"whenToPreferThis":"Use this endpoint when you need longitudinal, day-by-day visibility into a single brand's pricing and availability metrics. It is ideal for trend analysis, monitoring promotional cadence, and tracking stock levels over time. Prefer this over Price Positioning (which compares to category) or Promo Intelligence (category-level) when the focus is a specific brand's own metrics over time.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:32:50.167Z","isFirstParty":false}