SelSup Developers

Public API · API Reference

Advertising campaigns

Endpoints for Advertising campaigns, including exact routes, parameters, request bodies, and expandable response schemas.

10 endpoints/api/campaignStableMachine-readable description ↗
{ }

This page is backed by an editable standalone contract. Validate write operations with test data before production use.

/api/campaign

Ready-to-use workflows

Ready-to-use workflows

01

Start using Advertising campaigns

Use a dedicated API token and validate read operations with test data first.

  1. Keep the token server-side and send it in the Authorization header.
  2. Check required parameters and expand the request or response schema.
  3. Handle the HTTP status and the stable error field in application errors.

Data model

Data structures

Models are listed once here and can also be expanded directly from the endpoints that use them.

CampaignFilter17 fields
limitinteger · int32

Limit.

pageinteger · int32

Page.

countboolean

Count.

sortBystring

Sort By.

ascendingboolean

Ascending.

statusstring

Status.

campaignStatusstring

Campaign Status.

typeinteger · int32

Type.

offsetinteger · int32

Offset.

servicestring

Service.

dateTostring · date-time

Date To.

dateFromstring · date-time

Date From.

isStatCampaignboolean

Is Stat Campaign.

dateStartstring · date-time

Date Start.

querystring

Query.

productExternalIdinteger · int64

Product External Id.

organizationIdsinteger[]

Organization Ids.

CampaignStatExportRequest4 fields
servicestring

Service.

organizationIdinteger · int64

Organization Id.

organizationIdsinteger[]

Organization Ids.

filterCampaignFilter

Filter.

TmsTask25 fields
idinteger · int64

Id.

read-only
statusstring

Status.

read-only
typestring

Type.

read-only
namestring

Name.

clientIdinteger · int64

Client Id.

entityIdinteger · int64

Entity Id.

progressinteger · int32

Progress.

processedQuantityinteger · int32

Processed Quantity.

organizationIdinteger · int64

Organization Id.

priorityinteger · int32

Priority.

propertiesstring

Properties.

messagestring

Message.

messageParamsstring

Message Params.

createdDatestring · date-time

Created Date.

startDatestring · date-time

Start Date.

finishDatestring · date-time

Finish Date.

urlstring

Url.

inputFileUrlstring

Input File Url.

retryNumberinteger · int32

Retry Number.

userIdinteger · int32

User Id.

retryDatestring · date-time

Retry Date.

debugboolean

Debug.

forcedStartboolean

Forced Start.

servicestring

Service.

langstring

Lang.

Campaign22 fields
idinteger · int64

Id.

externalIdinteger · int64

External Id.

namestring

Name.

campaignNamestring

Campaign Name.

typestring

Type.

statusTypestring

Status Type.

productIdinteger · int64

Product Id.

externalProductIdinteger · int64

External Product Id.

createDatestring · date-time

Create Date.

endDatestring · date-time

End Date.

startDatestring · date-time

Start Date.

suminteger · int64

Sum.

writeOffTypestring

Write Off Type.

onPauseboolean

On Pause.

clientIdinteger · int64

Client Id.

servicestring

Service.

categoryIdinteger · int64

Category Id.

categoryNamestring

Category Name.

campaignTypestring

Campaign Type.

dateStatImportstring · date-time

Date Stat Import.

nmsstring

Nms.

paymentTypestring

Payment Type.

WildberriesType32 fields
idinteger · int64

Id.

namestring

Name.

publishedboolean

Published.

hasSizeboolean

Has Size.

monoBoxMinQuantityinteger · int32

Mono Box Min Quantity.

monoTypestring

Mono Type.

monoMinPriceinteger · int32

Mono Min Price.

hasParentboolean

Has Parent.

parentIdinteger · int64

Parent Id.

wildberriesIdinteger · int64

Wildberries Id.

lastSyncDatestring · date-time

Last Sync Date.

notChangedDaysinteger · int32

Not Changed Days.

commissionnumber · double

Commission.

fbsCommissionnumber · double

Fbs Commission.

fbwCommissionnumber · double

Fbw Commission.

dbsCommissionnumber · double

Dbs Commission.

edbsCommissionnumber · double

Edbs Commission.

cAndCCommissionnumber · double

C And CCommission.

bookingCommissionnumber · double

Booking Commission.

logisticPriceinteger · int32

Logistic Price.

storagePricenumber · double

Storage Price.

acceptancePricenumber · double

Acceptance Price.

needDimensionsboolean

Need Dimensions.

purchasePercentAvgnumber · double

Purchase Percent Avg.

purchasePercentMinnumber · double

Purchase Percent Min.

photoAvginteger · int32

Photo Avg.

photoMininteger · int32

Photo Min.

drrAvgnumber · double

Drr Avg.

drrMinnumber · double

Drr Min.

marginAvgnumber · double

Margin Avg.

marginMinnumber · double

Margin Min.

candCCommissionnumber · double

Cand CCommission.

CampaignStat4 fields
campaignstring

Campaign.

valuenumber · double

Value.

organizationIdinteger · int64

Organization Id.

organizationNamestring

Organization Name.

CampaignTotalStats4 fields
clicksCampaignStat[]

Clicks.

viewsCampaignStat[]

Views.

expensesCampaignStat[]

Expenses.

averageCostCampaignStat[]

Average Cost.

FindResponseStatCampaign1 fields
rowsStatCampaign[]

Rows.

StatCampaign46 fields
limitinteger · int32

Limit.

pageinteger · int32

Page.

countboolean

Count.

sortBystring

Sort By.

ascendingboolean

Ascending.

statCampaignIdinteger · int64

Stat Campaign Id.

viewsinteger · int32

Views.

clicksinteger · int32

Clicks.

ratioClicksViewsnumber · double

Ratio Clicks Views.

averageCostnumber · double

Average Cost.

expensesnumber · double

Expenses.

quantityAddCartinteger · int32

Quantity Add Cart.

quantityOrdersinteger · int32

Quantity Orders.

ratioOrdersOfVisitsnumber · double

Ratio Orders Of Visits.

quantityProductOrdersinteger · int32

Quantity Product Orders.

ordersAmountnumber · double

Orders Amount.

campaignIdinteger · int64

Campaign Id.

campaignNamestring

Campaign Name.

createDatestring · date-time

Create Date.

servicestring

Service.

campaignTypestring

Campaign Type.

categoryNamestring

Category Name.

externalIdinteger · int64

External Id.

productIdinteger · int64

Product Id.

productViewIdinteger · int64

Product View Id.

datestring · date-time

Date.

startDatestring · date-time

Start Date.

endDatestring · date-time

End Date.

importDatestring · date-time

Import Date.

uniqueIdstring

Unique Id.

clientIdinteger · int64

Client Id.

organizationIdinteger · int64

Organization Id.

organizationNamestring

Organization Name.

rowTypestring

Row Type.

quantityBuyoutsnumber · double

