Geo

Получите список стран, городов и языков

Методы Geo возвращают страны, города и языки, доступные в Discover Trends. Для запросов нужен API-ключ. Ограничения ключа по странам применяются автоматически.

#Список стран

GET/v1/geo/regionsAPI key

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

active_onlybooleanнеобязательныйпо умолчанию false: Оставить страны с активным профилем Discover.
with_statsbooleanнеобязательныйпо умолчанию false: Добавить население и оценку аудитории, если данные доступны.
entitystringнеобязательныйпо умолчанию null: Идентификатор Knowledge Graph или имя сущности для проверки активности по странам.
windowstringнеобязательныйпо умолчанию 24h: Период для сущности: 1h, 24h, 7d или 30d.
entity_onlybooleanнеобязательныйпо умолчанию false: При заданной entity оставить только страны, где сущность встречалась.

curl

curl "https://dstrends.com/api/v1/geo/regions?active_only=true&with_stats=true" \
  -H "X-API-Key: $DTR_API_KEY"

Ответ

{
  "regions": [
    {
      "alpha_2": "US",
      "name": "United States of America",
      "languages": ["en"],
      "cities_count": 12,
      "profiles_count": 3,
      "is_active": true,
      "stats": {
        "population": 331000000,
        "internet_population": 300000000
      }
    }
  ],
  "total": 1
}

Поле stats появляется только при with_stats=true. Поля активности сущности появляются только при переданной entity. Пагинации нет.

#Одна страна

GET/v1/geo/regions/{alpha_2}API key

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

alpha_2stringобязательный: Двухбуквенный код страны. Регистр не важен.

curl

curl "https://dstrends.com/api/v1/geo/regions/US" \
  -H "X-API-Key: $DTR_API_KEY"

Ответ

{
  "alpha_2": "US",
  "alpha_3": "USA",
  "name": "United States of America",
  "languages": ["en"],
  "cities": [
    { "id": 101, "name": "New York", "is_active": true }
  ],
  "first_data_at": "2025-01-14T08:22:10+00:00"
}

Запрос страны, недоступной ключу, вернёт 403 Forbidden.

#Города страны

GET/v1/geo/regions/{alpha_2}/citiesAPI key

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

alpha_2stringобязательный: Двухбуквенный код страны.

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

active_onlybooleanнеобязательныйпо умолчанию false: Оставить только активные города.

curl

curl "https://dstrends.com/api/v1/geo/regions/US/cities?active_only=true" \
  -H "X-API-Key: $DTR_API_KEY"

Ответ

{
  "region": "US",
  "cities": [
    { "id": 101, "name": "New York", "is_active": true }
  ]
}

#Список языков

GET/v1/geo/languagesAPI key

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

with_article_countsbooleanнеобязательныйпо умолчанию false: Добавить поле article_count. Такой запрос выполняется дольше.

curl

curl "https://dstrends.com/api/v1/geo/languages?with_article_counts=true" \
  -H "X-API-Key: $DTR_API_KEY"

Ответ

{
  "languages": [
    {
      "code": "en",
      "name": "English",
      "regions": ["AU", "GB", "US"],
      "article_count": 1204331
    }
  ]
}

article_count возвращается только при with_article_counts=true. Пагинации нет.