{"uid":"cap_3AIZBe8je3P5nqq0Izei8","slug":"decadata-company-sales-units-a3ca598f","name":"DecaData Company Sales & Units","description":"Point-of-sale sales and units for ~380 US consumer companies, by ISIN or ticker, from transactions at eight US retailers: not government aggregates or SEC filings. Daily for the largest, weekly for all, from 2018, at T+7; each brand mapped to its owner at the time, history never restated. From $1 a request, priced per company-day. Free: sample (/v1/companies/{id}/sample), quote (/v1/quote), coverage (/v1/coverage). Docs: https://api.decadata.io/llms.txt","url":"https://api.decadata.io/v1/companies/%7Bid%7D/sales?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"}}},"queryParams":{"type":"object","properties":{"to":{"type":"string","description":"Last day, YYYY-MM-DD (default: the latest on sale, T+7)"},"freq":{"enum":["daily","weekly"],"type":"string","description":"daily (tiers 1-2) or weekly"},"from":{"type":"string","description":"First day, YYYY-MM-DD (default: to, or the week of to if weekly)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"to":"2026-09-01","freq":"daily","from":"2026-09-01","rows":[{"date":"2026-09-01","sales":740000.49,"units":160000,"panel_stores":2100,"unique_stores":null,"unique_customers":null}],"company":{"isin":"US7134481081","name":"PEPSICO INC","tier":1,"ticker":"PEP","last_date":"2026-10-07","first_date":"2018-01-01"},"licence":"Licensed to the purchaser for its own research. No redistribution or resale.","receipt":"rcpt_5f0c2a9d81e4b7c36a10","currency":"USD","price_usd":5,"available_through":"2026-10-07"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"5","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":"$5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KR7KbyBEDYH7xVMQlycWY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns daily or weekly point-of-sale sales dollars and unit counts for a specific US consumer company, sourced from transactions at eight US retailers, identified by ISIN or ticker.","exampleAgentPrompt":"Pull me the daily point-of-sale sales and units for PepsiCo (ticker PEP) from September 1 to September 30, 2026 using DecaData — I want actual retail transaction data, not SEC filings.","exampleUseCases":[{"title":"Equity research sales check","prompt":"Get me the weekly retail sales and unit volumes for Coca-Cola (ticker KO) for the past four weeks from DecaData — I need actual POS transaction data to compare against their earnings guidance."},{"title":"CPG brand performance monitoring","prompt":"Fetch daily point-of-sale sales and units for Procter & Gamble (ISIN US7427181091) for all of August 2026 — I want to track how their brands performed week over week at US retailers."},{"title":"Historical retail trend analysis","prompt":"Pull weekly POS sales data for Kellogg's by ticker K going back to January 2020 through December 2022 using DecaData, so I can build a multi-year trend of their retail volumes."}],"resultDescription":"Returns a JSON object with the queried date range, frequency, and an array of rows each containing date, sales (USD), units sold, number of panel stores, and optionally unique stores and customers. Also includes company metadata (ISIN, ticker, name, tier, first/last available date), currency, price paid, licence notice, and a receipt ID.","failureModes":["Company not in coverage (~380 companies supported) — returns error or empty result","Date range outside available history (data starts 2018-01-01) — returns no rows","Requesting daily frequency for a tier-3 company only available weekly — may return error or fall back","Invalid ISIN or ticker format — schema validation error","Insufficient payment or payment failure — 402 response blocking data delivery","Future date requested beyond T+7 availability — no data returned"],"whenToPreferThis":"Choose this endpoint when you need actual point-of-sale retail transaction data (sales dollars and unit volumes) for a specific US consumer company, as opposed to government aggregates, SEC filings, or analyst estimates. Prefer this when you need company-level granularity by ISIN or ticker, historical data back to 2018, daily or weekly cadence, and brand-to-owner mapping that reflects ownership at the time of sale without restated history.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T07:02:58.052Z","isFirstParty":false,"canonicalSlug":"decadata-company-sales-units-a3ca598f"}