Quantity Buyouts.

revenuenumber · double

Revenue.

profitFactnumber · double

Profit Fact.

marginFactnumber · double

Margin Fact.

drrnumber · double

Drr.

cpsnumber · double

Cps.

quantityBuyoutsForecastnumber · double

Quantity Buyouts Forecast.

profitForecastnumber · double

Profit Forecast.

marginForecastnumber · double

Margin Forecast.

allowableExpensesnumber · double

Allowable Expenses.

currencystring

Currency.

unavailableReasonsobject

Unavailable Reasons.

FindResponseCampaign1 fields
rowsCampaign[]

Rows.

WbBalance3 fields
balanceinteger · int32

Balance.

netinteger · int32

Net.

bonusinteger · int32

Bonus.

Error contract

How application errors are returned

The error code is identical in every locale, while the user-facing message is translated by the server. Build application logic around error and use localMessage for display only.

error

Stable machine-readable code for integration logic.

localMessage

Display-ready message in the API token user's language.

params

Values interpolated by the server into the localized message template.

localMessage uses the lang field of the user who owns the API token. The documentation language and Accept-Language header do not change it; Russian is used when the user has no language configured.

RUUser locale is ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
ENUser locale is en
{
  "error": "error_brand_already_exists",
  "localMessage": "Brand Base already exists",
  "params": {
    "name": "Base"
  }
}

Endpoints

Endpoints

POST

Update Status Campaign

/api/campaign/updateStatusCampaign
Token with write access

Update Status Campaign using POST /api/campaign/updateStatusCampaign.

Query parameters

FieldTypeRequiredDescription
campaignId integer · int64 Yes Campaign Id.
status stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Yes Status.
organizationId integer · int64 Yes Organization Id.
curl --request POST 'https://api.selsup.ru/api/campaign/updateStatusCampaign?campaignId=1001&status=DELETED&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200

The response has no body.

Errors9

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

400error_organization_not_found
Organization not found

Endpoint-specific error. Use the stable error_organization_not_found code in application logic; localMessage contains the translation shown above.

400error_prepared_integration_not_found
prepared integration not found

Endpoint-specific error. Use the stable error_prepared_integration_not_found code in application logic; localMessage contains the translation shown above.

400error_subscription_expired
Your subscription has expired. Pay the tariff to continue using the service.

Endpoint-specific error. Use the stable error_subscription_expired code in application logic; localMessage contains the translation shown above.

400error_token_expired_or_revoked
API token revoked or entered incorrectly

Endpoint-specific error. Use the stable error_token_expired_or_revoked code in application logic; localMessage contains the translation shown above.

400error_wildberries_api
{message}

Endpoint-specific error. Use the stable error_wildberries_api code in application logic; localMessage contains the translation shown above.

POST

Export Campaign Stats

/api/campaign/stats/xlsx
Token with write access

Export Campaign Stats using POST /api/campaign/stats/xlsx.

Request body

application/json
Object fieldsCampaignStatExportRequest
FieldTypeRequiredDescription
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC No Service.
organizationId integer · int64 No Organization Id.
organizationIds integer[] No Organization Ids.
filter CampaignFilter No Filter.
Object fields CampaignFilter
FieldTypeRequiredDescription
limit integer · int32 No Limit.
page integer · int32 No Page.
count boolean No Count.
sortBy stringEXTERNALID, SERVICE, CAMPAIGNNAME, CAMPAIGNTYPE, CATEGORYNAME, VIEWS, CLICKS, RATIOCLICKSVIEWS, AVERAGECOST, EXPENSES, QUANTITYADDCART, QUANTITYORDERS, RATIOORDERSOFVISITS, QUANTITYPRODUCTORDERS, ORDERSAMOUNT, CREATEDATE, STATUS No Sort By.
ascending boolean No Ascending.
status string No Status.
campaignStatus stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED No Campaign Status.
type integer · int32 No Type.
offset integer · int32 No Offset.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC No Service.
dateTo string · date-time No Date To.
dateFrom string · date-time No Date From.
isStatCampaign boolean No Is Stat Campaign.
dateStart string · date-time No Date Start.
query string No Query.
productExternalId integer · int64 No Product External Id.
organizationIds integer[] No Organization Ids.
curl --request POST 'https://api.selsup.ru/api/campaign/stats/xlsx' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "service": "NONE",
  "organizationId": 1001,
  "organizationIds": "string",
  "filter": "string"
}'

Success response

