Raw Data API
Raw Data API предоставляет доступ к детальным данным о взаимодействиях пользователей с рекламными материалами на уровне отдельных событий. API позволяет получать необработанные данные для глубокой аналитики и построения собственных отчетов.
Endpoint
URL, по которому отправляются запросы к API
POST /v1/reports/raw_reports?project_id={project_id}
Параметры запроса
Query-параметры
__________________________________________________________________________________

`project_id` (обязательный) - ID проекта
Тело запроса
{
  "ResponseType": "JSON",
  "Fields": [
    "InteractionTime",
    "InteractionDeviceID",
    "InteractionType",
    "InteractionMediaCampaignName",
    "InteractionDomain"
  ],
  "InteractionFilter": {
    "DateFrom": "2024-01-01",
    "DateTo": "2024-01-31",
    "InteractionType": ["Impression", "Click"],
    "MediaCampaignId": [12345, 12346]
  },
  "Offset": 0,
  "Limit": 10000
}
Параметры тела запроса
__________________________________________________________________________________
InteractionFilter
__________________________________________________________________________________
Допустимые значения InteractionType
__________________________________________________________________________________
Допустимые значения DeviceType
__________________________________________________________________________________
Доступные поля
Поля взаимодействий
___________________________________________________________________________
Как работать с фильтром 'Stable':

Параметр Stable передаётся в корне JSON-запроса. Управляет фильтрацией по стабильности InteractionDeviceID:

Не передан — возвращаются все записи без фильтрации
"Stable": 1 — только стабильные DeviceID (кука не новая)
"Stable": 0 — только нестабильные DeviceID (кука новая)

Допустимые значения: 0 или 1. Любое другое значение (например 2) будет отклонено валидацией.
Пример запроса со стабильными DeviceID:
{
"ProjectId": 11111,
"ResponseType": "JSON",
"Fields": ["InteractionDeviceID", "InteractionTime", "InteractionType"],
"Stable": 1,
"InteractionFilter": {
"DateFrom": "2025-01-01",
"DateTo": "2025-01-31",
"InteractionType": ["Impression"]
}
}
URL и навигация
__________________________________________________________________________________
UTM метки
__________________________________________________________________________________
Медиа-информация
__________________________________________________________________________________
Устройство и браузер
___________________________________________________________________________
Геолокация
___________________________________________________________________________
Аналитические ID
___________________________________________________________________________
Целевые события
___________________________________________________________________________
E-commerce данные
___________________________________________________________________________
Кастомные параметры
___________________________________________________________________________
Примеры запросов
Базовая выгрузка показов и кликов
curl -X POST "https://api.targetads.io/v1/reports/raw_reports?project_id=11111" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "ResponseType": "JSON",
    "Fields": [
      "InteractionTime",
      "InteractionDeviceID",
      "InteractionType",
      "InteractionMediaCampaignName",
      "InteractionDomain"
    ],
    "InteractionFilter": {
      "DateFrom": "2024-01-01",
      "DateTo": "2024-01-31",
      "InteractionType": ["Impression", "Click"]
    },
    "Limit": 10000
  }'
Детальный анализ с геолокацией
curl -X POST "https://api.targetads.io/v1/reports/raw_reports?project_id=11111" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "ResponseType": "JSON",
    "Fields": [
      "InteractionTime",
      "InteractionDeviceID",
      "InteractionType",
      "InteractionMediaCampaignName",
      "InteractionCountry",
      "InteractionCity",
      "InteractionDeviceType",
      "InteractionBrowserName"
    ],
    "InteractionFilter": {
      "DateFrom": "2024-01-01",
      "DateTo": "2024-01-31",
      "InteractionType": ["Impression"],
      "MediaCampaignId": [12345, 12346],
      "DeviceType": ["mobile", "desktop"]
    },
    "Limit": 50000
  }'
E-commerce события (покупки)
curl -X POST "https://api.targetads.io/v1/reports/raw_reports?project_id=11111" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "ResponseType": "JSON",
    "Fields": [
      "InteractionTime",
      "InteractionDeviceID",
      "InteractionEcomId",
      "InteractionEcomAmount",
      "InteractionEcomItemsName",
      "InteractionEcomItemsPrice"
    ],
    "InteractionFilter": {
      "DateFrom": "2024-01-01",
      "DateTo": "2024-01-31",
      "InteractionType": ["Purchase"]
    }
  }'
Формат ответа
Успешный ответ
{
  "data": [
    {
      "InteractionTime": "2024-01-15 14:23:45",
      "InteractionDeviceID": "abc123def456",
      "InteractionType": "Impression",
      "InteractionMediaCampaignName": "Campaign Name",
      "InteractionDomain": "example.com"
    }
  ],
  "count": 1
}
Ошибка валидации
{
  "ErrorCode": 400,
  "ErrorMessage": "validate error",
  "Errors": [
    {
      "Error": true,
      "FailedField": "DateFrom",
      "Tag": "required",
      "Value": null
    }
  ]
}

Лимиты и ограничения


API имеет технические ограничения, которые следует

учитывать при построении интеграции:


Максимум записей за запрос: 10,000,000
Минимум полей: 3
Максимум кампаний в фильтре: 20
Максимум плейсментов в фильтре: 20
Максимум значений в остальных фильтрах: 5
Rate limit: 40 запросов в минуту

Таймаут: 300 секунд

Коды ошибок
Пример выгрузки