Работа с объявлениями

Обновления API для работы с объявлениями (02.06.2025)

В эндпоинты API Список объявлений, Создание объявления и Получение деталей объявления внесены следующие изменения:

Новый параметр target_bots:
Добавлен параметр target_bots для настройки таргетинга. Подробности смотрите в описании параметров body методов, а также в примерах запросов и ответов.

Добавлен метод валидации ботов (/api/advertisement/bots/validate?validate?bots=bot_1&bots=bot_2&bots=bot_3&account_id={account_id}):

json

{
	"bots": [
		{
			"id": 123456789,
			"title": "Bot name 1",
			"url": "t.me/bot_1",
			"photo_url": "https://cdn4.telesco.pe/file/path_to_photo_url_for_bot_1.jpg"
		},
		{
			"id": 123456780,
			"title": "Bot name 2",
			"url": "t.me/bot_2",
			"photo_url": "https://cdn4.telesco.pe/file/path_to_photo_url_for_bot_2.jpg"
		}
	],
	"errors": [
		{
			"code": "advertisement__target_bot_daily_users_limit_error",
			"detail": "Advertisement: Target bot must have 1000+ daily users",
			"url": "bot_3"
		}
	]
}

Новый параметр tg_event_id:
Добавлен новый параметр tg_event_id для настройки Pixel Tag. Подробности смотрите в описании параметров body методов создания и редактирования объявлений.

Список объявлений

WARNING

Обновление от 04.09.2025: Введено ограничение на параметр limit - максимум 500 записей в ответе.

GET v2/advertisement/?show_deleted=false&period=today&offset=0&limit=50&advertisement_titles=&campaign_names=

Пример использования

http

https://client.adstat.pro/api/v2/advertisement/?period=today

Описание query

Параметр	Тип	Описание
`period`	Строка	Ограничение выдачи по времени создания: `today`, `all`, `yesterday`, `starts_month`.
`offset`	Число	Смещение для пагинации (по умолчанию: 0).
`limit`	Число	Количество записей в ответе (максимум: 500, по умолчанию: 50). Ранее лимит не был ограничен.

Пример ответа

json

{
	"data": [
		{
			"account_name": "SOME_test",
			"action_type": null,
			"ad_text": "example text",
			"ad_type": "target_bots",
			"advertisement_title": "example title",
			"balance": 0.0,
			"campaign_id": 12345,
			"campaign_name": "Default",
			"clicks": 0,
			"cpc": 0,
			"cpm": 3.0,
			"cps": 0,
			"created_dt": "09.01.1998 09:04:26",
			"ctr": 0,
			"cvr": 0,
			"goals": 0,
			"id": 1364756,
			"impressions": 0,
			"kktu_codes": [],
			"object": "t.me/example",
			"opened": null,
			"spent": 0,
			"status": "stopped",
			"status_updated_dt": "1998-01-09T09:29:27.311931+00:00",
			"target_topics": []
		}
	]
}

Описание параметров ответа

Поле	Тип	Описание
`account_name`	Строка	Название аккаунта.
`action_type`	Строка/null	Тип целевого действия.
`ad_text`	Строка	Текст креатива.
`ad_type`	Строка	Тип объявления (`target_channels`, `target_users`, `target_search`, `target_bots`).
`advertisement_title`	Строка	Название объявления.
`balance`	Число	Баланс объявления.
`campaign_id`	Число	ID кампании.
`campaign_name`	Строка	Название кампании.
`clicks`	Число	Количество кликов.
`cpc`	Число	Стоимость за клик.
`cpm`	Число	Стоимость тысячи показов.
`cps`	Число	Стоимость за цель.
`created_dt`	Строка	Дата и время создания.
`ctr`	Число	Коэффициент кликабельности.
`cvr`	Число	Коэффициент конверсии.
`goals`	Число	Количество достигнутых целей.
`id`	Число	Уникальный ID объявления.
`impressions`	Число	Количество показов.
`kktu_codes`	Массив строк	Коды ККТУ.
`object`	Строка	Объект рекламирования.
`opened`	Число/null	Открытия видео.
`spent`	Число	Потраченная сумма.
`status`	Строка	Статус объявления.
`status_updated_dt`	Строка	Дата и время обновления статуса.
`target_topics`	Массив строк	Список топиков таргетинга.

Создание объявления

POST /api/advertisement/telegram/

Пример использования

http

https://client.adstat.pro/api/advertisement/telegram/

Описание body

Поле	Тип	Описание
`campaign_id`	Число	ID кампании.
`title`	Строка	Название объявления.
`text`	Строка	Текст объявления.
`promote_url`	Строка	URL объекта рекламирования.
`cpm`	Число	Стоимость за 1000 показов.
`budget`	Число	Рекламный бюджет.
`langs`	Массив строк	Языки таргетинга.
`topics`	Массив чисел	Тематики таргетинга.
`topics_verbose`	Массив строк	Идентификаторы тематик.
`channels`	Массив чисел	Каналы таргетинга.
`channels_verbose`	Массив строк	Идентификаторы каналов.
`exclude_topics`	Массив чисел	Исключаемые тематики.
`exclude_topics_verbose`	Массив строк	Идентификаторы исключаемых тематик.
`exclude_channels`	Массив чисел	Исключаемые каналы.
`exclude_channels_verbose`	Массив строк	Идентификаторы исключаемых каналов.
`media_token`	Строка	Токен медиафайла.
`other_info`	Строка	ERID-токен (для ручной маркировки).
`split_by`	Массив строк	Параметры разбивки таргетинга.
`ad_source`	Строка	Источник создания (`web_api`).
`ad_type`	Строка	Тип таргетинга (`target_channels`, `target_users`, `target_bots`).
`countries`	Массив строк	Страны таргетинга.
`locations`	Массив строк	Города таргетинга.
`locations_verbose`	Массив строк	Идентификаторы городов.
`audiences`	Массив чисел	Аудитории таргетинга.
`exclude_audiences`	Массив чисел	Исключаемые аудитории.
`website_name`	Строка	Название вебсайта (для внешних ссылок).
`views_per_user`	Число	Лимит просмотров на пользователя.
`show_picture`	Логическое	Показывать аватар.
`promote_url_picture_id`	Строка	ID изображения объекта.
`exclude_politic`	Логическое	Исключить политический контент.
`all_topics_interested_users`	Логическое	Таргетинг на пользователей с интересами во всех тематиках.
`device`	Строка	Устройство таргетинга (`all`).
`target_user_channels`	Массив строк	Каналы таргетинга пользователей.
`target_user_channels_verbose`	Массив строк	Идентификаторы каналов пользователей.
`exclude_target_user_channels`	Массив строк	Исключаемые каналы пользователей.
`exclude_target_user_channels_verbose`	Массив строк	Идентификаторы исключаемых каналов.
`button_type`	Строка	Тип кнопки (`open_website`).
`daily_budget`	Число	Дневной лимит бюджета.
`after_moderation_status`	Строка	Статус после модерации.
`start_date`	Строка (ISO 8601)	Дата запуска.
`end_date`	Строка (ISO 8601)	Дата остановки.
`schedule`	Объект	Расписание показа.
`use_selected_timezone`	Логическое	Использовать часовой пояс.
`schedule_timezone`	Число	Часовой пояс расписания.
`promote_url_type`	Строка	Тип URL (`website`, `channel`).
`currency_code`	Строка	Код валюты (`EUR`).
`use_account_currency`	Логическое	Использовать валюту аккаунта.
`only_crypto`	Логическое	Показывать только в криптоканалах.
`exclude_crypto`	Логическое	Исключить криптоканалы.
`kktu_ids`	Массив строк	Идентификаторы ККТУ.
`target_search`	Массив строк/null	Целевые запросы для поиска.
`target_bots`	Массив объектов/null	Боты для таргетинга.
`tg_event_id`	Строка/null	Идентификатор Pixel Tag события

Пример body

json

{
	"campaign_id": 4567123,
	"title": "123testBody_title",
	"text": "123testBody",
	"promote_url": "t.me/somechannel",
	"cpm": 2,
	"budget": 0.01,
	"only_crypto": false,
	"exclude_crypto": false,
	"media_token": "zHN9jkeds9KpcX34XoaslFXnKUqzyr3K5tBx0xAcr2_MGIisHaXA3BLnfB1yOcFudOa8qC",
	"audiences": [],
	"exclude_audiences": [],
	"langs": [],
	"topics": [1, 2],
	"topics_verbose": [],
	"channels": [],
	"channels_verbose": [],
	"exclude_topics": [],
	"exclude_topics_verbose": [],
	"exclude_channels": [],
	"exclude_channels_verbose": [],
	"split_by": [],
	"other_info": null,
	"ad_source": "web_api",
	"ad_type": "target_bots",
	"countries": [],
	"locations": [],
	"locations_verbose": [],
	"website_name": "",
	"views_per_user": 1,
	"show_picture": false,
	"promote_url_picture_id": null,
	"all_topics_interested_users": false,
	"device": "all",
	"target_user_channels": [],
	"target_user_channels_verbose": [],
	"exclude_target_user_channels": [],
	"exclude_target_user_channels_verbose": [],
	"button_type": null,
	"daily_budget": 0,
	"after_moderation_status": "on hold",
	"start_date": null,
	"end_date": null,
	"schedule": {
		"mon": [
			0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20,
			21, 22, 23
		],
		"tue": [
			0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20,
			21, 22, 23
		],
		"wed": [
			0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20,
			21, 22, 23
		],
		"thu": [
			0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20,
			21, 22, 23
		],
		"fri": [
			0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20,
			21, 22, 23
		],
		"sat": [
			0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20,
			21, 22, 23
		],
		"sun": [
			0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20,
			21, 22, 23
		]
	},
	"use_selected_timezone": true,
	"schedule_timezone": 10800,
	"promote_url_type": "channel",
	"currency_code": "EUR",
	"use_account_currency": false,
	"kktu_ids": ["some_uid_kktu"],
	"target_search": null,
	"target_bots": [
		{
			"id": 123456789,
			"url": "t.me/bot_1"
		},
		{
			"id": 123456780,
			"url": "t.me/bot_2"
		}
	],
	"tg_event_id": "JuKiaLISFD"
}

Получение деталей объявления

GET /api/advertisement/telegram/{ad_id}

Пример использования

http

https://client.adstat.pro/api/advertisement/telegram/{ad_id}

Описание query

Параметр	Тип	Описание
`ad_id`	Число	Идентификатор объявления

Пример ответа

json