200
Object fields TmsTask
FieldTypeRequiredDescription
id integer · int64 No Id.
status stringCREATED, RUNNING, FINISHED, ERROR, RESTARTING, INTERRUPTING, INTERRUPTED, STOPPED, EXCEPTION No Status.
type stringWILDBERRIES_CREATE_CARD, NATIONAL_CATALOG_CREATE_CARD, OZON_CREATE_CARD, OZON_CARDS_IMPORT, IMPORT_FBS_ORDERS, UPLOAD_PHOTOGRAPHY, WILDBERRIES_UPDATE_PRICE, WILDBERRIES_CARD_IMPORT, WILDBERRIES_CARD_UPDATE, SELSUP_STOCKS, REFRESH_PHOTOGRAPHY, SUPPLYING_QUANTITY_TASK, EXPORT_PRICE, OZON_UPDATE_PRICE, WILDBERRIES_FILE_TASK, YANDEX_MARKET_CARD_CREATE, OZON_CARD_UPDATE_TASK, OZON_IMPORT_STAT_TASK, WILDBERRIES_PROFIT_STAT_TASK, ALIEXPRESS_CREATE_CARD_TASK, ALIEXPRESS_UPDATE_CARD_TASK, PRICES_IMPORT_TASK, WILDBERRIES_PRICES_TASK, YANDEX_MARKET_CARD_IMPORT, STOCKS_UPDATE, WILDBERRIES_STOCKS_IMPORT_TASK, WILDBERRIES_ORDERS_AND_SALES_TASK, WILDBERRIES_INCOMES_IMPORT_TASK, OZON_STOCKS_IMPORT_TASK, TURNOVER_DOCUMENTS_TASK, INTRODUCE_WMS_ITEMS_TASK, PRODUCTS_FILE_TASK, MODELS_FILE_TASK, UPDATE_PRODUCT_CODES_TASK, INTRODUCE_CODES_TASK, PRODUCTS_IMPORT_TASK, PRICES_FILE_TASK, YANDEX_MARKET_UPDATE_PRICE_TASK, IMPORT_STOCKS_TASK, MOY_SKLAD_EXPORT_ORDERS, MERGE_PRODUCTS_TASK, PRODUCTS_WILDBERRIES_EXCEL_IMPORT_TASK, MOY_SKLAD_CREATE_CARD, IMPORT_FBO_STOCKS_FROM_FILE, CREATE_WMS_ITEMS, MOY_SKLAD_CARDS_IMPORT, PROMOTION_FILE, UNUSED_1, UNUSED, PRODUCT_ANALYTICS_FILE_TASK, PROMOTION_RESET_FILE, MOY_SKLAD_IMPORT_ORDERS, FINANCE_REPORT_FILE_TASK, YML_FILE_EXPORT, PRODUCT_BALANCE_REPORT_FILE_TASK, CURRENT_PRODUCT_BALANCE_FILE_TASK, IMPORT_TRANSACTIONS, MATCH_UNREGISTERED_PROFIT_REPORT_TASK, UPDATE_AVERAGE_SERVICE_EXPENSES_TASK, YANDEX_MARKET_ORDER_IMPORT_STAT_TASK, ABC_REPORT_FILE_TASK, MODEL_CONTRACTORS_IMPORT, MODEL_CONTRACTORS_EXPORT, BANK_TRANSACTION_IMPORT_FILE_TASK, YML_IMPORT_TASK, SALES_DYNAMIC_REPORT_FILE_TASK, UPDATE_FBS_ORDERS, EXPORT_TRANSACTION_IN_EXCEL_FILE_TASK, IMPORT_TRANSACTION_FROM_EXCEL_FILE_TASK, EXPORT_PROFIT_REPORT_FILE_TASK, IMPORT_PROFIT_REPORT_FROM_EXCEL_FILE_TASK, IMPORT_REALIZATION_REPORT_TASK, STOCK_RECONCILIATION, ORDER_REPORT_FILE_TASK, GET_WB_FBO_ORDER_FROM_PROFIT_REPORT_TASK, TO_QUANTITY_STORAGE_METHOD, APPLY_RECONCILIATION, OZON_IMPORT_FBO_ORDERS_TASK, UPDATE_PURCHASE_PRICE_IN_PROFIT_REPORT_TASK, FBS_LABELS, MERGE_PRODUCT_STOCKS, CREATE_ORDER_FROM_FILE, ALIEXPRESS_CARD_IMPORT, PRICE_LIST_IMPORT, WB_STOCK_REPORT_FILE, CONTRACTORS_REPORT_FILE, PRODUCTS_SBER_MEGA_MARKET_EXCEL_IMPORT_TASK, EXPORT_PROBLEMATIC_PRODUCT_REPORT, PLAN_SUPPLY_REPORT_TASK, PLAN_FACT_SALES_REPORT_FILE, IMPORT_PLAN_SALES_FROM_EXCEL_FILE_TASK, EXPORT_PLAN_SALES_EXCEL_FILE_TASK, ORDERS_TO_BUY_FILE_TASK, MERGE_PRICE_ON_OTHER_MP_TASK, MATCH_PRODUCT_LAST_OPERATION_DATE_TASK, PROBLEMATIC_PRODUCT_PRICE_FILE_TASK, CATEGORIES_IMPORT_EXCEL_TASK, AVITO_CARD_IMPORT, UPDATE_OLD_WB_ORDER_STATUSES_TASK, PRESTA_SHOP_IMPORT_TASK, PRODUCTS_AVITO_EXCEL_IMPORT_TASK, FBO_STOCK_RECONCILIATION_TASK, APPLY_FBO_RECONCILIATION_TASK, EXPORT_REPRICE_PRODUCT_CONFIG_TASK, IMPORT_REPRICE_PRODUCT_CONFIG_TASK, OZON_CASH_FLOW_STATEMENT_IMPORT_TASK, IMPORT_PROMOTION_STRATEGY_FILE_TASK, UPDATE_ORDER_DELIVERY_INFO_TASK, BILLING_OPERATION_TASK, SET_PURCHASE_PERCENT_TASK, REMOVE_PRODUCT_IMAGES_TASK, STRUCTURE_TURNOVER_TASK, OZON_NEW_UPDATE_PRICE, REPLACE_PRODUCT_IMAGE_TASK, UPDATE_OZON_PROMOTION_DATA_TASK, WILDBERRIES_IMPORT_CAMPAIGN_TASK, WILDBERRIES_STORAGE_REPORT_TASK, WEBASYST_LINK_ARTICLE_TASK, DELIVERY_SERVICE_LABELS, HAND_ON_PULSE_FILE_TASK, ITEMS_INCOME_EXCEL_TASK, UPDATE_SETS_EXCEL_TASK, DELETE_PROFIT_REPORTS_BY_FILE_HISTORY_IDS_TASK, EXPORT_PRODUCT_SETS_TASK, AMAZON_CARD_IMPORT, IMPORT_ACCEPTED_PRODUCTS_TASK, ADD_ORDER_PRODUCT_FROM_FILE_TASK, EXPORT_ITEM_HISTORY_FILE_TASK, WILDBERRIES_IMPORT_CAMPAIGN_BY_EXCEL_TASK, REMOVE_CLIENT_ORGANIZATION, EBAY_CARD_IMPORT_TASK, PRODUCTS_IMPORT_FROM_ORGANIZATION_TASK, IMPORT_FBO_ORDERS, LAMODA_CARD_IMPORT, UPDATE_WB_PROMOTION_DATA_TASK, IMPORT_RETURNS_REPORT_TASK, UPDATE_PROMOTION_DATA_TASK, RESTORE_CLIENT_ORGANIZATION, LEROY_MERLIN_CARD_IMPORT, YANDEX_MARKET_STOCKS_IMPORT_TASK, WILDBERRIES_IMPORT_NM_REPORT_TASK, ORDER_ANALYTICS_FILE_TASK, CLIENT_DATABASE_MOVE_TASK, FAST_CARD_IMPORT, EXPORT_PRODUCT_CODE, INSALES_CARD_IMPORT_TASK, REMOVE_PRODUCT_VIDEOS_TASK, UPDATE_CARDS_TASK, FIND_UNPROFITABLE_PRODUCTS_TASK, FIND_UNPURCHASED_PRODUCTS_TASK, WALMART_CARD_IMPORT, PRODUCT_GROUPS_TASK, CONTRACTOR_ARTICLE_EXPORT_TASK, CONTRACTOR_ARTICLE_IMPORT_TASK, CURRENCY_CONVERSION_TASK, UPDATE_SUPPLY_PLAN_REPORT_TASK, EXPORT_SUPPLY_PLAN_REPORT_FILE_TASK, CHECK_STOCK_ORDER, PHOTOGRAPHY_EXCEL, PREPARE_FINDIR_DATA_TASK, CARD_SPLITTING_TASK, EXPORT_IMAGE_UPDATES_TEMPLATE_TASK, IMPORT_IMAGE_UPDATES_TASK, PREPARE_PRODUCT_HAND_ON_PULSE_TASK, UPDATE_OZON_AVERAGE_DELIVERY_TIME, UPDATE_COMMISSIONS_TASK, WOOCOMMERCE_CARD_IMPORT, UPDATE_FBS_STOCKS_HISTORY, RETURNS_FILE_TASK, FAST_PRODUCTS_IMPORT_TASK, ANALYZE_PRODUCT_CARDS_TASK, DETMIR_CARD_IMPORT, MATCH_OZON_REALIZATION_REPORT_TASK, MAGNIT_IMPORT_PRODUCTS_TASK, UPDATE_PURCHASE_PRICE_FROM_STOCKS_IN_PROFIT_REPORT_TASK, MOY_SKLAD_FBO_MP_DATES_FIX, PRICE_HISTORY_FILE_TASK, FBM_ORDERS_IMPORT_TASK, UZUM_IMPORT_PRODUCTS_TASK, OPENCART_CARD_IMPORT, CARDS_IMPORT, OZON_CROSSDOCK_TRANSIT_ROUTES_TASK, UNUSED_2, OZON_IMPORT_SALES_FUNNEL_REPORT_TASK, WRITE_OFF_PRODUCTS_FILE_TASK, CLIENT_DATABASE_CREATE_TASK, UPDATE_FBS_LABELS_TASK, REBUILD_PROFIT_REPORT_HOURLY_AGGREGATE_TASK, OZON_IMPORT_CAMPAIGN_TASK, EXPORT_SUPPLY_PLAN_FILE_TASK, IMPORT_SUPPLY_PLAN_FILE_TASK, CREATE_SERVICE_CARDS, WAREHOUSE_ECONOMICS_FILE_TASK, UPDATE_WILDBERRIES_ACQUIRING_RATE_TASK, PRODUCT_SALES_FORECAST_TASK, UPDATE_PRODUCT_CODES_STATUSES_TASK, MARKETPLACE_UPDATE_PRICE_TASK, UZUM_IMPORT_STAT_TASK, CAMPAIGN_STATS_FILE_TASK, OZON_FBO_WORKFLOW_TASK, EXPORT_CERTIFICATE_TEMPLATE_TASK, IMPORT_CERTIFICATES_TASK, REBUILD_LOCAL_ORDER_PROFIT_REPORT_TASK, SHOPIFY_CARD_IMPORT No Type.
name string No Name.
clientId integer · int64 No Client Id.
entityId integer · int64 No Entity Id.
progress integer · int32 No Progress.
processedQuantity integer · int32 No Processed Quantity.
organizationId integer · int64 No Organization Id.
priority integer · int32 No Priority.
properties string No Properties.
message string No Message.
messageParams string No Message Params.
createdDate string · date-time No Created Date.
startDate string · date-time No Start Date.
finishDate string · date-time No Finish Date.
url string No Url.
inputFileUrl string No Input File Url.
retryNumber integer · int32 No Retry Number.
userId integer · int32 No User Id.
retryDate string · date-time No Retry Date.
debug boolean No Debug.
forcedStart boolean No Forced Start.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC No Service.
lang string No Lang.
{
  "id": 1001,
  "status": "CREATED",
  "type": "WILDBERRIES_CREATE_CARD",
  "name": "Example",
  "clientId": 1001,
  "entityId": 1001
}
Errors9

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_analytics_access_denied
Analytics data is confidential for the SUPPORT role

