Adstat Developers Portal

Appearance

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

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

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

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

  2. Добавлен метод валидации ботов (/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"
    }
  ]
}

  3. Новый параметр tg_event_id:

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

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

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.

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

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): ​

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

Формат файла:

Вы можете загрузить файл CVS или txt размером не более 10 мб, который содержит список телефонных номеров или его хэши sha256, разделенные запятыми или переносами строк. Правила для формирования базы номеров:

• Формат номера телефона – только цифры,без плюсов и других знаков.

• Номер должен быть в международном формате, то есть начинаться с 998 для Узбекистана.

• В файле должно быть от 1000 телефонных номеров и более.

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

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

http
Content-Type: multipart/form-data

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

© 2024 Adstat.pro