Documentation
Everything you need to work with Discover Trends Tracker — from setting up your first project in the app to querying the Discover API in production.
Discover Trends Tracker (D2TR) monitors what Google surfaces in the Google Discover feed — the algorithmic “for you” stream on phones — and turns it into structured, queryable analytics across countries, languages and cities. Every few minutes we poll Discover from many markets, parse each article, summarize and translate it, classify it, extract the entities it mentions, and cluster everything into trends.
There are two ways to work with that data: the app, a live dashboard for exploring the feed, tracking entities and planning content; and the API, a read-first REST interface over the exact same data. This documentation covers both.
#Try the API in one call
The Discover volatility signals are public — no key required. This returns a 0–10 index of how much the Discover feed is reshuffling day to day (a spike is an early warning of an unannounced Discover update). Run it right now:
curl "https://d2tr.com/api/public/discover/volatility?country=us&granularity=day"Everything else — the feed, trends, entities, analytics — lives behind an API key. See Authentication to get one.
#Core concepts
A quick glossary you’ll see throughout the app and the API:
- Volatility index — a 0–10 score of how much the Discover feed reshuffles over a 30-day baseline. ~3 is a calm period; ≥7 is an anomaly. It’s the earliest signal of an unannounced Discover update.
- Entities — the people, companies, places, events and products mentioned in each article, extracted and linked to the Google Knowledge Graph and Wikipedia.
- Trends — clusters of articles about the same evolving story, each with its own lifecycle, daily article counts and momentum.
- Themes & topics — the two levels above trends: topics group related trends, themes group related topics — a “big story → sub-stories → articles” tree.
- Formats — how an article is packaged: five groups (News, Analysis, Service, Ritual, Atmosphere) and finer types. Shows which kinds of content Discover is favoring.
- URL reach — the estimated impressions a URL (or, rolled up, a domain / category / trend) gets in the feed. The metric behind rankings and share-of-impressions.
- Markets — the country / language dimension. Every metric can be filtered by an ISO alpha-2 country code (
us,de, …) orallfor global.