{
	"ad_id": 0,
	"telegram_id": 999999999,
	"account_id": "ACCTEST_1111",
	"account_name": "TEST",
	"campaign_id": 56521378,
	"campaign_name": "Campaign test",
	"title": "Test promote title",
	"text": "Test promote text",
	"promote_url": "https://cryptosite.ru/",
	"promote_url_title": "Crypto Channel",
	"promote_url_photo": "/file/test_token.jpg",
	"media": {
		"token": "test_token",
		"url": "https://cdn4.telesco.pe/file/test_token.jpg",
		"type": "image"
	},
	"cpm": 1.5,
	"budget": 10.0,
	"langs": [],
	"topics": [],
	"channels": [],
	"exclude_topics": [],
	"exclude_channels": [],
	"other_info": "erid: test token",
	"decline_reason": [],
	"status": "active",
	"status_updated_dt": "2024-12-04T07:24:45.344358+00:00",
	"cannot_edit_fields": [],
	"ad_type": "target_bots",
	"countries": [],
	"user_locations": [],
	"audiences": [],
	"exclude_audiences": [],
	"is_audiences": false,
	"is_exclude_audiences": false,
	"website_name": "Crypto Site",
	"is_website": true,
	"views_per_user": 1,
	"show_picture": false,
	"exclude_politic": null,
	"promote_url_picture_id": "https://ads.telegram.org/file/test..asd",
	"all_topics_interested_users": null,
	"device": null,
	"target_user_channels": [],
	"exclude_target_user_channels": [],
	"button_type": "learn_more",
	"daily_budget": 2.0,
	"after_moderation_status": "active",
	"start_date": null,
	"end_date": null,
	"schedule": {
		"mon": [
			0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20,
			21, 22, 23
		],
		"tue": [
			0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20,
			21, 22, 23
		],
		"wed": [
			0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20,
			21, 22, 23
		],
		"thu": [
			0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20,
			21, 22, 23
		],
		"fri": [
			0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20,
			21, 22, 23
		],
		"sat": [
			0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20,
			21, 22, 23
		],
		"sun": [
			0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20,
			21, 22, 23
		]
	},
	"use_selected_timezone": true,
	"schedule_timezone": 10800,
	"website_photo_url": "test",
	"tg_account_type": 1,
	"currency": "EUR",
	"only_crypto": false,
	"exclude_crypto": false,
	"kktu_ids": ["some_uid_kktu"],
	"target_search": [],
	"target_bots": [
		{
			"url": "t.me/bot_1",
			"title": "Bot name 1",
			"photo_url": "https://cdn4.telesco.pe/file/path_to_photo_url_for_bot_1.jpg"
		},
		{
			"url": "t.me/bot_2",
			"title": "Bot name 2",
			"photo_url": "https://cdn4.telesco.pe/file/path_to_photo_url_for_bot_2.jpg"
		}
	],
	"event": { "tg_id": "KuliaGnSD", "name": "test1" }
}

Описание параметров ответа

Параметр	Тип	Описание
`ad_id`	Число	Уникальный ID объявления.
`telegram_id`	Число	ID объявления в Telegram.
`account_id`	Строка	ID аккаунта.
`account_name`	Строка	Название аккаунта.
`campaign_id`	Число	ID кампании.
`campaign_name`	Строка	Название кампании.
`title`	Строка	Название объявления.
`text`	Строка	Текст объявления.
`promote_url`	Строка	URL объекта рекламирования.
`promote_url_title`	Строка	Название рекламируемого объекта.
`promote_url_photo`	Строка	Путь к изображению объекта.
`media`	Объект	Данные медиа (`token`, `url`, `type`).
`cpm`	Число	Стоимость за 1000 показов.
`budget`	Число	Общий бюджет.
`langs`	Массив строк	Языки таргетинга.
`topics`	Массив строк	Тематики таргетинга.
`channels`	Массив строк	Каналы таргетинга.
`exclude_topics`	Массив строк	Исключаемые тематики.
`exclude_channels`	Массив строк	Исключаемые каналы.
`other_info`	Строка	Дополнительная информация (ERID).
`decline_reason`	Массив объектов	Причины отклонения.
`status`	Строка	Статус объявления.
`status_updated_dt`	Строка	Дата обновления статуса.
`cannot_edit_fields`	Массив строк	Нередактируемые поля.
`ad_type`	Строка	Тип таргетинга.
`countries`	Массив строк	Страны таргетинга.
`user_locations`	Массив строк	Города таргетинга.
`audiences`	Массив чисел	Аудитории таргетинга.
`exclude_audiences`	Массив чисел	Исключаемые аудитории.
`is_audiences`	Логическое	Используется аудитория.
`is_exclude_audiences`	Логическое	Используются исключаемые аудитории.
`website_name`	Строка	Название сайта.
`is_website`	Логическое	Является ли объект вебсайтом.
`views_per_user`	Число	Лимит просмотров на пользователя.
`show_picture`	Логическое	Показывать аватар.
`exclude_politic`	Логическое	Исключить политический контент.
`promote_url_picture_id`	Строка	ID изображения объекта.
`all_topics_interested_users`	Логическое	Таргетинг на пользователей с интересами во всех тематиках.
`device`	Строка	Устройство таргетинга.
`target_user_channels`	Массив строк	Каналы таргетинга пользователей.
`exclude_target_user_channels`	Массив строк	Исключаемые каналы пользователей.
`button_type`	Строка	Тип кнопки.
`daily_budget`	Число	Дневной лимит бюджета.
`after_moderation_status`	Строка	Статус после модерации.
`start_date`	Строка (ISO 8601)	Дата начала.
`end_date`	Строка (ISO 8601)	Дата окончания.
`schedule`	Объект	Расписание показа.
`use_selected_timezone`	Логическое	Использовать часовой пояс.
`schedule_timezone`	Число	Часовой пояс расписания.
`website_photo_url`	Строка	URL изображения для вебсайта.
`tg_account_type`	Число	Тип аккаунта Telegram.
`currency`	Строка	Код валюты.
`only_crypto`	Логическое	Показывать только в криптоканалах.
`exclude_crypto`	Логическое	Исключить криптоканалы.
`kktu_ids`	Массив строк	Идентификаторы ККТУ.
`target_search`	Массив строк/null	Целевые запросы для поиска.
`target_bots`	Массив объектов/null	Боты для таргетинга.
`event.tg_event_id`	Строка/null	Идентификатор Pixel Tag события
`event.name`	Строка/null	Наименование Pixel Tag события

