Discover

Получайте ленту Discover, свежие URL и данные одной страницы

Лента v2 возвращает один профиль на сочетание URL, страны и языка. В профиле находятся метаданные, оценка охвата, сущности, категории, изображения и связанный тренд.

#Список ленты

GET/v2/feedAPI key

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

countrystringнеобязательный: Код страны. Недоступный ключу рынок вернёт 403.
langstringнеобязательный: Код языка.
categorystringнеобязательный: Категория Google. Несколько значений разделяются точкой с запятой.
entitystringнеобязательный: Идентификатор Knowledge Graph или имя. Несколько значений разделяются точкой с запятой.
matchstringнеобязательныйпо умолчанию any: any для совпадения хотя бы с одним фильтром или all для совпадения со всеми.
periodstringнеобязательный: 1h, 24h, 7d, 30d или custom.
date_fromstringнеобязательный: Начало произвольного периода в ISO 8601.
date_tostringнеобязательный: Конец произвольного периода в ISO 8601.
sort_bystringнеобязательныйпо умолчанию derived: impressions_1h, impressions_24h, impressions_7d, impressions_30d, first_seen, last_seen или avg_position.
sort_orderstringнеобязательныйпо умолчанию desc: asc или desc.
include_markdownboolнеобязательныйпо умолчанию false: Добавить markdown_content. Такой запрос не кэшируется.
limitintнеобязательныйпо умолчанию 50: Размер страницы от 1 до 200.
offsetintнеобязательныйпо умолчанию 0: Число пропущенных элементов.

Если sort_by не задан, выбранный period определяет окно охвата для сортировки. Без обоих параметров используется impressions_24h.

curl

curl "https://dstrends.com/api/v2/feed?country=us&lang=en&category=/Sports&period=24h&limit=2" \
  -H "X-API-Key: $DTR_API_KEY"

Ответ

{
  "items": [
    {
      "url_id": "6f1c2e0a-8d5b-4a9e-9c2f-1a2b3c4d5e6f",
      "url": "https://example.com/big-game-recap",
      "domain": "example.com",
      "country": "us",
      "language": "en",
      "title": "Big Game Recap: Late Comeback Stuns Fans",
      "first_seen": "2026-07-01T08:12:00Z",
      "last_seen": "2026-07-01T14:03:00Z",
      "impressions": {
        "last_1h": { "current": 1200, "previous": 900, "delta_pct": 33.3 },
        "last_24h": { "current": 48200, "previous": 41000, "delta_pct": 17.5 }
      },
      "enrichment": {
        "format_group": "news",
        "format_type": "recap"
      },
      "categories": [{ "name": "/Sports", "confidence": 0.92 }],
      "trend": {
        "trend_id": "b1a2c3d4-0000-1111-2222-333344445555",
        "name": "Championship Final"
      },
      "entities": [{ "kg_id": "/m/02xyz", "name": "Team A", "type": "org" }],
      "images": [],
      "markdown_content": null
    }
  ],
  "total": 137,
  "limit": 2,
  "offset": 0
}

Значения previous и delta_pct могут быть равны null. Поле markdown_content заполняется только при include_markdown=true.

#Свежие URL

GET/v2/liveAPI key

Возвращает материалы, впервые замеченные за последние несколько минут. Список всегда сортируется по first_seen, начиная с самых новых.

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

countrystringнеобязательный: Код страны.
langstringнеобязательный: Код языка.
categorystringнеобязательный: Одна или несколько категорий через точку с запятой.
entitystringнеобязательный: Одна или несколько сущностей через точку с запятой.
matchstringнеобязательныйпо умолчанию any: any или all.
since_minutesintнеобязательныйпо умолчанию 60: Период от 5 до 1440 минут.
include_markdownboolнеобязательныйпо умолчанию false: Добавить содержимое в Markdown.
limitintнеобязательныйпо умолчанию 50: Размер страницы от 1 до 200.
offsetintнеобязательныйпо умолчанию 0: Число пропущенных элементов.

curl

curl "https://dstrends.com/api/v2/live?country=us&since_minutes=120&limit=1" \
  -H "Authorization: Bearer $DTR_API_KEY"

Ответ

{
  "since": "2026-07-01T12:05:00Z",
  "items": [
    {
      "url_id": "9a8b7c6d-1234-5678-9abc-def012345678",
      "url": "https://news.example/breaking",
      "title": "Breaking news",
      "country": "us",
      "language": "en",
      "first_seen": "2026-07-01T13:58:00Z"
    }
  ],
  "total": 12,
  "limit": 1,
  "offset": 0
}

#Один URL на всех рынках

GET/v2/feed/{url_id}API key

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

url_idstringобязательный: Идентификатор URL.
include_markdownboolнеобязательныйпо умолчанию true: Добавить содержимое в Markdown. Для этого метода значение по умолчанию равно true.

curl

curl "https://dstrends.com/api/v2/feed/6f1c2e0a-8d5b-4a9e-9c2f-1a2b3c4d5e6f?include_markdown=false" \
  -H "X-API-Key: $DTR_API_KEY"

Ответ

[
  {
    "url_id": "6f1c2e0a-8d5b-4a9e-9c2f-1a2b3c4d5e6f",
    "country": "us",
    "language": "en",
    "title": "Big Game Recap: Late Comeback Stuns Fans"
  },
  {
    "url_id": "6f1c2e0a-8d5b-4a9e-9c2f-1a2b3c4d5e6f",
    "country": "gb",
    "language": "en",
    "title": "Big Game Recap: Late Comeback Stuns Fans"
  }
]