Endpoint-specific error. Use the stable error_analytics_access_denied code in application logic; localMessage contains the translation shown above.

400error_no_marketplace
Marketplace not specified

Endpoint-specific error. Use the stable error_no_marketplace code in application logic; localMessage contains the translation shown above.

400error_no_organization
Organization not specified

Endpoint-specific error. Use the stable error_no_organization code in application logic; localMessage contains the translation shown above.

400error_subscription_expired
Your subscription has expired. Pay the tariff to continue using the service.

Endpoint-specific error. Use the stable error_subscription_expired code in application logic; localMessage contains the translation shown above.

400error_unsupported_service
Marketplace not supported

Endpoint-specific error. Use the stable error_unsupported_service code in application logic; localMessage contains the translation shown above.

400error_user_does_not_have_this_organization
The user does not have access to this organization

Endpoint-specific error. Use the stable error_user_does_not_have_this_organization code in application logic; localMessage contains the translation shown above.

POST

Create Campaign

/api/campaign/createCampaign
Token with write access

Create Campaign using POST /api/campaign/createCampaign.

Query parameters

FieldTypeRequiredDescription
organizationId integer · int64 Yes Organization Id.

Request body

application/json
Object fieldsCampaign
FieldTypeRequiredDescription
id integer · int64 No Id.
externalId integer · int64 No External Id.
name string No Name.
campaignName string No Campaign Name.
type stringIN_CATALOG, IN_CARD, IN_SEARCH, IN_MAIN, AUTO, IN_SEARCH_AND_CATALOG, BRAND_SHELF, UNKNOWN No Type.
statusType stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED No Status Type.
productId integer · int64 No Product Id.
externalProductId integer · int64 No External Product Id.
createDate string · date-time No Create Date.
endDate string · date-time No End Date.
startDate string · date-time No Start Date.
sum integer · int64 No Sum.
writeOffType stringBALANCE, NET, BONUS No Write Off Type.
onPause boolean No On Pause.
clientId integer · int64 No Client Id.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC No Service.
categoryId integer · int64 No Category Id.
categoryName string No Category Name.
campaignType string No Campaign Type.
dateStatImport string · date-time No Date Stat Import.
nms string No Nms.
paymentType string No Payment Type.
curl --request POST 'https://api.selsup.ru/api/campaign/createCampaign?organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "externalId": 1001,
  "name": "Example",
  "campaignName": "Example",
  "type": "IN_CATALOG",
  "statusType": "DELETED"
}'

Success response

200
Object fields Campaign
FieldTypeRequiredDescription
id integer · int64 No Id.
externalId integer · int64 No External Id.
name string No Name.
campaignName string No Campaign Name.
type stringIN_CATALOG, IN_CARD, IN_SEARCH, IN_MAIN, AUTO, IN_SEARCH_AND_CATALOG, BRAND_SHELF, UNKNOWN No Type.
statusType stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED No Status Type.
productId integer · int64 No Product Id.
externalProductId integer · int64 No External Product Id.
createDate string · date-time No Create Date.
endDate string · date-time No End Date.
startDate string · date-time No Start Date.
sum integer · int64 No Sum.
writeOffType stringBALANCE, NET, BONUS No Write Off Type.
onPause boolean No On Pause.
clientId integer · int64 No Client Id.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC No Service.
categoryId integer · int64 No Category Id.
categoryName string No Category Name.
campaignType string No Campaign Type.
dateStatImport string · date-time No Date Stat Import.
nms string No Nms.
paymentType string No Payment Type.
{
  "id": 1001,
  "externalId": 1001,
  "name": "Example",
  "campaignName": "Example",
  "type": "IN_CATALOG",
  "statusType": "DELETED"
}
Errors10

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

400error_organization_not_found
Organization not found

Endpoint-specific error. Use the stable error_organization_not_found code in application logic; localMessage contains the translation shown above.

400error_prepared_integration_not_found
prepared integration not found

Endpoint-specific error. Use the stable error_prepared_integration_not_found code in application logic; localMessage contains the translation shown above.

400error_service_not_supported
Service not supported

Endpoint-specific error. Use the stable error_service_not_supported code in application logic; localMessage contains the translation shown above.

400error_subscription_expired
Your subscription has expired. Pay the tariff to continue using the service.

Endpoint-specific error. Use the stable error_subscription_expired code in application logic; localMessage contains the translation shown above.

400error_token_expired_or_revoked
API token revoked or entered incorrectly

Endpoint-specific error. Use the stable error_token_expired_or_revoked code in application logic; localMessage contains the translation shown above.

400error_wildberries_api
{message}

Endpoint-specific error. Use the stable error_wildberries_api code in application logic; localMessage contains the translation shown above.

GET

Import Campaigns

/api/campaign/updateCampaigns
Token with read access

Import Campaigns using GET /api/campaign/updateCampaigns.

Query parameters

FieldTypeRequiredDescription
organizationId integer · int64 Yes Organization Id.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Yes Service.
curl --request GET 'https://api.selsup.ru/api/campaign/updateCampaigns?organizationId=1001&service=NONE' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Object fields TmsTask
FieldTypeRequiredDescription
id integer · int64 No Id.
status stringCREATED, RUNNING, FINISHED, ERROR, RESTARTING, INTERRUPTING, INTERRUPTED, STOPPED, EXCEPTION No Status.
type stringWILDBERRIES_CREATE_CARD, NATIONAL_CATALOG_CREATE_CARD, OZON_CREATE_CARD, OZON_CARDS_IMPORT, IMPORT_FBS_ORDERS, UPLOAD_PHOTOGRAPHY, WILDBERRIES_UPDATE_PRICE, WILDBERRIES_CARD_IMPORT, WILDBERRIES_CARD_UPDATE, SELSUP_STOCKS, REFRESH_PHOTOGRAPHY, SUPPLYING_QUANTITY_TASK, EXPORT_PRICE, OZON_UPDATE_PRICE, WILDBERRIES_FILE_TASK, YANDEX_MARKET_CARD_CREATE, OZON_CARD_UPDATE_TASK, OZON_IMPORT_STAT_TASK, WILDBERRIES_PROFIT_STAT_TASK, ALIEXPRESS_CREATE_CARD_TASK, ALIEXPRESS_UPDATE_CARD_TASK, PRICES_IMPORT_TASK, WILDBERRIES_PRICES_TASK, YANDEX_MARKET_CARD_IMPORT, STOCKS_UPDATE, WILDBERRIES_STOCKS_IMPORT_TASK, WILDBERRIES_ORDERS_AND_SALES_TASK, WILDBERRIES_INCOMES_IMPORT_TASK, OZON_STOCKS_IMPORT_TASK, TURNOVER_DOCUMENTS_TASK, INTRODUCE_WMS_ITEMS_TASK, PRODUCTS_FILE_TASK, MODELS_FILE_TASK, UPDATE_PRODUCT_CODES_TASK, INTRODUCE_CODES_TASK, PRODUCTS_IMPORT_TASK, PRICES_FILE_TASK, YANDEX_MARKET_UPDATE_PRICE_TASK, IMPORT_STOCKS_TASK, MOY_SKLAD_EXPORT_ORDERS, MERGE_PRODUCTS_TASK, PRODUCTS_WILDBERRIES_EXCEL_IMPORT_TASK, MOY_SKLAD_CREATE_CARD, IMPORT_FBO_STOCKS_FROM_FILE, CREATE_WMS_ITEMS, MOY_SKLAD_CARDS_IMPORT, PROMOTION_FILE, UNUSED_1, UNUSED, PRODUCT_ANALYTICS_FILE_TASK, PROMOTION_RESET_FILE, MOY_SKLAD_IMPORT_ORDERS, FINANCE_REPORT_FILE_TASK, YML_FILE_EXPORT, PRODUCT_BALANCE_REPORT_FILE_TASK, CURRENT_PRODUCT_BALANCE_FILE_TASK, IMPORT_TRANSACTIONS, MATCH_UNREGISTERED_PROFIT_REPORT_TASK, UPDATE_AVERAGE_SERVICE_EXPENSES_TASK, YANDEX_MARKET_ORDER_IMPORT_STAT_TASK, ABC_REPORT_FILE_TASK, MODEL_CONTRACTORS_IMPORT, MODEL_CONTRACTORS_EXPORT, BANK_TRANSACTION_IMPORT_FILE_TASK, YML_IMPORT_TASK, SALES_DYNAMIC_REPORT_FILE_TASK, UPDATE_FBS_ORDERS, EXPORT_TRANSACTION_IN_EXCEL_FILE_TASK, IMPORT_TRANSACTION_FROM_EXCEL_FILE_TASK, EXPORT_PROFIT_REPORT_FILE_TASK, IMPORT_PROFIT_REPORT_FROM_EXCEL_FILE_TASK, IMPORT_REALIZATION_REPORT_TASK, STOCK_RECONCILIATION, ORDER_REPORT_FILE_TASK, GET_WB_FBO_ORDER_FROM_PROFIT_REPORT_TASK, TO_QUANTITY_STORAGE_METHOD, APPLY_RECONCILIATION, OZON_IMPORT_FBO_ORDERS_TASK, UPDATE_PURCHASE_PRICE_IN_PROFIT_REPORT_TASK, FBS_LABELS, MERGE_PRODUCT_STOCKS, CREATE_ORDER_FROM_FILE, ALIEXPRESS_CARD_IMPORT, PRICE_LIST_IMPORT, WB_STOCK_REPORT_FILE, CONTRACTORS_REPORT_FILE, PRODUCTS_SBER_MEGA_MARKET_EXCEL_IMPORT_TASK, EXPORT_PROBLEMATIC_PRODUCT_REPORT, PLAN_SUPPLY_REPORT_TASK, PLAN_FACT_SALES_REPORT_FILE, IMPORT_PLAN_SALES_FROM_EXCEL_FILE_TASK, EXPORT_PLAN_SALES_EXCEL_FILE_TASK, ORDERS_TO_BUY_FILE_TASK, MERGE_PRICE_ON_OTHER_MP_TASK, MATCH_PRODUCT_LAST_OPERATION_DATE_TASK, PROBLEMATIC_PRODUCT_PRICE_FILE_TASK, CATEGORIES_IMPORT_EXCEL_TASK, AVITO_CARD_IMPORT, UPDATE_OLD_WB_ORDER_STATUSES_TASK, PRESTA_SHOP_IMPORT_TASK, PRODUCTS_AVITO_EXCEL_IMPORT_TASK, FBO_STOCK_RECONCILIATION_TASK, APPLY_FBO_RECONCILIATION_TASK, EXPORT_REPRICE_PRODUCT_CONFIG_TASK, IMPORT_REPRICE_PRODUCT_CONFIG_TASK, OZON_CASH_FLOW_STATEMENT_IMPORT_TASK, IMPORT_PROMOTION_STRATEGY_FILE_TASK, UPDATE_ORDER_DELIVERY_INFO_TASK, BILLING_OPERATION_TASK, SET_PURCHASE_PERCENT_TASK, REMOVE_PRODUCT_IMAGES_TASK, STRUCTURE_TURNOVER_TASK, OZON_NEW_UPDATE_PRICE, REPLACE_PRODUCT_IMAGE_TASK, UPDATE_OZON_PROMOTION_DATA_TASK, WILDBERRIES_IMPORT_CAMPAIGN_TASK, WILDBERRIES_STORAGE_REPORT_TASK, WEBASYST_LINK_ARTICLE_TASK, DELIVERY_SERVICE_LABELS, HAND_ON_PULSE_FILE_TASK, ITEMS_INCOME_EXCEL_TASK, UPDATE_SETS_EXCEL_TASK, DELETE_PROFIT_REPORTS_BY_FILE_HISTORY_IDS_TASK, EXPORT_PRODUCT_SETS_TASK, AMAZON_CARD_IMPORT, IMPORT_ACCEPTED_PRODUCTS_TASK, ADD_ORDER_PRODUCT_FROM_FILE_TASK, EXPORT_ITEM_HISTORY_FILE_TASK, WILDBERRIES_IMPORT_CAMPAIGN_BY_EXCEL_TASK, REMOVE_CLIENT_ORGANIZATION, EBAY_CARD_IMPORT_TASK, PRODUCTS_IMPORT_FROM_ORGANIZATION_TASK, IMPORT_FBO_ORDERS, LAMODA_CARD_IMPORT, UPDATE_WB_PROMOTION_DATA_TASK, IMPORT_RETURNS_REPORT_TASK, UPDATE_PROMOTION_DATA_TASK, RESTORE_CLIENT_ORGANIZATION, LEROY_MERLIN_CARD_IMPORT, YANDEX_MARKET_STOCKS_IMPORT_TASK, WILDBERRIES_IMPORT_NM_REPORT_TASK, ORDER_ANALYTICS_FILE_TASK, CLIENT_DATABASE_MOVE_TASK, FAST_CARD_IMPORT, EXPORT_PRODUCT_CODE, INSALES_CARD_IMPORT_TASK, REMOVE_PRODUCT_VIDEOS_TASK, UPDATE_CARDS_TASK, FIND_UNPROFITABLE_PRODUCTS_TASK, FIND_UNPURCHASED_PRODUCTS_TASK, WALMART_CARD_IMPORT, PRODUCT_GROUPS_TASK, CONTRACTOR_ARTICLE_EXPORT_TASK, CONTRACTOR_ARTICLE_IMPORT_TASK, CURRENCY_CONVERSION_TASK, UPDATE_SUPPLY_PLAN_REPORT_TASK, EXPORT_SUPPLY_PLAN_REPORT_FILE_TASK, CHECK_STOCK_ORDER, PHOTOGRAPHY_EXCEL, PREPARE_FINDIR_DATA_TASK, CARD_SPLITTING_TASK, EXPORT_IMAGE_UPDATES_TEMPLATE_TASK, IMPORT_IMAGE_UPDATES_TASK, PREPARE_PRODUCT_HAND_ON_PULSE_TASK, UPDATE_OZON_AVERAGE_DELIVERY_TIME, UPDATE_COMMISSIONS_TASK, WOOCOMMERCE_CARD_IMPORT, UPDATE_FBS_STOCKS_HISTORY, RETURNS_FILE_TASK, FAST_PRODUCTS_IMPORT_TASK, ANALYZE_PRODUCT_CARDS_TASK, DETMIR_CARD_IMPORT, MATCH_OZON_REALIZATION_REPORT_TASK, MAGNIT_IMPORT_PRODUCTS_TASK, UPDATE_PURCHASE_PRICE_FROM_STOCKS_IN_PROFIT_REPORT_TASK, MOY_SKLAD_FBO_MP_DATES_FIX, PRICE_HISTORY_FILE_TASK, FBM_ORDERS_IMPORT_TASK, UZUM_IMPORT_PRODUCTS_TASK, OPENCART_CARD_IMPORT, CARDS_IMPORT, OZON_CROSSDOCK_TRANSIT_ROUTES_TASK, UNUSED_2, OZON_IMPORT_SALES_FUNNEL_REPORT_TASK, WRITE_OFF_PRODUCTS_FILE_TASK, CLIENT_DATABASE_CREATE_TASK, UPDATE_FBS_LABELS_TASK, REBUILD_PROFIT_REPORT_HOURLY_AGGREGATE_TASK, OZON_IMPORT_CAMPAIGN_TASK, EXPORT_SUPPLY_PLAN_FILE_TASK, IMPORT_SUPPLY_PLAN_FILE_TASK, CREATE_SERVICE_CARDS, WAREHOUSE_ECONOMICS_FILE_TASK, UPDATE_WILDBERRIES_ACQUIRING_RATE_TASK, PRODUCT_SALES_FORECAST_TASK, UPDATE_PRODUCT_CODES_STATUSES_TASK, MARKETPLACE_UPDATE_PRICE_TASK, UZUM_IMPORT_STAT_TASK, CAMPAIGN_STATS_FILE_TASK, OZON_FBO_WORKFLOW_TASK, EXPORT_CERTIFICATE_TEMPLATE_TASK, IMPORT_CERTIFICATES_TASK, REBUILD_LOCAL_ORDER_PROFIT_REPORT_TASK, SHOPIFY_CARD_IMPORT No Type.
name string No Name.
clientId integer · int64 No Client Id.
entityId integer · int64 No Entity Id.
progress integer · int32 No Progress.
processedQuantity integer · int32 No Processed Quantity.
organizationId integer · int64 No Organization Id.
priority integer · int32 No Priority.
properties string No Properties.
message string No Message.
messageParams string No Message Params.
createdDate string · date-time No Created Date.
startDate string · date-time No Start Date.
finishDate string · date-time No Finish Date.
url string No Url.
inputFileUrl string No Input File Url.
retryNumber integer · int32 No Retry Number.
userId integer · int32 No User Id.
retryDate string · date-time No Retry Date.
debug boolean No Debug.
forcedStart boolean No Forced Start.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC No Service.
lang string No Lang.
{
  "id": 1001,
  "status": "CREATED",
  "type": "WILDBERRIES_CREATE_CARD",
  "name": "Example",
  "clientId": 1001,
  "entityId": 1001
}
Errors5

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_analytics_access_denied
Analytics data is confidential for the SUPPORT role

