Статьи

Получите публикации, их содержимое и историю охвата

Методы Articles возвращают публикации из Google Discover, их метаданные, извлечённые сущности и историю наблюдений.

#Список публикаций

GET/v1/articlesAPI key

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

regionstringнеобязательный: Двухбуквенный код страны.
langstringнеобязательный: Код языка.
domainstringнеобязательный: Домен издания.
categorystringнеобязательный: Категория материала.
content_typestringнеобязательный: Тип контента.
searchstringнеобязательный: Поиск по заголовку и текстовым полям.
date_fromstringнеобязательный: Начало периода в ISO 8601.
date_tostringнеобязательный: Конец периода в ISO 8601.
has_entitiesbooleanнеобязательный: Оставить публикации с сущностями или без них.
has_summarybooleanнеобязательный: Оставить публикации с кратким описанием или без него.
sort_bystringнеобязательныйпо умолчанию last_seen_at: Поле сортировки.
sort_orderstringнеобязательныйпо умолчанию desc: asc или desc.
limitintegerнеобязательныйпо умолчанию 50: Размер страницы.
offsetintegerнеобязательныйпо умолчанию 0: Число пропущенных публикаций.

curl

curl "https://dstrends.com/api/v1/articles?region=US&category=Sports&has_summary=true&sort_by=first_seen_at&sort_order=desc&limit=2" \
  -H "X-API-Key: $DTR_API_KEY"

Ответ

{
  "articles": [
    {
      "id": "b3f1c2a0-7d4e-4a11-9f0c-1e2d3a4b5c6d",
      "url": "https://example-sports.com/finals-recap",
      "title": "Finals recap: an instant classic",
      "domain": "example-sports.com",
      "region": "US",
      "lang": "en",
      "category": "Sports",
      "first_seen_at": "2026-06-28T22:10:00Z",
      "last_seen_at": "2026-06-29T05:20:00Z"
    }
  ],
  "total": 1,
  "limit": 2,
  "offset": 0
}

#Одна публикация

GET/v1/articles/{article_id}API key

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

article_idstringобязательный: Идентификатор публикации.
include_markdownbooleanнеобязательныйпо умолчанию false: Добавить содержимое в Markdown, если оно сохранено.
include_entitiesbooleanнеобязательныйпо умолчанию true: Добавить извлечённые сущности.
include_imagesbooleanнеобязательныйпо умолчанию true: Добавить изображения.

curl

curl "https://dstrends.com/api/v1/articles/b3f1c2a0-7d4e-4a11-9f0c-1e2d3a4b5c6d?include_markdown=true&include_entities=true" \
  -H "X-API-Key: $DTR_API_KEY"

Ответ

{
  "id": "b3f1c2a0-7d4e-4a11-9f0c-1e2d3a4b5c6d",
  "url": "https://example-sports.com/finals-recap",
  "title": "Finals recap: an instant classic",
  "domain": "example-sports.com",
  "summary": "A last-second shot decided the championship.",
  "markdown": "# Finals recap",
  "entities": [
    {
      "name": "Example City Ballers",
      "entity_types": ["Organization", "SportsTeam"],
      "unified_score": 0.87
    }
  ],
  "images": []
}

Необязательные блоки могут отсутствовать или быть равны null. Проверяйте наличие поля перед использованием.

#История наблюдений

GET/v1/articles/{article_id}/observationsAPI key

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

article_idstringобязательный: Идентификатор публикации.
date_fromstringнеобязательный: Начало периода в ISO 8601.
date_tostringнеобязательный: Конец периода в ISO 8601.
limitintegerнеобязательныйпо умолчанию 100: Размер страницы.
offsetintegerнеобязательныйпо умолчанию 0: Число пропущенных наблюдений.

curl

curl "https://dstrends.com/api/v1/articles/b3f1c2a0-7d4e-4a11-9f0c-1e2d3a4b5c6d/observations?limit=3" \
  -H "X-API-Key: $DTR_API_KEY"

Ответ

{
  "article_id": "b3f1c2a0-7d4e-4a11-9f0c-1e2d3a4b5c6d",
  "observations": [
    {
      "observed_at": "2026-06-29T01:00:00Z",
      "estimated_impressions": 18400,
      "position": 4
    }
  ],
  "total": 1
}