API Партнёров

API	Описание
Данные для ОРД	Получите данных по всем активным подключенным офферам для передачи отчетности в ОРД в формате JSON.
Условия офферов	Получите список офферов в формате JSON или XML.
XML с заказами	Получите XML-список заказов.
Лендинги	Получите список лендингов в формате JSON или XML.
Акции	Получите список акций в формате JSON или XML.
Промокоды	Получите список купонов в формате JSON или XML.
Баннеры	Получите список баннеров в формате JSON или XML.

Ваш API-key находится в Настройках профиля → поле «Апи ключ».

При переходе по ссылке из личного кабинета все необходимые данные подставятся автоматически.

Данные для ОРД

Для получения списка данных по всем активным подключенным офферам для передачи отчетности в ОРД в формате JSON, необходимо отправить GET-запрос на адрес:

https://export.advcake.ru/offers?pass={API-key}

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

Поле	Описание
`id`	id оффера
`name`	название оффера
`website_url`	сайт оффера
`active`	статус оффера
`manager`	менеджер на стороне AdvCake, ответственный за работу оффера
`advertiser`	информация для регистрации изначального договора
`entity_name`	название рекламодателя
`entity_tin`	ИНН рекламодателя
`entity_name_agency`	название первого агентства в цепочке
`entity_tin_agency`	ИНН первого агентства в цепочке
`agreement_number`	номер изначального договора
`agreement_date`	дата изначального договора
`contract_type`	тип изначального договора, где `intermediary-contract` — посреднический договор `contract` — договор оказания услуг `additional-agreement` — дополнительное соглашение
`agent_acting_for_publisher`	агент представляет сторону рекламораспространителя
`contract_action`	описание осуществляемых посредником-представителем действий, где `other` — иное `distribution` — действия в целях распространения рекламы `conclude` — заключение договоров `commercial` — коммерческое представительство
`contract_subject`	предмет изначального договора, где `other` — иное `org-distribution` — договор на организацию распространения рекламы `mediation` — посредничество `distribution` — договор на распространение рекламы
`kktu`	код ККТУ, определяется только на стороне рекламодателя, должен содержать три числа от 1–999 с разделителем точка между ними (например, 1.1.1 или 999.999.999). Необходим для регистрации креатива в ОРД.

Условия офферов

Для получения списка офферов в формате JSON или XML, необходимо отправить GET-запрос на адрес:

https://api.advcake.ru/offers?pass={API-key}

Дополнительно могут быть указаны следующие GET-параметры:

Параметр	Описание
`website`	отобразить офферы имеющие указанный сайт;
`source_type`	отобразить офферы c указанным типом трафика;
`last_update_after`	получить список офферов обновленных после указанной даты;
`limit`	задать лимит выводимых офферов;
`offset`	отобразить офферы начиная с указанного порядкового номера;
`type`	выбрать формат ответа Json или XML. По умолчанию Json;
`with_bids=1`	добавить ставки программы в вывод;
`with_landings=0`	не выводить данные лендингов программы.

Примеры

Получить список офферов с вебсайтом google.com:

https://api.advcake.ru/offers?pass={API-key}&website=google.com

Получить список офферов с типом трафика cashback:

https://api.advcake.ru/offers?pass={API-key}&source_type=cashback

Получить список офферов обновленных после 2020-10-01:

https://api.advcake.ru/offers?pass={API-key}&last_update_after=2020-10-01

Установить лимит на количество полученных офферов равный 10:

https://api.advcake.ru/offers?pass={API-key}&limit=10

Получить офферы начиная с 5-го в списке:

https://api.advcake.ru/offers?pass={API-key}&offset=5

Получить список офферов с актуальными ставками:

https://api.advcake.ru/offers?pass={API-key}&with_bids=1

Получить список офферов без лендингов:

https://api.advcake.ru/offers?pass={API-key}&with_landings=0

Получить оффер с ID = 2:

https://api.advcake.ru/offers/2?pass={API-key}

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

Поле	Описание
`total`	число партнёрских программ, подходящих под запрос
`id`	id партнёрской программы в системе
`alias`	строковый id партнёрской программы в системе
`name`	название партнёрской программы
`description`	краткое описание партнёрской программы
`country`	страна партнёрской программы
`currency`	валюта партнёрской программы
`website_url`	сайт партнёрской программы
`thumbnail`	логотип
`category`	категория
`type`	тип (CPA/CPO/CPC)
`action_type`	тип действия (lead/ecommerce)
`cookie_lifetime`	срок жизни куки
`hold`	срок холда
`available`	доступна (да/нет)
`active`	активна (да/нет)
`geos`	ГЕО для работы с партнёрской программой
`traffic_types`	разрешенные и запрещенные типы трафика
`landings`	список лендингов партнёрской программы
`bids`	ставки `id` — id ставки в системе `value` — значение ставки `max_commission` — максимальная возможная комиссия вебмастера за заказ `type` — тип ставки (процент/фикс в рублях) `text` — текстовое описание ставки `condition` — условия: `goal` — название продукта (для фин. офферов) `traffic_type` — для указанного типа трафика `excluded_traffic_type` — исключая тип трафика `start_date` — дата начала ставки `end_date` — дата окончания ставки `category` — для указанных категорий `coupon` — с купоном (Да/Нет) `min_price` — минимально необходимая сумма заказа `min_item_price` — минимально необходимая сумма элемента корзины `customer_type` — тип клиента (Новый/Старый) `adv_sub` — ключевое слово `adv_sub2` — ключевое слово 2
`export`	XML выгрузка со статистикой.