Редактирование объявления

PUT /api/advertisement/telegram/{ad_id}

Пример использования

http

https://client.adstat.pro/api/advertisement/telegram/{ad_id}

Описание query

Параметр	Тип	Описание
`ad_id`	Число	Идентификатор объявления

Описание body

json

{
	"title": "123",
	"text": "test",
	"promote_url": "https://test.ru",
	"cpm": 2,
	"other_info": "erid: test",
	"media_token": null,
	"website_name": "Яндекс",
	"views_per_user": 1,
	"show_picture": false,
	"promote_url_picture_id": "test_token",
	"button_type": "open_website",
	"daily_budget": 0,
	"after_moderation_status": "active",
	"start_date": null,
	"end_date": null,
	"schedule": null,
	"use_selected_timezone": false,
	"schedule_timezone": null,
	"kktu_ids": ["some_uid_kktu"]
}

Описание параметров body

Параметр	Тип	Описание
`title`	Строка	Название объявления.
`text`	Строка	Текст объявления.
`promote_url`	Строка	URL объекта рекламирования.
`cpm`	Число	Стоимость за 1000 показов.
`other_info`	Строка	ERID-токен (для ручной маркировки).
`media_token`	Строка/null	Токен медиафайла.
`website_name`	Строка	Название сайта (для внешних ссылок).
`views_per_user`	Число	Лимит просмотров на пользователя.
`show_picture`	Логическое	Показывать аватар.
`promote_url_picture_id`	Строка	ID изображения объекта.
`button_type`	Строка	Тип кнопки (`open_website`).
`daily_budget`	Число	Дневной лимит бюджета.
`after_moderation_status`	Строка	Статус после модерации.
`start_date`	Строка (ISO 8601)	Дата начала.
`end_date`	Строка (ISO 8601)	Дата окончания.
`schedule`	Объект/null	Расписание показа.
`use_selected_timezone`	Логическое	Использовать часовой пояс.
`schedule_timezone`	Число/null	Часовой пояс расписания.
`kktu_ids`	Массив строк	Идентификаторы ККТУ.

Загрузка медиа

POST api/v1/advertising/telegram/upload_media?account_id={account_id}

Пример использования

http

https://clientapi.adstat.pro/api/v1/advertising/telegram/upload_media?account_id=ACC0000222

Описание query-параметров

Параметр	Тип	Описание
`account_id`	Строка	Идентификатор аккаунта (`ACC0000222`).

Описание body

В теле запроса передается параметр media с бинарным файлом.

Пример на JavaScript:

javascript

const mediaFormData = new FormData();
mediaFormData.append("media", file);

Описание ответа

json

{
	"media_token": "test_token",
	"content_type": "image/jpeg",
	"error": null
}

