Тренды

Получайте тренды, публикации и связи между сюжетами

Тренд объединяет публикации одного развивающегося сюжета. API возвращает карточку тренда, связанные материалы, родительские связи и иерархию сюжетов и тем.

#Список трендов

GET/v1/trendsAPI key

Параметры запроса

statestringнеобязательный: emerging, hot, persistent, seasonal_dormant или decayed.
structural_typestringнеобязательный: event_driven, evergreen, cyclic, derivative или unknown.
semantic_typestringнеобязательный: news, event_based, seasonal, lifestyle, evergreen или unclassified.
topic_idstring (UUID)необязательный: Оставить тренды одной темы.
theme_idstring (UUID)необязательный: Оставить тренды всех тем внутри одного сюжета.
min_articlesintegerнеобязательныйпо умолчанию 1: Минимальное число публикаций. Значение 0 отключает фильтр.
sort_bystringнеобязательныйпо умолчанию last_article_at: last_article_at, first_seen_at или article_count.
sort_orderstringнеобязательныйпо умолчанию desc: asc или desc.
limitintegerнеобязательныйпо умолчанию 50: Размер страницы от 1 до 200.
offsetintegerнеобязательныйпо умолчанию 0: Число пропущенных трендов.

curl

curl -s "https://dstrends.com/api/v1/trends?state=hot&structural_type=event_driven&min_articles=5&sort_by=article_count&sort_order=desc&limit=2" \
  -H "X-API-Key: $DTR_API_KEY"

Ответ

{
  "trends": [
    {
      "id": "3f8b1c2a-9d44-4e10-8f21-77a0c6b5e123",
      "label": "Champions League final",
      "label_ru": "Финал Лиги чемпионов",
      "state": "hot",
      "structural_type": "event_driven",
      "semantic_type": "event_based",
      "article_count": 428,
      "first_seen_at": "2026-05-20T08:14:00Z",
      "last_article_at": "2026-05-31T21:07:00Z",
      "key_entities": ["UEFA", "Real Madrid", "Wembley"],
      "primary_country": "GB",
      "country_scope": ["GB", "ES", "FR"]
    }
  ],
  "total": 137,
  "limit": 2,
  "offset": 0
}

Поля переведённых названий могут быть пустыми. Основное значение находится в label.

#Карточка тренда

GET/v1/trends/{trend_id}API key

Параметры пути

trend_idstring (UUID)обязательный: Идентификатор тренда.

curl

curl -s "https://dstrends.com/api/v1/trends/3f8b1c2a-9d44-4e10-8f21-77a0c6b5e123" \
  -H "X-API-Key: $DTR_API_KEY"

Ответ

{
  "id": "3f8b1c2a-9d44-4e10-8f21-77a0c6b5e123",
  "label": "Champions League final",
  "state": "hot",
  "article_count": 428,
  "daily_counts_180d": [0, 1, 3, 5, 12, 40, 8, 2],
  "features": {
    "days_active": 11,
    "total_articles": 428,
    "slope_14d": 12.7,
    "current_share_7d": 0.041
  },
  "created_at": "2026-05-20T08:20:00Z",
  "updated_at": "2026-05-31T21:10:00Z"
}

daily_counts_180d содержит до 180 дневных значений от старых к новым. Любое значение в features может быть равно null, если показатель ещё не рассчитан.

#Публикации тренда

GET/v1/trends/{trend_id}/articlesAPI key

Параметры пути

trend_idstring (UUID)обязательный: Идентификатор тренда.

Параметры запроса

sort_bystringнеобязательныйпо умолчанию first_seen_at: first_seen_at, published_at или assignment_score.
sort_orderstringнеобязательныйпо умолчанию desc: asc или desc.
rolestringнеобязательный: F1_trigger, F2_pile_on, F3_long_tail или F5_one_off.
limitintegerнеобязательныйпо умолчанию 50: Размер страницы от 1 до 200.
offsetintegerнеобязательныйпо умолчанию 0: Число пропущенных публикаций.

curl

curl -s "https://dstrends.com/api/v1/trends/3f8b1c2a-9d44-4e10-8f21-77a0c6b5e123/articles?role=F1_trigger&sort_by=assignment_score&limit=2" \
  -H "X-API-Key: $DTR_API_KEY"

Ответ