XML с заказами

Для получения XML-списка заказов, необходимо отправить GET-запрос на адрес:

https://export.advcake.ru/partner/offer?pass={API-key}

Дополнительно могут быть указаны следующие GET-параметры:

days — отобразить заказы за заданное количество дней (не более 7), начиная от текущей даты;
date_from и date_to — отобразить заказы в промежутке указанных дат (включительно). Формат дат: YYYY-MM-DD.

Примеры

Получить список заказов за последние 7 дней:

https://export.advcake.ru/partner/offer?pass={API-key}&days=7

Получить список заказов с 1 по 7 января 2026:

https://export.advcake.ru/partner/offer?pass={API-key}&date_from=2026-01-01&date_to=2026-01-07

Лендинги

Для получения списка лендингов в формате JSON или XML, необходимо отправить GET-запрос на адрес:

https://api.advcake.ru/landings?pass={API-key}

Дополнительно могут быть указаны следующие GET-параметры:

Параметр	Описание
`offer_id`	отобразить лендинги для оффера с указанным ID;
`offer_alias`	отобразить лендинги для оффера с указанным алиасом;
`offset`	отобразить лендинги начиная с указанного порядкового номера;
`limit`	задать лимит выводимых лендингов;
`type`	выбрать формат ответа JSON или XML (по умолчанию JSON).

Примеры

Поиск лендингов для оффера c ID = 240:

https://api.advcake.ru/landings?pass={API-key}&offer_id=240

Поиск лендингов для оффера c алиасом = clarins:

https://api.advcake.ru/landings?pass={API-key}&offer_alias=clarins

Установить лимит на количество полученных лендингов равный 10:

https://api.advcake.ru/landings?pass={API-key}&limit=10

Получить лендинги начиная с 5-го в списке:

https://api.advcake.ru/landings?pass={API-key}&offset=5

Получить лендинг с ID = 1037:

https://api.advcake.ru/landings/1037?pass={API-key}

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

Поле	Описание
`total`	число лендингов, подходящих под запрос
`id`	id лендинга в системе
`name`	название лендинга
`offer_id`	оффер ID лендинга
`offer_alias`	алиас оффера лендинга
`type`	тип лендинга (mobile/desktop)
`kktu`	код ККТУ (три числа от 1–999 через точку, например 1.1.1). Необходим для регистрации креатива в ОРД
`allow_deep`	поддерживается ли DeepLink
`url`	url лендинга
`active`	активен ли лендинг
`private`	эксклюзивность лендинга
`promotion`	данные об акции, к которой привязан лендинг
`promocodes`	данные о промокодах, которые привязаны к той же акции, что и лендинг
`banners`	данные о баннерах, которые привязаны к той же акции, что и лендинг
`status`	статус лендинга.

Акции

Для получения списка акций в формате JSON или XML, необходимо отправить GET-запрос на адрес:

https://api.advcake.ru/promotions?pass={API-key}

Дополнительно могут быть указаны следующие GET-параметры:

Параметр	Описание
`offer_id`	отобразить акции для оффера с указанным ID;
`offset`	отобразить акции начиная с указанного порядкового номера;
`limit`	задать лимит выводимых акций;
`type`	выбрать формат ответа JSON или XML (по умолчанию JSON).

Примеры

Поиск акций для оффера c ID = 240:

https://api.advcake.ru/promotions?pass={API-key}&offer_id=240

Установить лимит на количество полученных акций равный 10:

https://api.advcake.ru/promotions?pass={API-key}&limit=10

Получить акции начиная с 5-го в списке:

https://api.advcake.ru/promotions?pass={API-key}&offset=5

Получить акцию с ID = 1900:

https://api.advcake.ru/promotions/1900?pass={API-key}

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

