Deals

Информация за публикувани от Вас оферти в Grabo.bg.

Функции:

deals/list: Връща списък с публикуваните от Вас оферти.

» Функция deals/list

Връща списък с публикуваните от Вас оферти, подредени по дата на стартиране, низходящо.

Request URL:

https://grabo.bg/api/partners/deals/list/?api_key={api_key}&company_id={company_id}

Параметри към заявката (освен задължителните api_key и company_id):

filter_active	незадължителен	Ако се подаде true, ще върне само текущите активни оферти в Grabo.bg. В противен случай ще върне всички оферти (вкл. и изтеклите).
num_per_page	незадължителен	По колко резултата да върне наведнъж. Трябва да е число между 10 и 500. Ако не се подаде, стойността ще бъде 50.
page	незадължителен	Коя "страница" от резултатите да върне (на paging принцип). По подразбиране е 1.

Примерен отговор:

{ "success": true, "error": false, "result": { "filter_active": null, "items_count": 120, "num_per_page": 50, "num_pages": 3, "page": 1, "items": [ // ... ] } }

Структура на result от отговора:

Параметър	Тип	Стойност
filter_active	null or integer	Дали резултатите са филтрирани поради подаден параметър filter_active към заявката.
items_count	integer	Брой намерени оферти, отговарящи на зададените критерии.
num_per_page	integer	По колко резултата връща наведнъж, съобразно параметъра num_per_page.
num_pages	integer	Брой страници с резултати.
page	integer	Текуща страница, за която са върнати резултатите в items.
items	array	Масив с офертите (описан по-долу), отговарящи на зададените критерии, за съответната страница page.

Структура на всяка конкретна оферта от items:

Параметър	Тип	Стойност
id	string	Идентификатор на офертата.
title	string	Заглавие на офертата.
company_name	string	Брандът, от чието име е публикувана офертата.
profile_id	integer	Идентификатор на профила, от чието име е публикувана офертата.
image	string	URL адрес към основното изображение на офертата.
date_start	date	Дата на стартиране на офертата (формат: YY-MM-DD hh:mm:ss).
date_end	date	Дата на изтичане на офертата (формат: YY-MM-DD hh:mm:ss).
status	string	Статус на офертата: ACTIVE за текущо активна оферта; ENDED за изтекла оферта; SOLDOUT за текущо активна оферта с изчерпани количества.
variants	array	Вариации на продаваната услуга (описани по-долу).
deal_url	string	URL адрес към офертата в потребителската част на Grabo.bg.
partners_url	string	URL адрес към административната страница на офертата в Партньорския панел на Grabo.bg.
vouchers	integer	Текущ брой издадени ваучери към офертата.
vouchers_waiting	integer	Текущ брой непотвърдени заявки (заявени ваучери, но все още не заплатени).
customers	integer	Брой потребители-купувачи с изадени ваучери по офертата.
turnover	float	Оборот на офертата (сума на авансово заплатените средства от потребителите-купувачи).
site_commission_percent	float	Размер (в процент от оборота) на наемната цена на Grabo.bg за конкретната оферта.
impressions	integer	Текущ брой импресии на офертата (показванията ѝ в списъците с оферти в Grabo.bg).
pageviews	integer	Текущ брой преглеждания на офертата на страницата ѝ в Grabo.bg.
emails_sent	integer	Текущ брой писма, част от дневния e-mail бюлетин на Grabo.bg към потребители, в които офертата е участвала.

Структура на всяка конкретна вариация на продавана услуга от variants:

Параметър	Тип	Стойност
id	integer	Идентификатор на варианта.
title	string	Заглавие на оферираната услуга/стока.
price_regular	float	Регулярна цена (цена без отстъпка) на оферираната услуга/стока.
price_promo	float	Продажна цена на оферираната услуга/стока.
amount_to_prepray	float	Сума, която потребителят-купувач следва да предплати към Grabo.bg, за да получи ваучер.
amount_to_surcharge	float	Сума, извън предплатената, която потребителят-купувач следва допълнително да заплати към Вас.
currency	string	BGN

Grabo.bg Начало · Контакти · Помощ · Общи условия · Лични данни · Бисквитки