Marketing and Promotion · promotion

Module promotion has 43 operations.

Specification doc ↗ · All modules

Promo calendar, campaign management, bid settings, financial data accounting, and settings for with standard and custom bid and media campaigns. Data synchronization from the database occurs every 3 minutes. Status changes occur every 1 minute. The bid change occurs every 30 seconds. The latest changes are saved within the intervals.

Campaigns

Method	Path	Operation
GET	/adv/v1/promotion/count	Campaigns Lists
GET	/api/advert/v3/adverts	Campaigns Information
GET	/api/advert/v2/adverts	Campaigns Information

Creating Campaigns

Method	Path	Operation
POST	/api/advert/v1/bids/min	Minimum Bids for Listings
POST	/adv/v2/seacat/save-ad	Create Campaign
GET	/adv/v1/supplier/subjects	Subcategories for Campaigns
POST	/adv/v2/supplier/nms	Listings for Campaigns

Campaign Management

Method	Path	Operation
GET	/adv/v0/delete	Delete Campaign
POST	/adv/v0/rename	Rename Campaign
GET	/adv/v0/start	Launch Campaign
GET	/adv/v0/pause	Pause Campaign
GET	/adv/v0/stop	Stop Campaign
PUT	/adv/v0/auction/placements	Changing Placements in Campaigns with Custom Bid
PATCH	/api/advert/v1/bids	Changing Campaigns Bids
PATCH	/adv/v0/auction/nms	Changing the Listings in Campaigns
GET	/api/advert/v0/bids/recommendations	Recommended bids for items and search clusters
GET	/api/advert/v1/config	Promotion Configuration Values
GET	/api/advert/v0/daily-limits	Get Campaign Daily Limits Settings
PUT	/api/advert/v0/daily-limits	Set Campaign Daily Limits

Finances

Method	Path	Operation
GET	/adv/v1/balance	Balance
POST	/api/advert/v2/budget	Campaign Budget Balances
GET	/adv/v1/budget	Campaign Budget
POST	/adv/v1/budget/deposit	Top-up of the Campaign Budget
GET	/adv/v1/upd	Receiving Costs History
GET	/adv/v1/payments	Receiving the History of Account Top-ups

Statistics

Method	Path	Operation
POST	/adv/v0/normquery/stats	Search Clusters Statistics
GET	/adv/v3/fullstats	Campaigns Statistics
POST	/adv/v1/stats	Media Campaign Statistics
POST	/adv/v1/normquery/stats	Daily Search Clusters Statistics

Search Clusters

Method	Path	Operation
POST	/adv/v0/normquery/get-bids	List of Search Clusters Bids
POST	/api/advert/v1/normquery/bids	Set Bids for Search Clusters in the Currency of the Seller Account
POST	/adv/v0/normquery/bids	Set Bids for Search Clusters
DELETE	/adv/v0/normquery/bids	Delete Bids from Search Clusters
POST	/adv/v0/normquery/get-minus	List of Campaign Minus Phrases
POST	/adv/v0/normquery/set-minus	Setting and Deleting Minus Phrases
POST	/adv/v0/normquery/list	Active and Inactive Search Cluster Lists

Media

Method	Path	Operation
GET	/adv/v1/count	Media Campaigns Number
GET	/adv/v1/adverts	List of Media Campaigns
GET	/adv/v1/advert	Information About Media Campaign

Promo Calendar

Method	Path	Operation
GET	/api/v1/calendar/promotions	Promos List
GET	/api/v1/calendar/promotions/details	Promos Details
GET	/api/v1/calendar/promotions/nomenclatures	List of Items for Participating in the Promo
POST	/api/v1/calendar/promotions/upload	Add Item to the Promo