API Вебмастеров
| API | Описание |
|---|---|
| Постбэк (Webhook) | Получите информацию о заказах, товарах, а также изменении статуса партнёрской программы. |
| XML с заказами | Получите XML-список заказов. |
| Статистика по офферам | Получите статистику по офферам в формате JSON или XML. |
| Условия офферов | Получите список офферов в формате JSON или XML. |
| Лендинги | Получите список лендингов в формате JSON или XML. |
| Акции | Получите список акций в формате JSON или XML. |
| Промокоды | Получите список купонов в формате JSON или XML. |
| Баннеры | Получите список баннеров в формате JSON или XML. |
| Категории | Получите список категорий в формате JSON или XML. |
| Типы трафика | Получите список типов трафика в формате JSON или XML. |
| Подготовленные фиды | Получите список общих товарных фидов в форматах XML, GSF и CSV. |
| Сохраненные фиды | Получите список товарных фидов в формате JSON или XML. |
| Статистика использования купонов | Получите статистику использования купонов в формате JSON или XML. |
| Cakelink | Перенаправьте пользователей на сайт партнёрской программы напрямую, без использования редиректора. |
| Бестселлеры | Получите список бестселлеров в формате JSON или XML. |
Ваш API-key находится в Настройках профиля → поле «Апи ключ».
При переходе по ссылке из личного кабинета все необходимые данные подставятся автоматически.
Постбэк (Webhook)
Постбэк — это метод, используемый для быстрой передачи актуальной информации о заказах к вам в систему.
В настройках постбэков вы указываете URL вашего сервера и названия параметров, в которых хотели бы получать информацию, и, при возникновении события, по указанному URL совершается вызов с набором параметров и актуальных значений.
XML с заказами
Для получения XML-списка заказов, необходимо отправить GET-запрос на адрес:
https://api.advcake.com/export/webmaster/{API-key}Дополнительно могут быть указаны следующие GET-параметры:
| Параметр | Описание |
|---|---|
days | Отобразить заказы за заданное количество дней (не более 7), начиная от текущей даты (если не указано, то 1). |
date_from и date_to | Отобразить заказы в промежутке указанных дат (включительно). Формат дат: YYYY-MM-DD. |
update_from и update_to | Отобразить заказы, обновленные в промежутке указанных дат (включительно), формат дат: YYYY-MM-DD. |
ids | Отобразить список заказов, id которых перечисляются через запятую (1 и более элементов). |
basket=1 | Режим отображения заказов с корзиной (будут отображены все заказы, если у них есть корзина — отобразится и она; доступно только в Ecommerce-офферах). |
paid | Отобразить заказы, оплата по которым была произведена (yes) или не была произведена (no). |
payment_status | Отобразить заказы с указанным статусом выплаты вознаграждения: open (неподтвержденная комиссия), on_hold (на холде), balance (согласованная комиссия), processing (ожидает оплаты), withdrawal (комиссия выведена), not_apply (не подлежит выплате). |
Примеры
- Получить список заказов за последние 7 дней:
https://api.advcake.com/export/webmaster/{API-key}?days=7- Получить список заказов по выбранному офферу:
https://api.advcake.com/export/webmaster/{API-key}?offer=demo- Получить список заказов по выбранному ID оффера:
https://api.advcake.com/export/webmaster/{API-key}?offer_id=240- Получить информацию по заказам с ID 123, 456 и 789:
https://api.advcake.com/export/webmaster/{API-key}?ids=123,456,789- Получить список заказов с корзиной за текущую дату:
https://api.advcake.com/export/webmaster/{API-key}?basket=1- Получить список заказов с 14 по 21 февраля 2023 года включительно:
https://api.advcake.com/export/webmaster/{API-key}?date_from=2022-11-03&date_to=2022-11-10- Получить список заказов, обновленных с 14 по 21 февраля 2023 года включительно:
https://api.advcake.com/export/webmaster/{API-key}?update_from=2022-11-03&update_to=2022-11-10- Получить список готовых к оплате заказов за последние 7 дней:
https://api.advcake.com/export/webmaster/{API-key}?days=7&payment_status=balance- Получить список заказов за последние 7 дней, оплата по которым не была произведена:
https://api.advcake.com/export/webmaster/{API-key}?days=7&paid=noСтатистика по офферам
Для получения статистики по офферам в формате JSON или XML, необходимо отправить GET-запрос на адрес:
https://api.advcake.com/stat?pass={API-key}Дополнительно могут быть указаны следующие GET-параметры:
| Параметр | Описание |
|---|---|
days | Отобразить статистику для офферов по заказам, созданным за заданное количество дней, начиная от текущей даты (если не указано, то 30). |
date_from и date_to | Отобразить статистику для офферов по заказам, созданным в промежутке указанных дат (включительно), формат дат: YYYY-MM-DD. |
update_from и update_to | Отобразить статистику для офферов по заказам, обновленным в промежутке указанных дат (включительно), формат дат: YYYY-MM-DD. |
goal=1 | Режим отображения статистики для финансовых офферов с дополнительной подробной статистикой по продуктам. |
offer_id | Отобразить статистику для оффера с указанным ID. |
offer_alias | Отобразить статистику для оффера с указанным алиасом. |
offset | Отобразить статистику для офферов, начиная с указанного порядкового номера. |
limit | Задать лимит выводимых офферов со статистикой. |
type | Выбрать формат ответа Json или XML. По умолчанию Json. |
Примеры
- Получить статистику для офферов по заказам, созданным за последние 30 дней:
https://api.advcake.com/stat?pass={API-key}&days=30- Получить статистику для офферов по заказам, созданным с 2024-05-21 по 2024-06-20:
https://api.advcake.com/stat?pass={API-key}&date_from=2024-05-21&date_to=2024-06-20- Получить статистику для офферов по заказам, обновленным с 2024-05-21 по 2024-06-20:
https://api.advcake.com/stat?pass={API-key}&update_from=2024-05-21&update_to=2024-06-20- Получить статистику для оффера c ID = 240:
https://api.advcake.com/stat?pass={API-key}&offer_id=240- Получить статистику для оффера c алиасом = demo:
https://api.advcake.com/stat?pass={API-key}&offer_alias=demo- Получить статистику для офферов, начиная с 5-го в списке:
https://api.advcake.com/stat?pass={API-key}&offset=5- Установить лимит на количество полученных офферов, равный 10:
https://api.advcake.com/stat?pass={API-key}&limit=10Параметры ответа
| Поле | Описание |
|---|---|
total | Число офферов, подходящих под запрос. |
offer | Название оффера. |
offer_id | ID оффера. |
offer_alias | Алиас оффера. |
visits | Количество визитов за указанный период. |
orders_total | Количество всех заказов за указанный период. |
orders_approved | Количество подтвержденных заказов за указанный период. |
orders_pending | Количество заказов в ожидании за указанный период. |
orders_rejected | Количество отмененных заказов за указанный период. |
comission_total | Комиссия всех заказов за указанный период. |
comission_approved | Комиссия подтвержденных заказов за указанный период. |
comission_pending | Комиссия заказов в ожидании за указанный период. |
comission_rejected | Комиссия отмененных заказов за указанный период. |
average_bid | Средняя ставка по заказам за указанный период. |
cr | Отношение количества заказов к визитам. |
ar | Процент одобрения заказов. |
epl | Средняя комиссия одобренных лидов. |
goal | Подробная статистика по продуктам, доступна только в финансовых офферах. |
Условия офферов
Для получения списка офферов в формате JSON или XML, необходимо отправить GET-запрос на адрес:
https://api.advcake.com/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.com/offers?pass={API-key}&website=google.com- Получить список офферов с типом трафика cashback:
https://api.advcake.com/offers?pass={API-key}&source_type=cashback- Получить список офферов обновленных после 2020-10-01:
https://api.advcake.com/offers?pass={API-key}&last_update_after=2020-10-01- Установить лимит на количество полученных офферов равный 10:
https://api.advcake.com/offers?pass={API-key}&limit=10- Получить офферы начиная с 5-го в списке:
https://api.advcake.com/offers?pass={API-key}&offset=5- Получить список офферов с актуальными ставками:
https://api.advcake.com/offers?pass={API-key}&with_bids=1- Получить список офферов без лендингов:
https://api.advcake.com/offers?pass={API-key}&with_landings=0- Получить офферы с ID = 2:
https://api.advcake.com/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 (условия применения). Поля condition: goal, traffic_type, start_date, end_date, category, coupon, min_price, customer_type, adv_sub. |
export | XML выгрузка со статистикой. |
Лендинги
Для получения списка лендингов в формате JSON или XML, необходимо отправить GET-запрос на адрес:
https://api.advcake.com/landings?pass={API-key}Дополнительно могут быть указаны следующие GET-параметры:
| Параметр | Описание |
|---|---|
offer_id | Отобразить лендинги для оффера с указанным ID. |
offer_alias | Отобразить лендинги для оффера с указанным алиасом. |
offset | Отобразить лендинги начиная с указанного порядкового номера. |
limit | Задать лимит выводимых лендингов. |
type | Выбрать формат ответа JSON или XML (по умолчанию JSON). |
Примеры
- Поиск лендингов для оффера c ID = 240:
https://api.advcake.com/landings?pass={API-key}&offer_id=240- Поиск лендингов для оффера c алиасом = clarins:
https://api.advcake.com/landings?pass={API-key}&offer_alias=clarins- Установить лимит на количество полученных лендингов равный 10:
https://api.advcake.com/landings?pass={API-key}&limit=10- Получить лендинги начиная с 5-го в списке:
https://api.advcake.com/landings?pass={API-key}&offset=5- Получить лендинг с ID = 1037:
https://api.advcake.com/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.com/promotions?pass={API-key}Дополнительно могут быть указаны следующие GET-параметры:
| Параметр | Описание |
|---|---|
offer_id | Отобразить акции для оффера с указанным ID. |
offset | Отобразить акции начиная с указанного порядкового номера. |
limit | Задать лимит выводимых акций. |
type | Выбрать формат ответа JSON или XML (по умолчанию JSON). |
Примеры
- Поиск акций для оффера c ID = 240:
https://api.advcake.com/promotions?pass={API-key}&offer_id=240- Установить лимит на количество полученных акций равный 10:
https://api.advcake.com/promotions?pass={API-key}&limit=10- Получить акции начиная с 5-го в списке:
https://api.advcake.com/promotions?pass={API-key}&offset=5- Получить акцию с ID = 1900:
https://api.advcake.com/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 подарка по акции. |
categories_selection | Выборка категорий из товарного фида [all/only/except]. |
type | Тип акции [discount/free_delivery/present/other]. |
short_name | Краткое описание акции. |
discount | Скидка по акции. |
discount_type | Тип скидки [percent/rub]. |
Промокоды
Для получения списка купонов в формате JSON или XML, необходимо отправить GET-запрос на адрес:
https://api.advcake.com/promocodes?pass={API-key}Дополнительно могут быть указаны следующие GET-параметры:
| Параметр | Описание |
|---|---|
offer_id | Отобразить купоны для оффера с указанным ID. |
offset | Отобразить купоны начиная с указанного порядкового номера. |
limit | Задать лимит выводимых купонов (не более 300 записей). |
type | Выбрать формат ответа JSON или XML (по умолчанию JSON). |
Примеры
- Поиск купонов для оффера c ID = 240:
https://api.advcake.com/promocodes?pass={API-key}&offer_id=240- Установить лимит на количество полученных купонов равный 10:
https://api.advcake.com/promocodes?pass={API-key}&limit=10- Получить купоны начиная с 5-го в списке:
https://api.advcake.com/promocodes?pass={API-key}&offset=5- Получить купон с ID = 480:
https://api.advcake.com/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 | Эксклюзивность промокода. |
type | Тип промокода [discount/free_delivery/present/other]. |
promotion | Данные об акции, к которой привязан промокод. |
landing | Данные о лендинге, привязанном к той же акции. |
banners | Данные о баннерах, привязанных к той же акции. |
categories_selection | Выборка категорий из товарного фида [all/only/except]. |
status | Статус промокода. |
used_24h | Использовался ли за последние сутки (true/false). |
used_7d | Использовался ли за последнюю неделю (true/false). |
last_use | Дата последнего использования. |
min_price_24h | Минимальная сумма заказа при использовании промокода за последние сутки. |
min_price_7d | Минимальная сумма заказа при использовании промокода за последнюю неделю. |
chance | Вероятность работоспособности промокода (very high / high / medium / below the average / low). |
Баннеры
Для получения списка баннеров в формате JSON или XML, необходимо отправить GET-запрос на адрес:
https://api.advcake.com/banners?pass={API-key}&offer_id={}Обязательный параметр: offer_id — отобразить баннеры для оффера с указанным ID.
Дополнительно могут быть указаны следующие GET-параметры:
| Параметр | Описание |
|---|---|
offset | Отобразить баннеры начиная с указанного порядкового номера. |
limit | Задать лимит выводимых баннеров (по умолчанию 100). |
type | Выбрать формат ответа JSON или XML (по умолчанию JSON). |
Примеры
- Установить лимит на количество полученных баннеров равный 10:
https://api.advcake.com/banners?pass={API-key}&offer_id={}&limit=10- Получить баннеры начиная с 5-го в списке:
https://api.advcake.com/banners?pass={API-key}&offer_id={}&offset=5- Получить баннер с ID = 636:
https://api.advcake.com/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 | Эксклюзивность баннера. |
Категории
Для получения списка категорий в формате JSON или XML, необходимо отправить GET-запрос на адрес:
https://api.advcake.com/offer-categories?pass={API-key}Дополнительно могут быть указаны следующие GET-параметры:
| Параметр | Описание |
|---|---|
offer_id | Отобразить категории для оффера с указанным ID. |
type | Выбрать формат ответа JSON или XML (по умолчанию JSON). |
Пример:
Поиск категорий для оффера c ID = 1:
https://api.advcake.com/offer-categories?pass={API-key}&offer_id=1Параметры ответа
| Поле | Описание |
|---|---|
total | Число категорий, подходящих под запрос. |
alias | Алиас категории. |
name | Название категории. |
total | Количество офферов в категории. |
Типы трафика
Для получения списка типов трафика в формате JSON или XML, необходимо отправить GET-запрос на адрес:
https://api.advcake.com/sources?pass={API-key}Дополнительно могут быть указаны следующие GET-параметры:
| Параметр | Описание |
|---|---|
offset | Отобразить типы трафика начиная с указанного порядкового номера. |
limit | Задать лимит выводимых типов трафика. |
type | Выбрать формат ответа JSON или XML (по умолчанию JSON). |
Примеры
- Установить лимит на количество полученных типов трафика равный 10:
https://api.advcake.com/sources?pass={API-key}&limit=10- Получить типы трафика начиная с 5-го в списке:
https://api.advcake.com/sources?pass={API-key}&offset=5- Получить тип трафика с ID = 4:
https://api.advcake.com/sources/4?pass={API-key}Параметры ответа
| Поле | Описание |
|---|---|
total | Число типов трафика, подходящих под запрос. |
id | ID типа трафика в системе. |
alias | Алиас типа трафика. |
name | Название типа трафика. |
Подготовленные фиды
Для получения списка общих товарных фидов в форматах XML, GSF и CSV по API необходимо отправить GET запрос на адрес:
https://api.advcake.com/common-feeds?pass={API-key}Дополнительно могут быть указаны следующие GET-параметры:
| Параметр | Описание |
|---|---|
offer_id | Отобразить фиды для оффера с указанным ID. |
offset | Отобразить фиды начиная с указанного порядкового номера. |
limit | Задать лимит выводимых фидов. |
Примеры
- Поиск фидов для оффера c ID = 240:
https://api.advcake.com/common-feeds?pass={API-key}&offer_id=240- Установить лимит на количество полученных фидов равный 10:
https://api.advcake.com/common-feeds?pass={API-key}&limit=10- Получить фиды начиная с 5-го в списке:
https://api.advcake.com/common-feeds?pass={API-key}&offset=5Параметры ответа
| Поле | Описание |
|---|---|
total | Число фидов, подходящих под запрос. |
feed_id | ID фида. |
format | Формат отдаваемых фидов. |
offer | Оффер фида. |
title | Название фида. |
url | URL для скачивания фида. |
offer_id | ID оффера фида. |
products_count | Кол-во продуктов в фиде. |
last_download | Время последнего скачивания. |
last_update | Время последнего обновления. |
Сохраненные фиды
Для получения списка товарных фидов по API в формате JSON или XML, необходимо сгенерировать нужный товарный фид в разделе «Инструменты» → «Товарные фиды», сохранить его и отправить GET-запрос на адрес:
https://api.advcake.com/feeds?pass={API-key}Дополнительно могут быть указаны следующие GET-параметры:
| Параметр | Описание |
|---|---|
offer_id | Отобразить фиды для оффера с указанным ID. |
offset | Отобразить фиды начиная с указанного порядкового номера. |
limit | Задать лимит выводимых фидов. |
type | Выбрать формат ответа JSON или XML (по умолчанию JSON). |
Примеры
- Поиск фидов для оффера c ID = 240:
https://api.advcake.com/feeds?pass={API-key}&offer_id=240- Установить лимит на количество полученных фидов равный 10:
https://api.advcake.com/feeds?pass={API-key}&limit=10- Получить фиды начиная с 5-го в списке:
https://api.advcake.com/feeds?pass={API-key}&offset=5Параметры ответа
| Поле | Описание |
|---|---|
total | Число фидов, подходящих под запрос. |
id | ID фида в системе. |
title | Название фида. |
offer_id | Оффер ID фида. |
url | URL для скачивания фида. |
products_count | Кол-во продуктов в фиде. |
last_download | Время последнего скачивания. |
Статистика использования купонов
Для получения статистики использования купонов в формате JSON или XML, необходимо отправить GET-запрос на адрес:
https://api.advcake.com/promocodes/statistic?coupons=coupon2,coupon3&pass={API-key}Обязательный параметр: coupons — перечислите купоны через запятую.
Дополнительно могут быть указаны следующие GET-параметры:
| Параметр | Описание |
|---|---|
offer_id | Отображение статистики по конкретному офферу. |
type | Выбрать формат ответа JSON или XML (по умолчанию JSON). |
Примеры
- Поиск статистики для оффера c ID = 240:
https://api.advcake.com/promocodes/statistic?coupons=coupon2,coupon3&pass={API-key}&offer_id=240- Получить статистику по купонам "coupon2" и "coupon3":
https://api.advcake.com/promocodes/statistic?coupons=coupon2,coupon3&pass={API-key}Параметры ответа
| Поле | Описание |
|---|---|
coupon | Купон, по которому получена статистика. |
offer_id | Оффер ID, на котором использован купон. |
accessed | Разрешен ли купон вебмастеру. |
usage_data | Данные об использовании купона. |
coupon_data | Данные купона в системе (см. Промокоды). |
Cakelink
Для получения полной ссылки по хешу, необходимо отправить GET-запрос на адрес:
https://cakelink.ru/{hash}?pass={API-key}Значение параметра {hash} можно увидеть в шаблоне динамической ссылки в разделе «Создать ссылку».
Для получения полной ссылки по URL хешированной ссылки в GET-параметре, необходимо отправить GET-запрос на адрес:
https://cakelink.ru/link?link=https://go.acstat.com/{hash}&pass={API-key}Для получения полной ссылки по дип линку, необходимо отправить GET-запрос на адрес:
https://cakelink.ru/link?dl={deeplink}&pass={API-key}Пример — получение полной ссылки с параметрами вебмастера для https://mvideo.com/:
https://cakelink.ru/link?dl=https://mvideo.com/&pass={API-key}Описание параметров ответа:
success— статус ответа (true/false);dt— дата и время запроса;data— массив данных ответа;url— полный URL со всеми GET-параметрами.
Бестселлеры
Для получения списка бестселлеров в формате JSON или XML, необходимо отправить GET-запрос на адрес:
https://api.advcake.com/bestseller?pass={API-key}Дополнительно могут быть указаны следующие GET-параметры:
| Параметр | Описание |
|---|---|
offer_id | Отобразить бестселлеры для оффера с указанным ID. |
date_from и date_to | Посчитать кол-во проданных товаров в промежутке указанных дат (включительно). Формат: YYYY-MM-DD HH:II:SS. |
min_count и max_count | Отобразить бестселлеры, проданные в количестве в указанном промежутке (включительно). |
min_wc и max_wc | Отобразить бестселлеры с суммой комиссии в указанном промежутке (включительно). |
sort | Задать сортировку: count (количество товаров) или wc (сумма комиссии); по умолчанию count. |
offset | Отобразить бестселлеры начиная с указанного порядкового номера. |
limit | Задать лимит выводимых бестселлеров (по умолчанию 100). |
type | Выбрать формат ответа JSON или XML (по умолчанию JSON). |
Примеры
- Получить список бестселлеров по выбранному ID оффера:
https://api.advcake.com/bestseller?pass={API-key}&offer_id=240- Получить список бестселлеров с 1 января 2022 по текущую дату:
https://api.advcake.com/bestseller?pass={API-key}&date_from=2022-01-01%2000:00:00- Получить список бестселлеров с 14 по 21 февраля 2023 года включительно:
https://api.advcake.com/bestseller?pass={API-key}&date_from=2022-11-03%2000:00:00&date_to=2022-11-10%2023:59:59- Бестселлерами считать товары, которых продано больше 50:
https://api.advcake.com/bestseller?pass={API-key}&min_count=50- Бестселлерами считать товары с комиссией от 500 руб:
https://api.advcake.com/bestseller?pass={API-key}&min_wc=500- Установить лимит на количество полученных бестселлеров равный 10:
https://api.advcake.com/bestseller?pass={API-key}&limit=10- Получить бестселлеры начиная с 5-го в списке:
https://api.advcake.com/bestseller?pass={API-key}&offset=5Параметры ответа
| Поле | Описание |
|---|---|
total | Число бестселлеров, подходящих под запрос. |
id | ID товара в системе. |
offer_id | ID оффера. |
name | Название товара. |
url | Партнёрская ссылка. |
count | Кол-во проданных товаров. |
wc | Сумма комиссии. |
Вам помогла эта страница?
Последнее изменение: 2026-01-27