API overview

The Discover Trends API is a read-first REST API over the same live data that powers the app. Base URL, versioning, response shape and a one-minute quickstart.

The Discover Trends API is a read-first REST API over the same live data that powers the app. It speaks JSON, uses conventional HTTP verbs and status codes, and every response is the same number you’d see in the Explorer — the API is a thin, cache-fronted read layer over the app’s own dataset, not a separate system.

#Base URL

All requests go to a single host over HTTPS:

Base URL

https://d2tr.com/api

#Surfaces & versioning

The API is organized into three surfaces, distinguished by their path prefix:

/public/* — public signals and checkers. Open, unauthenticated endpoints for Discover volatility plus lightweight Google Profile and Google News domain checks. No key required.
/v1/* — paid API reference. The full authenticated surface: trends, entities, articles, analytics, geo and url-reach.
/v2/* — feed & realtime. A faster, cursor-friendly feed plus a realtime live endpoint. Shares geo and url-reach with v1.

Prefixes are the version. There is no version header or date — you opt into a surface by the path you call. New fields may be added to responses over time, so parse defensively and ignore unknown keys.

#Requests & responses

All endpoints in this reference are GET requests (the one exception, a collector POST, is called out where it appears). Parameters are passed as query-string values. Responses are always application/json. A successful call returns 200 with the resource; anything else carries a JSON error body — see Errors & rate limits.

Timestamps are ISO-8601 in UTC (for example 2026-07-01T06:00:00Z). Money and counts are plain numbers. List endpoints share a common pagination shape.

#Markets

Most endpoints are scoped to a market with a country (or region) parameter that takes an ISO-3166-1 alpha-2 code — us, de, ru — or all for a global view. If your API key is restricted to specific markets, requests for other markets are rejected; see market scopes.

#Quickstart

The fastest first call needs no key. Fetch the Discover volatility index for the United States:

curl

curl "https://d2tr.com/api/public/discover/volatility?country=us&granularity=day"

Then add a key and hit an authenticated endpoint — the latest feed items for Germany:

curl

curl "https://d2tr.com/api/v2/feed?region=de&limit=20" \
  -H "X-API-Key: $D2TR_API_KEY"

Public APINo-auth Discover signals, Google Profile checks, and Google News checks.Paid APIAuthenticated Discover, Updates, Trends, Google Profile, and News methods.AuthenticationCreate a key and send it with every request.Errors & rate limitsStatus codes, quotas and pagination.