{
  "trend_id": "3f8b1c2a-9d44-4e10-8f21-77a0c6b5e123",
  "articles": [
    {
      "id": "a17c9e02-4d31-4b88-bb0e-2f9d1c4e7a01",
      "url": "https://www.example-sport.com/ucl-final-recap",
      "title": "Champions League final: full recap",
      "domain": "example-sport.com",
      "country_code": "GB",
      "assignment_score": 0.87,
      "trend_role": "F1_trigger"
    }
  ],
  "total": 1,
  "limit": 2,
  "offset": 0
}

#Родительские связи

GET/v1/trends/{trend_id}/parentsAPI key

Параметры пути

trend_idstring (UUID)обязательный: Идентификатор дочернего тренда.

curl

curl -s "https://dstrends.com/api/v1/trends/3f8b1c2a-9d44-4e10-8f21-77a0c6b5e123/parents" \
  -H "X-API-Key: $DTR_API_KEY"

Ответ

{
  "trend_id": "3f8b1c2a-9d44-4e10-8f21-77a0c6b5e123",
  "parents": [
    {
      "parent_id": "0a1b2c3d-4e5f-6071-8293-a4b5c6d7e8f9",
      "parent_label": "European football",
      "relation_type": "specialization",
      "strength": 0.74
    }
  ]
}

Метод возвращает все прямые связи. Пагинации нет.

#Дочерние связи

GET/v1/trends/{trend_id}/childrenAPI key

Параметры пути

trend_idstring (UUID)обязательный: Идентификатор родительского тренда.

curl

curl -s "https://dstrends.com/api/v1/trends/0a1b2c3d-4e5f-6071-8293-a4b5c6d7e8f9/children" \
  -H "X-API-Key: $DTR_API_KEY"

Ответ

{
  "trend_id": "0a1b2c3d-4e5f-6071-8293-a4b5c6d7e8f9",
  "children": [
    {
      "child_id": "3f8b1c2a-9d44-4e10-8f21-77a0c6b5e123",
      "child_label": "Champions League final",
      "relation_type": "specialization",
      "strength": 0.74
    }
  ]
}

#Список сюжетов

GET/v1/themesAPI key

Возвращает верхний уровень иерархии. Список сортируется по числу публикаций.

curl

curl -s "https://dstrends.com/api/v1/themes" \
  -H "X-API-Key: $DTR_API_KEY"

Ответ

{
  "themes": [
    {
      "id": "9c8b7a6d-5e4f-3021-1a2b-3c4d5e6f7081",
      "label": "Sports",
      "label_ru": "Спорт",
      "n_trends": 512,
      "n_articles": 84210
    }
  ]
}

#Темы внутри сюжета

GET/v1/themes/{theme_id}/topicsAPI key

Параметры пути

theme_idstring (UUID)обязательный: Идентификатор сюжета.

curl

curl -s "https://dstrends.com/api/v1/themes/9c8b7a6d-5e4f-3021-1a2b-3c4d5e6f7081/topics" \
  -H "X-API-Key: $DTR_API_KEY"

Ответ

{
  "theme_id": "9c8b7a6d-5e4f-3021-1a2b-3c4d5e6f7081",
  "topics": [
    {
      "id": "b21e4f90-1234-4a55-9c0d-aa11bb22cc33",
      "label": "Football",
      "label_ru": "Футбол",
      "n_trends": 118,
      "n_articles": 30455
    }
  ]
}

Неизвестный theme_id вернёт пустой массив, а не 404.

#Тренды внутри темы

GET/v1/topics/{topic_id}/trendsAPI key

Параметры пути

topic_idstring (UUID)обязательный: Идентификатор темы.

Параметры запроса

sort_bystringнеобязательныйпо умолчанию last_article_at: last_article_at, first_seen_at или article_count.
sort_orderstringнеобязательныйпо умолчанию desc: asc или desc.
limitintegerнеобязательныйпо умолчанию 50: Размер страницы от 1 до 200.
offsetintegerнеобязательныйпо умолчанию 0: Число пропущенных трендов.

curl

curl -s "https://dstrends.com/api/v1/topics/b21e4f90-1234-4a55-9c0d-aa11bb22cc33/trends?sort_by=article_count&limit=2" \
  -H "X-API-Key: $DTR_API_KEY"

Ответ

{
  "topic_id": "b21e4f90-1234-4a55-9c0d-aa11bb22cc33",
  "trends": [
    {
      "id": "3f8b1c2a-9d44-4e10-8f21-77a0c6b5e123",
      "label": "Champions League final",
      "state": "hot",
      "article_count": 428
    }
  ],
  "total": 118,
  "limit": 2,
  "offset": 0
}