Параметр	Тип	Описание
`media_token`	Строка	Уникальный токен медиафайла.
`content_type`	Строка	MIME-тип файла (`image/jpeg`, `video/mp4`).
`error`	Строка/null	Описание ошибки или `null` при успехе.

ОРД ККТУ

Важная информация

Для кабинетов с автомаркировкой выбор ККТУ обязателен. Без указания идентификатора ККТУ объявление создать невозможно.

Получение списка доступных ККТУ

GET /api/kktu

Пример запроса

http

https://clientapi.adstat.pro/api/kktu/

Пример ответа

json

{
	"items": [
		{
			"id": "0193d46f-1888-7553-8d09-53116794ddb3",
			"tree_id": 1000000,
			"code": "1",
			"name": "АЛКОГОЛЬНЫЕ НАПИТКИ, ТАБАЧНЫЕ ИЗДЕЛИЯ",
			"children": [
				{
					"id": "0193d46f-1889-7cb1-b1a0-97f889d945ad",
					"tree_id": 1001000,
					"code": "1.1",
					"name": "АЛКОГОЛЬНЫЕ НАПИТКИ",
					"children": [
						{
							"id": "0193d46f-1889-7cb1-b1a0-9800191b62e9",
							"tree_id": 1001001,
							"code": "1.1.1",
							"name": "ВИНО",
							"children": []
						},
						{
							"id": "0193d46f-1889-7cb1-b1a0-98184fd25317",
							"tree_id": 1001002,
							"code": "1.1.2",
							"name": "КРЕПКИЕ АЛКОГОЛЬНЫЕ НАПИТКИ",
							"children": []
						},
						{
							"id": "0193d46f-1889-7cb1-b1a0-982f7acfc72c",
							"tree_id": 1001003,
							"code": "1.1.3",
							"name": "АЛКОГОЛЬНЫЕ НАПИТКИ (РАЗНОЕ)",
							"children": []
						},
						{
							"id": "0193d46f-1889-7cb1-b1a0-9830cb4b6bab",
							"tree_id": 1001004,
							"code": "1.1.4",
							"name": "СЛАБОАЛКОГОЛЬНЫЕ НАПИТКИ",
							"children": []
						}
					]
				},
				{
					"id": "0193d46f-1889-7cb1-b1a0-9842865b2e1b",
					"tree_id": 1002000,
					"code": "1.2",
					"name": "ТАБАЧНЫЕ ИЗДЕЛИЯ",
					"children": [
						{
							"id": "0193d46f-1889-7cb1-b1a0-985cd2f1e210",
							"tree_id": 1002001,
							"code": "1.2.1",
							"name": "ТАБАЧНЫЕ ИЗДЕЛИЯ",
							"children": []
						}
					]
				}
			]
		}
	]
}

Особенности заполнения `kktu_ids`

Поле kktu_ids заполняется id третьего уровня вложенности.
Нельзя использовать id первого или второго уровня.
Выбирается только одно значение для создания или редактирования объявления.

Pixel Tag

Получение списка доступных Pixel Tag событий

GET /api/pixel_events/?account_id={account_id}

Пример запроса

http

https://clientapi.adstat.pro/api/pixel_events/?account_id={account_id}

Пример ответа

json

{
	"items": [
		{
			"id": "test_event_some_property",
			"pixel_id": "test_event_some_property",
			"tg_event_id": "test_event_some_property",
			"title": "test_event_some_property",
			"type": "custom",
			"status": "inactive",
			"ads_count": 1,
			"created_at": "2025-06-04T14:36:45+00:00",
			"last_triggered_at": null,
			"code_snippet": "<script>\ntgp(\"event\",\"test_event_some_property\");\n</script>"
		}
	]
}

Особенности заполнения `tg_event_id`

Поле tg_event_id заполняется tg_event_id из списка доступных Pixel Tag событий.
Для каждого кабинета свой набор списка Pixel Tag событий.
Выбирается только одно значение для создания или редактирования объявления.

Вот откорректированное и структурированное описание метода работы с аудиториями по номерам телефонов. Оформление выдержано в стиле API-документации:

Работа с аудиториями по номерам телефонов

Важно: Данный функционал доступен только для рекламных кабинетов с геопозицией Узбекистан.

Получение списка доступных аудиторий

Метод: GET

URL: /api/advertisement/telegram/{account_id}/audiences/

Пример запроса:

GET https://clientapi.adstat.pro/api/advertisement/telegram/{account_id}/audiences/

Пример ответа:

json

[
	{
		"telegram_id": 1,
		"title": "phone_numbers_1"
	},
	{
		"telegram_id": 2,
		"title": "phone_numbers_2"
	}
]

Создание новой аудитории

Метод: POST

URL: /api/advertisement/telegram/{account_id}/audiences

Создает новый список аудитории на основе загружаемого файла с номерами телефонов.

Пример запроса:

POST https://clientapi.adstat.pro/api/advertisement/telegram/ACC010101010101/audiences

Параметры запроса (Form Data):

Поле	Тип	Описание	Обязательное
`title`	string	Название создаваемой аудитории	Да
`audience`	файл	Файл в бинарном формате, содержащий номера телефонов	Да

Формат файла:
Вы можете загрузить файл CVS или txt размером не более 10 мб, который содержит список телефонных номеров или его хэши sha256, разделенные запятыми или переносами строк. Правила для формирования базы номеров:
• Формат номера телефона – только цифры,без плюсов и других знаков.
• Номер должен быть в международном формате, то есть начинаться с 998 для Узбекистана.
• В файле должно быть от 1000 телефонных номеров и более.

Пример тела запроса:

(Тело отправляется как multipart/form-data, поэтому на уровне JSON не сериализуется. Ниже — условное представление):

http

Content-Type: multipart/form-data

title=12345
audience=<файл с номерами>

Работа с объявлениями ​

Обновления API для работы с объявлениями (02.06.2025) ​

Список объявлений ​

Пример использования ​

Описание query ​

Пример ответа ​

Описание параметров ответа ​

Создание объявления ​

Пример использования ​

Описание body ​

Пример body ​

Получение деталей объявления ​

Пример использования ​

Описание query ​

Пример ответа ​

Описание параметров ответа ​

Редактирование объявления ​

Пример использования ​

Описание query ​

Описание body ​

Описание параметров body ​

Загрузка медиа ​

Пример использования ​

Описание query-параметров ​

Описание body ​

Описание ответа ​

ОРД ККТУ ​

Важная информация ​

Получение списка доступных ККТУ ​

Пример запроса ​

Пример ответа ​

Особенности заполнения kktu_ids ​

Pixel Tag ​

Получение списка доступных Pixel Tag событий ​

Пример запроса ​

Пример ответа ​

Особенности заполнения tg_event_id ​

Работа с аудиториями по номерам телефонов ​

Получение списка доступных аудиторий ​

Пример запроса: ​

Пример ответа: ​

Создание новой аудитории ​

Пример запроса: ​

Параметры запроса (Form Data): ​

Пример тела запроса: ​

Работа с объявлениями

Обновления API для работы с объявлениями (02.06.2025)

Список объявлений

Пример использования

Описание query

Пример ответа

Описание параметров ответа

Создание объявления

Пример использования

Описание body

Пример body

Получение деталей объявления

Пример использования

Описание query

Пример ответа

Описание параметров ответа

Редактирование объявления

Пример использования

Описание query

Описание body

Описание параметров body

Загрузка медиа

Пример использования

Описание query-параметров

Описание body

Описание ответа

ОРД ККТУ

Важная информация

Получение списка доступных ККТУ

Пример запроса

Пример ответа

Особенности заполнения `kktu_ids`

Pixel Tag

Получение списка доступных Pixel Tag событий

Пример запроса

Пример ответа

Особенности заполнения `tg_event_id`

Работа с аудиториями по номерам телефонов

Получение списка доступных аудиторий

Пример запроса:

Пример ответа:

Создание новой аудитории

Пример запроса:

Параметры запроса (Form Data):

Пример тела запроса: