Changelog contract 1.6.2
What changed in the API contract. Data restatements are listed separately, per publication, by GET /v1/changelog.
Google search point-in-time reads
/v1/company/{ticker}/search, /v1/company/{ticker}/search/history, /v1/search/trends and /v1/search/trends/{trend_id}/series now take kdate and history_mode. Recorded from the first snapshot, which kdate 2026-11-04 Eastern reads; earlier history is reconstructed and labelled. Requests without kdate are unchanged. /v1/search/brands, /v1/search/trends/map, bulk ZIPs, observed_at and kdate=all are not supported. See Google search at a kdate for held companies, the row dated kdate and the trial cutoff.
CVS behavior-metric coverage hold
The affected publication withholds six CVS behavior metrics pending verified remeasurement. Raw and corrected values are null/blank with explicit query-semantics coverage issues; mentions and switching counts remain. Complete-tail claims apply only to unheld metrics. Recorded pre-hold vintages retain their original values without retrospective hold annotations. See the metric-hold contract.
Company search current/history policy
Current search now requires a complete approved active basket within the snapshot’s recorded closed_calendar_day and the preceding 14 days. Finalization records that day when generating the snapshot; serving validates against that metadata, not a moving runtime wall clock. Companies without one receive a company-local 404; preserved legacy rows remain accessible through /v1/company/{ticker}/search/history with explicit uncertified-basket and non-PIT disclosures. Unsupported repaired tails are excluded from current serving. Native weekly source archives remain archive-only, not served. See the current/history contract.
Search company identity update
Client search routes map VSCO and VSXY to company 27124 with canonical output VSXY. BBBY selects current company 28701 within approved brand ownership windows. Mapped company-search JSON envelopes add company_id, canonical_ticker and search_alias_policy=company_lifetime. Internal raw search gains no newly supported aliases; X dated identity and resolution are unchanged. See search identity semantics.
2026-11-02 · Search bulk date parity
Search bulk exports now apply the API's client date, ownership, completeness and tier embargo filters. The deployed repair was checked against every company in the subscription export and a trial canary sample. This validates row parity; it does not certify identity or source accuracy.
2026-11-02 · BGS historical measurement correction
The X company publication company-xrep-20261101-20261102T142630Z applies the previously approved replacement of the ambiguous brand term Accent with Accent seasoning. Affected BGS center-store history was remeasured to exclude unrelated uses of the word. The resulting lower counts should not be read as an equivalent fall in consumer demand.
For June 1, 2026, BGS company-level mentions changed from 4,264 to 185 and purchase-intent counts from 170 to 7. Earlier published values remain in historical release vintages. This note explains the existing restatement; it introduces no further data change.
2026-11-04 · contract 1.6.2
- Google search trends.
GET /v1/search/trends,/v1/search/trends/mapand/v1/search/trends/{trend_id}/seriesserve the consumer trends measured in Google search, daily, with the sametrend_ids as the X trends./v1/statuslistssearch_trends. See search trends. - X trend series. A day whose spike is under review, or a reviewed spike removed as noise, serves
correctednull; a day declared incomplete servesrawandcorrectednull. Trend names are the current ones everywhere.
Contract 1.6.1
Google search interest is published
GET /v1/company/{ticker}/search(brand rows, orrollup=tickerfor the company line) andGET /v1/search/brandsare open to trial and subscription keys, with verified brands only. See Search API.- Every search response discloses the company's
coverage(alsox-search-coverageandx-search-verified-brandson CSV). A company below 25% coverage, or with no verified brand, is404 not covered. - Brand rows carry
resolution:dailyorweekly, by the Google values they are built from. - Trial keys get permanent brand ids
TICKER#bN. GET /v1/bulk?dataset=searchlists the search drop;/v1/statuslistssearch_interest.
Client data contract
- Counts are integers.
rawandcorrectedare JSON integers, and CSV writes them without.0. - Corrections.
correct=takes onlymeme,incident,investor,marketing,demand_event(orrecommended,none,all); any other category is400 unknown correction category.flaglists those client categories only. A row awaiting spike review reportscoverage_statuspending_review. - Entity ids come from the client registry and never change once shipped (for example
AAL#airlinesis nowAAL, and Coinbase's Deribit carve-out isCOIN#deribit). See identifiers. - Universe and entities. Added
perm_id,figi,is_primary,coverage_start,coverage_end,coverage_statusandticker_recorded_from; removedn_brands,n_brands_count_typeand the alias and brand detail columns. Delisted and acquired names are listed, withvalid_to. - Ownership clip. No row of an entity outside its
valid_from..valid_towindow, in any format or drop.COIN#deribitstarts 2025-08-14. See ownership windows. - Metrics.
rollup=tickeraddsflagandticker_at_date; entity rows adddivisionandticker_at_date. Newwindow=7|28addswindow_sum,base_sumandlow_volume. Responses past the data's last day say so withtruncated_to. - Cross-sections add
base_date,base_sum,low_volumeandticker_at_date, and takekdate. - Trends. The catalog is exactly
trend_id,name,group,mapped_tickers(an integer),mapped_datasets. The map'sweightis signed (+ long, − short) and replacesside. - Resolve.
isinis removed. - Changelog rows now say what each publication changed;
detail=companygives per-company date ranges. Olderkdatevintages carrysuperseded_by. - New:
GET /v1/platform/breaks. - Bulk.
/v1/bulklists client-shaped drops (company_demand,trends) withdataset,version,bytes,sha256andurl, built daily at 06:30 Eastern. See bulk downloads. - Formats.
format=parquetandformat=arrowreturn the whole result as one file. - Status.
/v1/statusreleasecarries only its documented fields,as_ofamong them. - Limits. A burst guard (300 requests, refilled at 50 a second, per key) and a bulk-job cap replace the trial per-minute limit and its
X-RateLimit-*headers. See limits. - Withdrawn. The hiring and platform-denominator datasets are gone; their paths answer
404.