Endpoint-specific error. Use the stable error_analytics_access_denied code in application logic; localMessage contains the translation shown above.

400error_unsupported_service
Marketplace not supported

Endpoint-specific error. Use the stable error_unsupported_service code in application logic; localMessage contains the translation shown above.

GET

Reload Campaign Stats

/api/campaign/reloadCampaignStats
Token with read access

Reload Campaign Stats using GET /api/campaign/reloadCampaignStats.

Query parameters

FieldTypeRequiredDescription
dateFrom string · date Yes Date From.
dateTo string · date Yes Date To.
organizationId integer · int64 Yes Organization Id.
isExpensesOnly boolean No Is Expenses Only.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Yes Service.
curl --request GET 'https://api.selsup.ru/api/campaign/reloadCampaignStats?dateFrom=2026-01-15&dateTo=2026-01-15&organizationId=1001&service=NONE' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200

The response has no body.

Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

GET

Get Wildberries Subjects

/api/campaign/getWildberriesSubjects
Token with read access

Get Wildberries Subjects using GET /api/campaign/getWildberriesSubjects.

Query parameters

FieldTypeRequiredDescription
query string Yes Query.
limit integer · int32 Yes Limit.
organizationId integer · int64 Yes Organization Id.
curl --request GET 'https://api.selsup.ru/api/campaign/getWildberriesSubjects?query=string&limit=50&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Array item structure WildberriesType[]
FieldTypeRequiredDescription
id integer · int64 No Id.
name string No Name.
published boolean No Published.
hasSize boolean No Has Size.
monoBoxMinQuantity integer · int32 No Mono Box Min Quantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE No Mono Type.
monoMinPrice integer · int32 No Mono Min Price.
hasParent boolean No Has Parent.
parentId integer · int64 No Parent Id.
wildberriesId integer · int64 No Wildberries Id.
lastSyncDate string · date-time No Last Sync Date.
notChangedDays integer · int32 No Not Changed Days.
commission number · double No Commission.
fbsCommission number · double No Fbs Commission.
fbwCommission number · double No Fbw Commission.
dbsCommission number · double No Dbs Commission.
edbsCommission number · double No Edbs Commission.
cAndCCommission number · double No C And CCommission.
bookingCommission number · double No Booking Commission.
logisticPrice integer · int32 No Logistic Price.
storagePrice number · double No Storage Price.
acceptancePrice number · double No Acceptance Price.
needDimensions boolean No Need Dimensions.
purchasePercentAvg number · double No Purchase Percent Avg.
purchasePercentMin number · double No Purchase Percent Min.
photoAvg integer · int32 No Photo Avg.
photoMin integer · int32 No Photo Min.
drrAvg number · double No Drr Avg.
drrMin number · double No Drr Min.
marginAvg number · double No Margin Avg.
marginMin number · double No Margin Min.
candCCommission number · double No Cand CCommission.
[
  "string"
]
Errors7

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_organization_not_found
Organization not found

