Аналитика

Сравните рынки по изданиям, категориям и форматам

Методы Analytics собирают показатели по выбранному рынку и периоду. Используйте их для отчётов по публикациям, изданиям, категориям и форматам.

#Общий обзор

GET/v1/analytics/overviewAPI key

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

regionstringобязательный: Код страны.
periodstringнеобязательныйпо умолчанию 24h: Период отчёта.
langstringнеобязательный: Код языка.
city_idstringнеобязательный: Идентификатор города.

curl

curl "https://dstrends.com/api/v1/analytics/overview?region=US&period=24h" \
  -H "X-API-Key: $DTR_API_KEY"

Ответ

{
  "region": "US",
  "period": "24h",
  "articles_count": 12430,
  "domains_count": 812,
  "observations_count": 45320,
  "estimated_impressions": 184020100
}

#Издания

GET/v1/analytics/domainsAPI key

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

regionstringобязательный: Код страны.
periodstringнеобязательныйпо умолчанию 24h: Период отчёта.
langstringнеобязательный: Код языка.
sort_bystringнеобязательныйпо умолчанию articles_count: Поле сортировки, например articles_count или observations_count.
limitintegerнеобязательныйпо умолчанию 20: Размер страницы.
offsetintegerнеобязательныйпо умолчанию 0: Число пропущенных изданий.

curl

curl "https://dstrends.com/api/v1/analytics/domains?region=US&period=7d&sort_by=observations_count&limit=3" \
  -H "X-API-Key: $DTR_API_KEY"

Ответ

{
  "domains": [
    {
      "domain": "example.com",
      "articles_count": 412,
      "observations_count": 1520,
      "estimated_impressions": 9840200
    }
  ],
  "total": 1
}

#Категории

GET/v1/analytics/categoriesAPI key

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

regionstringобязательный: Код страны.
periodstringнеобязательныйпо умолчанию 24h: Период отчёта.
langstringнеобязательный: Код языка.

curl

curl "https://dstrends.com/api/v1/analytics/categories?region=US&period=24h" \
  -H "X-API-Key: $DTR_API_KEY"

Ответ

{
  "categories": [
    {
      "category": "Sports",
      "articles_count": 1904,
      "estimated_impressions": 8231400,
      "share": 14.2
    }
  ]
}

Поле share показывает долю категории в выбранной выборке.

#Форматы контента

GET/v1/analytics/content-typesAPI key

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

regionstringобязательный: Код страны.
periodstringнеобязательныйпо умолчанию 24h: Период отчёта.
langstringнеобязательный: Код языка.

curl

curl "https://dstrends.com/api/v1/analytics/content-types?region=US&period=24h" \
  -H "X-API-Key: $DTR_API_KEY"

Ответ

{
  "content_types": [
    {
      "content_type": "T03_listicle",
      "articles_count": 1204,
      "estimated_impressions": 5402100,
      "share": 11.2
    }
  ]
}