{"uid":"cap_VoD_jfxUwj3KQ1HENOnyU","slug":"decadata-year-on-year-pos-growth-18454c0f","name":"DecaData Year-on-Year POS Growth","description":"Year-on-year growth in point-of-sale sales and units for one of ~380 US consumer companies, by ISIN or ticker, for $0.01: the company's latest reported quarter (91 days to its end) against the same weekdays a year earlier, per panel store and against the covered market (all companies with the same series together). From transactions at eight US retailers, not government aggregates or SEC filings. The daily series: /v1/companies/{id}/sales. Docs: https://api.decadata.io/llms.txt","url":"https://api.decadata.io/v1/companies/:id/yoy?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"pathParams":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"The company: an ISIN (US7134481081), isin:US7134481081, or ticker:PEP"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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_pTc871YYMdiAP_BO0_da6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns year-on-year growth rates in point-of-sale sales and units for a US consumer company for its latest reported quarter, benchmarked against the prior year and covered market peers.","exampleAgentPrompt":"Pull the year-on-year point-of-sale sales and unit growth for PepsiCo — ticker PEP — for its latest reported quarter, including how it compares to the covered market.","exampleUseCases":[{"title":"Equity research sales check","prompt":"I'm analyzing PepsiCo ahead of earnings — can you get me the actual POS-based year-on-year sales growth for ticker:PEP for the most recent quarter and tell me how that compares to the broader covered market?"},{"title":"Consumer brand market share monitor","prompt":"I want to know whether Colgate is gaining or losing ground at retail — pull the YoY sales and unit growth for ticker:CL for their latest quarter versus the covered market peers."},{"title":"CPG competitor benchmarking","prompt":"Get me the year-over-year POS sales growth for ISIN US7134481081 for the latest reported quarter so I can benchmark it against the consumer sector."}],"resultDescription":"Returns year-on-year percentage growth in point-of-sale sales and units for the specified company covering the latest reported quarter (approximately 91 days ending at the quarter close) versus the same weekday-aligned period one year prior. Data is broken out per panel store and against the covered market (all ~380 companies with the same data series), derived from actual transaction data at eight US retailers — not government aggregates or SEC filings.","failureModes":["Unknown or unsupported company identifier — company not in the ~380-company coverage universe returns an error or empty result","Invalid ISIN or ticker format returns a 400 bad request","Payment not processed (x402 protocol failure) results in a 402 Payment Required response","No data available for the latest quarter if the company has not yet reported or data has not been ingested","Rate limiting or quota exceeded may return a 429 error"],"whenToPreferThis":"Choose this endpoint when you need transaction-based (not survey or government-aggregate) year-on-year sales growth for a specific US consumer company for its most recent quarter, with peer benchmarking. Prefer this over SEC filing scrapers or government data when you want real POS signal from retail transactions across eight US retailers. Use the daily series endpoint (/v1/companies/{id}/sales) if you need time-series granularity rather than a single quarterly YoY summary.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:04:14.848Z","isFirstParty":false,"canonicalSlug":"decadata-year-on-year-pos-growth-18454c0f"}