Endpoint-specific error. Use the stable error_organization_not_found code in application logic; localMessage contains the translation shown above.

400error_prepared_integration_not_found
prepared integration not found

Endpoint-specific error. Use the stable error_prepared_integration_not_found code in application logic; localMessage contains the translation shown above.

400error_subscription_expired
Your subscription has expired. Pay the tariff to continue using the service.

Endpoint-specific error. Use the stable error_subscription_expired code in application logic; localMessage contains the translation shown above.

400error_token_expired_or_revoked
API token revoked or entered incorrectly

Endpoint-specific error. Use the stable error_token_expired_or_revoked code in application logic; localMessage contains the translation shown above.

GET

Get Total Stat Campaigns

/api/campaign/getTotalStatCampaigns
Token with read access

Get Total Stat Campaigns using GET /api/campaign/getTotalStatCampaigns.

Query parameters

FieldTypeRequiredDescription
organizationId integer · int64 No Organization Id.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Yes Service.
status string No Status.
campaignStatus stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED No Campaign Status.
type integer · int32 No Type.
offset integer · int32 No Offset.
dateTo string · date-time No Date To.
dateFrom string · date-time No Date From.
isStatCampaign boolean No Is Stat Campaign.
dateStart string · date-time No Date Start.
query string No Query.
productExternalId integer · int64 No Product External Id.
organizationIds integer[] No Organization Ids.
limit integer · int32 No Limit.
page integer · int32 No Page.
count boolean No Count.
sortBy stringEXTERNALID, SERVICE, CAMPAIGNNAME, CAMPAIGNTYPE, CATEGORYNAME, VIEWS, CLICKS, RATIOCLICKSVIEWS, AVERAGECOST, EXPENSES, QUANTITYADDCART, QUANTITYORDERS, RATIOORDERSOFVISITS, QUANTITYPRODUCTORDERS, ORDERSAMOUNT, CREATEDATE, STATUS No Sort By.
ascending boolean No Ascending.
topN integer · int32 Yes Top N.
curl --request GET 'https://api.selsup.ru/api/campaign/getTotalStatCampaigns?service=NONE&limit=50&page=1&topN=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Object fields CampaignTotalStats
FieldTypeRequiredDescription
clicks CampaignStat[] No Clicks.
Array item structure CampaignStat
FieldTypeRequiredDescription
campaign string No Campaign.
value number · double No Value.
organizationId integer · int64 No Organization Id.
organizationName string No Organization Name.
views CampaignStat[] No Views.
Array item structure CampaignStat
FieldTypeRequiredDescription
campaign string No Campaign.
value number · double No Value.
organizationId integer · int64 No Organization Id.
organizationName string No Organization Name.
expenses CampaignStat[] No Expenses.
Array item structure CampaignStat
FieldTypeRequiredDescription
campaign string No Campaign.
value number · double No Value.
organizationId integer · int64 No Organization Id.
organizationName string No Organization Name.
averageCost CampaignStat[] No Average Cost.
Array item structure CampaignStat
FieldTypeRequiredDescription
campaign string No Campaign.
value number · double No Value.
organizationId integer · int64 No Organization Id.
organizationName string No Organization Name.
{
  "clicks": "string",
  "views": "string",
  "expenses": "string",
  "averageCost": "string"
}
Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

GET

Get Stat Campaigns

/api/campaign/getStatCampaigns
Token with read access

Get Stat Campaigns using GET /api/campaign/getStatCampaigns.

Query parameters

FieldTypeRequiredDescription
organizationId integer · int64 No Organization Id.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Yes Service.
status string No Status.
campaignStatus stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED No Campaign Status.
type integer · int32 No Type.
offset integer · int32 No Offset.
dateTo string · date-time No Date To.
dateFrom string · date-time No Date From.
isStatCampaign boolean No Is Stat Campaign.
dateStart string · date-time No Date Start.
query string No Query.
productExternalId integer · int64 No Product External Id.
organizationIds integer[] No Organization Ids.
limit integer · int32 No Limit.
page integer · int32 No Page.
count boolean No Count.
sortBy stringEXTERNALID, SERVICE, CAMPAIGNNAME, CAMPAIGNTYPE, CATEGORYNAME, VIEWS, CLICKS, RATIOCLICKSVIEWS, AVERAGECOST, EXPENSES, QUANTITYADDCART, QUANTITYORDERS, RATIOORDERSOFVISITS, QUANTITYPRODUCTORDERS, ORDERSAMOUNT, CREATEDATE, STATUS No Sort By.
ascending boolean No Ascending.
curl --request GET 'https://api.selsup.ru/api/campaign/getStatCampaigns?service=NONE&limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Object fields FindResponseStatCampaign
FieldTypeRequiredDescription
rows StatCampaign[] No Rows.
Array item structure StatCampaign
FieldTypeRequiredDescription
limit integer · int32 No Limit.
page integer · int32 No Page.
count boolean No Count.
sortBy string No Sort By.
ascending boolean No Ascending.
statCampaignId integer · int64 No Stat Campaign Id.
views integer · int32 No Views.
clicks integer · int32 No Clicks.
ratioClicksViews number · double No Ratio Clicks Views.
averageCost number · double No Average Cost.
expenses number · double No Expenses.
quantityAddCart integer · int32 No Quantity Add Cart.
quantityOrders integer · int32 No Quantity Orders.
ratioOrdersOfVisits number · double No Ratio Orders Of Visits.
quantityProductOrders integer · int32 No Quantity Product Orders.
ordersAmount number · double No Orders Amount.
campaignId integer · int64 No Campaign Id.
campaignName string No Campaign Name.
createDate string · date-time No Create Date.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC No Service.
campaignType stringIN_CATALOG, IN_CARD, IN_SEARCH, IN_MAIN, AUTO, IN_SEARCH_AND_CATALOG, BRAND_SHELF, UNKNOWN No Campaign Type.
categoryName string No Category Name.
externalId integer · int64 No External Id.
productId integer · int64 No Product Id.
productViewId integer · int64 No Product View Id.
date string · date-time No Date.
startDate string · date-time No Start Date.
endDate string · date-time No End Date.
importDate string · date-time No Import Date.
uniqueId string No Unique Id.
clientId integer · int64 No Client Id.
organizationId integer · int64 No Organization Id.
organizationName string No Organization Name.
rowType stringCAMPAIGN, UNALLOCATED No Row Type.
quantityBuyouts number · double No Quantity Buyouts.
revenue number · double No Revenue.
profitFact number · double No Profit Fact.
marginFact number · double No Margin Fact.
drr number · double No Drr.
cps number · double No Cps.
quantityBuyoutsForecast number · double No Quantity Buyouts Forecast.
profitForecast number · double No Profit Forecast.
marginForecast number · double No Margin Forecast.
allowableExpenses number · double No Allowable Expenses.
currency string No Currency.
unavailableReasons object No Unavailable Reasons.
{
  "rows": "string"
}
Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

GET

Get Campaigns

/api/campaign/getCampaigns
Token with read access

Get Campaigns using GET /api/campaign/getCampaigns.

Query parameters

FieldTypeRequiredDescription
organizationId integer · int64 Yes Organization Id.
status string No Status.
campaignStatus stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED No Campaign Status.
type integer · int32 No Type.
offset integer · int32 No Offset.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC No Service.
dateTo string · date-time No Date To.
dateFrom string · date-time No Date From.
isStatCampaign boolean No Is Stat Campaign.
dateStart string · date-time No Date Start.
query string No Query.
productExternalId integer · int64 No Product External Id.
organizationIds integer[] No Organization Ids.
limit integer · int32 No Limit.
page integer · int32 No Page.
count boolean No Count.
sortBy stringEXTERNALID, SERVICE, CAMPAIGNNAME, CAMPAIGNTYPE, CATEGORYNAME, VIEWS, CLICKS, RATIOCLICKSVIEWS, AVERAGECOST, EXPENSES, QUANTITYADDCART, QUANTITYORDERS, RATIOORDERSOFVISITS, QUANTITYPRODUCTORDERS, ORDERSAMOUNT, CREATEDATE, STATUS No Sort By.
ascending boolean No Ascending.
curl --request GET 'https://api.selsup.ru/api/campaign/getCampaigns?organizationId=1001&limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Object fields FindResponseCampaign
FieldTypeRequiredDescription
rows Campaign[] No Rows.
Array item structure Campaign
FieldTypeRequiredDescription
id integer · int64 No Id.
externalId integer · int64 No External Id.
name string No Name.
campaignName string No Campaign Name.
type stringIN_CATALOG, IN_CARD, IN_SEARCH, IN_MAIN, AUTO, IN_SEARCH_AND_CATALOG, BRAND_SHELF, UNKNOWN No Type.
statusType stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED No Status Type.
productId integer · int64 No Product Id.
externalProductId integer · int64 No External Product Id.
createDate string · date-time No Create Date.
endDate string · date-time No End Date.
startDate string · date-time No Start Date.
sum integer · int64 No Sum.
writeOffType stringBALANCE, NET, BONUS No Write Off Type.
onPause boolean No On Pause.
clientId integer · int64 No Client Id.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC No Service.
categoryId integer · int64 No Category Id.
categoryName string No Category Name.
campaignType string No Campaign Type.
dateStatImport string · date-time No Date Stat Import.
nms string No Nms.
paymentType string No Payment Type.
{
  "rows": "string"
}
Errors4

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

GET

Get Campaign Balance

/api/campaign/getCampaignBalance
Token with read access

Get Campaign Balance using GET /api/campaign/getCampaignBalance.

Query parameters

FieldTypeRequiredDescription
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Yes Service.
organizationId integer · int64 Yes Organization Id.
curl --request GET 'https://api.selsup.ru/api/campaign/getCampaignBalance?service=NONE&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Object fields WbBalance
FieldTypeRequiredDescription
balance integer · int32 No Balance.
net integer · int32 No Net.
bonus integer · int32 No Bonus.
{
  "balance": 1,
  "net": 1,
  "bonus": 1
}
Errors7

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_organization_not_found
Organization not found

Endpoint-specific error. Use the stable error_organization_not_found code in application logic; localMessage contains the translation shown above.

400error_service_not_supported
Service not supported

Endpoint-specific error. Use the stable error_service_not_supported code in application logic; localMessage contains the translation shown above.

400error_subscription_expired
Your subscription has expired. Pay the tariff to continue using the service.

Endpoint-specific error. Use the stable error_subscription_expired code in application logic; localMessage contains the translation shown above.

400error_token_expired_or_revoked
API token revoked or entered incorrectly

Endpoint-specific error. Use the stable error_token_expired_or_revoked code in application logic; localMessage contains the translation shown above.

Authorization

Token for test requests

The token stays in this browser's localStorage and is sent only in the Authorization header of requests to api.selsup.ru.

Try it

Real request parameters

Live API response

Send a request to see the SelSup response.