Обзор API

Сделайте первый запрос и разберитесь с версиями, рынками и ответами

Discover Trends API возвращает те же данные, которые вы видите в приложении. Через него можно получать публикации, тренды, сущности, аналитику и открытые сигналы Discover в формате JSON.

#Базовый URL

Базовый URL
https://dstrends.com/api

#Версии и разделы

  • /public/* содержит открытые методы. Ключ не нужен.
  • /v1/* содержит основные методы для трендов, сущностей, публикаций, аналитики и географии.
  • /v2/* содержит ленту, свежие данные и охват URL.

Версия указана прямо в адресе. В ответы могут добавляться новые поля, поэтому клиенту стоит спокойно пропускать незнакомые ключи.

#Запросы и ответы

Большинство методов используют GET. Массовые проверки используют POST с JSON в теле запроса. Успешный ответ обычно имеет код 200 и тип application/json.

Время передаётся в ISO 8601 и UTC, например 2026-07-01T06:00:00Z. Правила ошибок и постраничной выдачи описаны в разделе «Ошибки и лимиты».

#Рынки

Параметры country и region принимают двухбуквенный код страны, например ru, kz или us. Значение all выбирает все доступные рынки.

Если API-ключ ограничен несколькими странами, запрос другого рынка вернёт ошибку. Подробнее об этом написано в разделе «Доступ к рынкам».

#Первый запрос

Публичный метод работает без ключа:

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

Для закрытых методов добавьте ключ в заголовок:

curl
curl "https://dstrends.com/api/v2/feed?region=kz&limit=20" \
  -H "X-API-Key: $DTR_API_KEY"