Охват URL

Посмотрите охват URL по часам и найдите самые заметные страницы

Методы URL reach показывают оценку охвата отдельных страниц. Можно получить почасовую историю одного URL или список страниц с наибольшим охватом.

#Почасовой охват

GET/v2/url-reachAPI key

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

urlstringнеобязательный: Полный адрес страницы.
url_idstringнеобязательный: Идентификатор URL в Discover Trends.
countrystringнеобязательный: Код страны.
langstringнеобязательный: Код языка.
date_fromstringнеобязательный: Начало периода в ISO 8601.
date_tostringнеобязательный: Конец периода в ISO 8601.
sortstringнеобязательныйпо умолчанию hour: hour для хронологического порядка или reach для сортировки по охвату.
limitintegerнеобязательныйпо умолчанию 100: Размер страницы.
offsetintegerнеобязательныйпо умолчанию 0: Число пропущенных строк.

curl

curl "https://dstrends.com/api/v2/url-reach?country=us&lang=en&sort=reach&date_from=2026-06-30T00:00:00Z&limit=2" \
  -H "X-API-Key: $DTR_API_KEY"

Ответ

{
  "items": [
    {
      "url_id": "b3f1c2a0-...",
      "url": "https://example.com/story",
      "hour": "2026-07-01T09:00:00Z",
      "estimated_reach": 18400,
      "country": "us",
      "lang": "en"
    }
  ],
  "total": 1,
  "limit": 2,
  "offset": 0
}

Передайте url или url_id, если нужна история одной страницы. Без них метод возвращает строки по всей доступной выборке.

#Страницы с наибольшим охватом

GET/v2/url-reach/topAPI key

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

daysintegerнеобязательныйпо умолчанию 7: Число последних дней.
countrystringнеобязательный: Код страны.
langstringнеобязательный: Код языка.
limitintegerнеобязательныйпо умолчанию 100: Число URL в ответе.

curl

curl "https://dstrends.com/api/v2/url-reach/top?days=7&country=us&lang=en&limit=2" \
  -H "X-API-Key: $DTR_API_KEY"

Ответ

{
  "days": 7,
  "items": [
    {
      "url_id": "b3f1c2a0-...",
      "url": "https://example.com/story",
      "title": "Example story",
      "domain": "example.com",
      "estimated_reach": 1840200
    }
  ]
}

Набор дополнительных полей может меняться по мере обогащения данных. Для связи записей используйте url_id и url.