Поле	Описание
`total`	число акций, подходящих под запрос
`id`	id акции в системе
`title`	заголовок акции
`description`	краткое описание акции
`offer_id`	оффер ID акции
`date_start`	дата начала акции
`date_end`	дата окончания акции
`active`	активна ли акция
`private`	эксклюзивность акции
`goal`	данные о привязанных к акции финансовых продуктах
`promocodes`	список купонов, связанных с акцией
`landings`	список лендингов, связанных с акцией
`banners`	список баннеров, связанных с акцией
`status`	статус акции
`min_price`	минимальная сумма заказа по акции
`present_title`	название подарка по акции
`present_url`	url подарка по акции
`present_image`	url изображения подарка по акции
`categories_selection`	выборка категорий из товарного фида для промокода [all/only/except]
`categories`	категории товарного фида, относящиеся к выборке
`type`	тип акции [discount/free_delivery/present/other]
`short_name`	краткое описание акции
`discount`	скидка по акции
`discount_type`	тип скидки [percent/rub].

Промокоды

Для получения списка купонов в формате JSON или XML, необходимо отправить GET-запрос на адрес:

https://api.advcake.ru/promocodes?pass={API-key}

Дополнительно могут быть указаны следующие GET-параметры:

Параметр	Описание
`offer_id`	отобразить купоны для оффера с указанным ID;
`offset`	отобразить купоны начиная с указанного порядкового номера;
`limit`	задать лимит выводимых купонов (не более 300 записей);
`type`	выбрать формат ответа JSON или XML (по умолчанию JSON).

Примеры

Поиск купонов для оффера c ID = 240:

https://api.advcake.ru/promocodes?pass={API-key}&offer_id=240

Установить лимит на количество полученных купонов равный 10:

https://api.advcake.ru/promocodes?pass={API-key}&limit=10

Получить купоны начиная с 5-го в списке:

https://api.advcake.ru/promocodes?pass={API-key}&offset=5

Получить купон с ID = 480:

https://api.advcake.ru/promocodes/480?pass={API-key}

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

Поле	Описание
`total`	число промокодов, подходящих под запрос
`id`	id промокода в системе
`short_name`	краткое название промокода
`name`	название промокода
`offer_id`	ID оффера промокода
`offer_name`	название оффера промокода
`offer_url`	URL оффера промокода
`description`	описание промокода
`min_price`	минимально необходимая сумма по промокоду
`discount`	скидка по промокоду
`discount_type`	тип скидки [percent/rub]
`date_start`	дата начала действия промокода (может отсутствовать)
`date_end`	дата окончания действия промокода (может отсутствовать)
`active`	активен ли промокод
`forced_attribution`	является ли промокод атрибутивным
`referral_link`	реферальная ссылка к промокоду
`private`	эксклюзивность промокода
`present_title`	название подарка по промокоду
`present_url`	url подарка по промокоду
`type`	тип промокода [discount/free_delivery/present/other]
`promotion`	данные об акции, к которой привязан промокод
`landing`	данные о лендингах, которые привязаны к той же акции, что и промокод
`banners`	данные о баннерах, которые привязаны к той же акции, что и промокод
`categories_selection`	выборка категорий из товарного фида [all/only/except]
`categories`	категории товарного фида, относящиеся к выборке
`status`	статус промокода
`used_24h`	использовался ли за последние сутки
`used_7d`	использовался ли за последнюю неделю
`last_use`	дата последнего использования
`min_price_24h`	минимальная сумма заказа при использовании промокода за последние сутки
`min_price_7d`	минимальная сумма заказа при использовании промокода за последнюю неделю
`chance`	вероятность работоспособности промокода (very high/high/medium/below the average/low).

Баннеры

Для получения списка баннеров в формате JSON или XML, необходимо отправить GET-запрос на адрес:

https://api.advcake.ru/banners?pass={API-key}&offer_id=2

Обязательный параметр: offer_id — ID оффера для фильтрации баннеров.

Дополнительно могут быть указаны следующие GET-параметры:

Параметр	Описание
`offset`	отобразить баннеры начиная с указанного порядкового номера;
`limit`	задать лимит выводимых баннеров (по умолчанию 100);
`type`	выбрать формат ответа JSON или XML (по умолчанию JSON).

Примеры

Установить лимит на количество полученных баннеров равный 10:

https://api.advcake.ru/banners?pass={API-key}&offer_id={offer_id}&limit=10

Получить баннеры начиная с 5-го в списке:

https://api.advcake.ru/banners?pass={API-key}&offer_id={offer_id}&offset=5

Получить баннер с ID = 636:

https://api.advcake.ru/banners/636?pass={API-key}

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

Поле	Описание
`total`	число баннеров, подходящих под запрос
`id`	id баннера в системе
`name`	название баннера
`offer_id`	оффер ID баннера
`size_width`	ширина баннера
`size_height`	высота баннера
`banner_image_url`	url баннера
`mime_type`	тип баннера
`date_start`	дата начала действия баннера (может отсутствовать)
`date_end`	дата окончания действия баннера (может отсутствовать)
`active`	активен ли баннер
`private`	эксклюзивность баннера.

Вам помогла эта страница?

Последнее изменение: 2026-03-21

API Партнёров

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

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

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

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

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

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

На этой странице: