### Get Campaign Objects Request Example Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Example HTTP GET request to retrieve a list of promoted objects within a specific campaign. Includes Host, Content-Type, and Authorization headers. ```http GET /api/client/campaign/48852/objects HTTP/1.1 Host: api-performance.ozon.ru:443 Content-Type: application/json Accept: application/json Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.WyJFTWhVVU...qTz2XXZBv41h4 ``` -------------------------------- ### Get Campaign Objects Response Example (200 OK) Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Example JSON response for a successful retrieval of promoted objects in a campaign. The list contains objects with their respective IDs. ```json { "list": [ { "id": "string" } ] } ``` -------------------------------- ### Response Example for Enabling Products in 'Carrots' Promotion (Success) Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense This example shows a successful response when enabling products for the 'Carrots' promotion, detailing the status for each SKU. ```json { "skuToInfo": { "property1": { "error": "CARROT_ERROR_NONE", "isDisabled": false }, "property2": { "error": "CARROT_ERROR_NONE", "isDisabled": true } } } ``` -------------------------------- ### Get Campaign Expense Request Example Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense This snippet shows an example of a GET request to retrieve campaign expense information. It includes parameters for campaign IDs, object type, and state. ```HTTP GET /api/client/campaign?campaignIds=52374&advObjectType=SKU&state=CAMPAIGN_STATE_UNKNOWN HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.WyJFTWhVVU...qTz2XXZBv41h4 Host: api-performance.ozon.ru:443 Content-Type: application/json Accept: application/json ``` -------------------------------- ### Get Daily Campaign Statistics (JSON) Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense This example shows how to request daily campaign statistics in JSON format. Ensure you include the correct Host and Authorization headers. The 'campaigns' parameter filters by campaign ID, and 'dateFrom'/'dateTo' specify the reporting period. ```HTTP GET /api/client/statistics/daily?campaigns=48852&dateFrom=2019-02-10&dateTo=2020-02-10 HTTP/1.1 Host: api-performance.ozon.ru:443 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.WyJFTWhVVU...qTz2XXZBv41h4 Content-Type: application/json ``` -------------------------------- ### Banner Campaign Response Example Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Example JSON response for a banner campaign, detailing its properties like ID, payment type, budget, and dates. ```json { "list": { "id": 48949, "paymentType": "CPM", "title": "Баннерная кампания", "state": "CAMPAIGN_STATE_RUNNING", "advObjectType": "BANNER", "fromDate": "2019-10-07", "toDate": "2021-10-07", "dailyBudget": 504000000, "placement": [ "PLACEMENT_PDP" ], "budget": 50000000, "createdAt": "2019-10-07T06:28:44.055042Z", "updatedAt": "2020-10-01T06:28:44.055042Z", "productAutopilotStrategy": "NO_AUTO_STRATEGY", "productCampaignMode": "PRODUCT_CAMPAIGN_MODE_AUTO" } } ``` -------------------------------- ### Response Example for Disabling Promotions Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense This is an example of a default error response when attempting to disable promotions. ```json { "error": "text" } ``` -------------------------------- ### Get Recommended Bids Response Payload Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense This is an example of a successful response containing recommended bids for specified SKUs. Each SKU is mapped to its recommended bid percentage. ```json { "recommendedBids": { "sku1": "string", "sku2": "string" } } ``` -------------------------------- ### GET /api/client/campaign/all_sku_promo/activate Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Activates promotion for all SKUs in a campaign. ```APIDOC ## GET /api/client/campaign/all_sku_promo/activate ### Description Activates the promotion for all SKUs within a campaign, specifically for order payment promotions. ### Method GET ### Endpoint /api/client/campaign/all_sku_promo/activate ``` -------------------------------- ### Get Campaign Expense Statistics (JSON) Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense This example shows how to request campaign expense statistics in JSON format for a specified date range and campaign IDs. Ensure you include the correct authorization header. ```http GET /api/client/statistics/campaign/product?dateFrom=2024-08-01&dateTo=2024-08-07&campaignIds=11037395&campaignIds=11037396 HTTP/1.1 Host: api-performance.ozon.ru:443 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.WyJFTWhVVU...qTz2XXZBv41h4 Content-Type: application/json ``` -------------------------------- ### GET Request for Campaign Expense List Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Example of a GET request to the /api/client/statistics/list endpoint to retrieve campaign expense data. Includes Host and Authorization headers. ```http GET /api/client/statistics/list?page=1&pageSize=100 HTTP/1.1 Host: api-performance.ozon.ru:443 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.WyJFTWhVVU...qTz2XXZBv41h4 Content-Type: application/json Accept: application/json ``` -------------------------------- ### Get Campaign Expense Limits (JSON Response) Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Example JSON response for retrieving bid limits for advertising tools. It includes overall min/max bids and category-specific bid overrides. ```json { "limits": [ { "categories": [ { "bid": 0, "category": "string" } ], "maxBid": 0, "minBid": 0, "objectType": "SKU", "paymentMethod": "CPO", "placement": "CAMPAIGN_PLACEMENT_SEARCH_AND_CATEGORY" } ] } ``` -------------------------------- ### GET Request for Vendor Tag Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Example of a GET request to retrieve the vendor tag for an organization. Ensure the Authorization header is correctly set. ```http GET /api/client/organisation/vendor_tag?orgId=42 HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.WyJFTWhVVU...qTz2XXZBv41h4 Host: api-performance.ozon.ru:443 Content-Type: application/json Accept: application/json ``` -------------------------------- ### GET /statistics/campaign/product Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves product statistics for a campaign. ```APIDOC ## GET /statistics/campaign/product ### Description Retrieves product statistics for a campaign. ### Method GET ### Endpoint /statistics/campaign/product ``` -------------------------------- ### Get Campaign Expense Statistics (JSON) Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Example of a GET request to retrieve campaign expense statistics in JSON format for a specific campaign and date range. Ensure to include the Authorization header. ```HTTP GET /api/client/statistics/expense?campaigns=48852&dateFrom=2019-02-10&dateTo=2020-02-10 HTTP/1.1 Host: api-performance.ozon.ru:443 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.WyJFTWhVVU...qTz2XXZBv41h4 Content-Type: application/json ``` -------------------------------- ### GET /api/client/statistics/all_sku_promo/products/generate Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Generates statistics for all SKUs in a campaign related to products. ```APIDOC ## GET /api/client/statistics/all_sku_promo/products/generate ### Description Generates statistics for all SKUs within a campaign, focusing on product data for order payment promotions. ### Method GET ### Endpoint /api/client/statistics/all_sku_promo/products/generate ``` -------------------------------- ### GET /campaign/{campaignId}/v2/products Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves products for a campaign using v2. ```APIDOC ## GET /campaign/{campaignId}/v2/products ### Description Retrieves products associated with a specific campaign, utilizing version 2 of the API. ### Method GET ### Endpoint /campaign/{campaignId}/v2/products ### Parameters #### Path Parameters - **campaignId** (string) - Required - The ID of the campaign to retrieve products from. ### Response (Details not provided in source) ``` -------------------------------- ### GET /campaign Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves a list of campaigns. The description for the `list.placement` parameter in the response has been updated. ```APIDOC ## GET /campaign ### Description Retrieves a list of campaigns. The description for the `list.placement` parameter in the response has been updated. ### Method GET ### Endpoint /campaign ### Response #### Success Response (200) - **list.placement** (string) - The description for this parameter has been updated. - **[other response fields]** (object) - Description of other response body structures. ``` -------------------------------- ### GET /api/client/statistics/campaign/product Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves product statistics for campaigns. ```APIDOC ## GET /api/client/statistics/campaign/product ### Description Retrieves product statistics for campaigns. ### Method GET ### Endpoint /api/client/statistics/campaign/product ``` -------------------------------- ### GET /api/client/statistics/campaign/product Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves product statistics for campaigns, including weekly budget. ```APIDOC ## GET /api/client/statistics/campaign/product ### Description Retrieves product statistics for campaigns. A weekly budget has been added to the report. ### Method GET ### Endpoint /api/client/statistics/campaign/product ``` -------------------------------- ### GET /api/client/statistics/all_sku_promo/orders/generate Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Generates statistics for all SKUs in a campaign related to orders. ```APIDOC ## GET /api/client/statistics/all_sku_promo/orders/generate ### Description Generates statistics for all SKUs within a campaign, focusing on order data for order payment promotions. ### Method GET ### Endpoint /api/client/statistics/all_sku_promo/orders/generate ``` -------------------------------- ### Successful Response (200 OK) Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Example of a successful JSON response containing the organization's vendor tag. ```json { "tag": "vendor_org_42" } ``` -------------------------------- ### GET /api/client/campaign/{campaignId}/v2/products Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves a list of products within a campaign. ```APIDOC ## GET /api/client/campaign/{campaignId}/v2/products ### Description Retrieves a list of products associated with a specific campaign. The response includes a new parameter `products.targetCir` and an updated description for `products.bid`. ### Method GET ### Endpoint /api/client/campaign/{campaignId}/v2/products ### Parameters #### Path Parameters - **campaignId** (string) - Required - The ID of the campaign to retrieve products from. ### Response #### Success Response (200) - **products.targetCir** (object) - New parameter representing target cost per impression. - **products.bid** (object) - Updated description for the bid parameter. ``` -------------------------------- ### Get Campaign Products (v2) Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves a list of products associated with a specific campaign. This is the recommended method for obtaining campaign products. ```APIDOC ## GET /campaign/{campaignId}/v2/products ### Description Retrieves a list of products associated with a specific campaign. This is the recommended method for obtaining campaign products. ### Method GET ### Endpoint /campaign/{campaignId}/v2/products ### Parameters #### Path Parameters - **campaignId** (string) - Required - The ID of the campaign. ### Response #### Success Response (200) - **field1** (type) - Description ``` -------------------------------- ### GET /campaign Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves campaign information, including weekly budget in responses. ```APIDOC ## GET /campaign ### Description Retrieves information about campaigns. The `weeklyBudget` parameter has been added to the responses. ### Method GET ### Endpoint /campaign ### Response #### Success Response - **weeklyBudget** (object) - Description of the weekly budget. (Other response fields not provided in source) ``` -------------------------------- ### Get Campaign Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves campaign information, including available object types and product campaign modes. ```APIDOC ## GET /campaign ### Description Retrieves campaign information, including available object types and product campaign modes. ### Method GET ### Endpoint /campaign ### Parameters #### Query Parameters - **advObjectType** (string) - Optional - Description of the advanced object type. ### Response #### Success Response (200) - **productCampaignMode** (string) - Description of the product campaign mode. ``` -------------------------------- ### Get Available Campaign Modes Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves the available modes for creating advertising campaigns. ```APIDOC ## GET /campaign/available ### Description Retrieves the available modes for creating advertising campaigns. ### Method GET ### Endpoint /campaign/available ``` -------------------------------- ### Get Campaign Products with Category Bid Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves products for a specific campaign, including category bid, category ID, and product title. ```APIDOC ## GET /campaign/{campaignId}/products ### Description Retrieves products for a specific campaign, including category bid, category ID, and product title. ### Method GET ### Endpoint /campaign/{campaignId}/products ### Response #### Success Response (200) - **categories.bid** (number) - Bid amount for the category. - **categories.categoryId** (string) - Identifier for the category. - **title** (string) - The name of the product. ``` -------------------------------- ### Get Products with Bonuses Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves a list of products that are eligible for bonuses. This method was added on November 18, 2025. ```APIDOC ## GET /api/client/products_with_bonuses ### Description Retrieves a list of products with bonuses. ### Method GET ### Endpoint /api/client/products_with_bonuses ``` -------------------------------- ### POST /search_promo/product/enable Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Enables products for search promotion. ```APIDOC ## POST /search_promo/product/enable ### Description Enables products for search promotion. ### Method POST ### Endpoint /search_promo/product/enable ``` -------------------------------- ### POST /search_promo/product/enable Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Enables a product for search promotion, with updated response parameters. ```APIDOC ## POST /search_promo/product/enable ### Description Enables a product for search promotion. The response parameters for this method have been updated. ### Method POST ### Endpoint /search_promo/product/enable ### Request Body (Details not provided in source) ### Response #### Success Response (Details not provided in source) ``` -------------------------------- ### GET /statistics/campaign/media Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves media statistics for a campaign. Request examples have been updated. ```APIDOC ## GET /statistics/campaign/media ### Description Retrieves media statistics for a campaign. Request examples have been updated. ### Method GET ### Endpoint /statistics/campaign/media ``` -------------------------------- ### POST /campaign/{campaignId}/products Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense This method is deprecated and has been removed from the documentation. Use GET /campaign/{campaignId}/v2/products instead. ```APIDOC ## POST /campaign/{campaignId}/products ### Description This method is deprecated and has been removed from the documentation. Use GET /campaign/{campaignId}/v2/products instead. ### Method POST ### Endpoint /campaign/{campaignId}/products ``` -------------------------------- ### List of Products with Bonuses Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense This endpoint returns a list of SKUs for products that have bonuses accrued. Bonuses are spent first before the general campaign budget. ```json { "skus": [ "string" ] } ``` -------------------------------- ### Enable Products for 'Carrots' Promotion Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Use this POST request to add specific products to the 'Carrots' promotion. The request body requires an array of SKU strings. ```bash curl -X POST https://api-seller.ozon.ru/api/client/campaign/search_promo/carrots/enable \ -H 'Content-Type: application/json' \ -d '{ "skus": [ "string" ] }' ``` -------------------------------- ### Enable All Product Promotions Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Use this endpoint to activate promotions for all products. The response includes the selected bid for the promotion. ```json { "selectedBid": "string" } ``` -------------------------------- ### GET /statistics/{UUID} Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves statistics information for a given UUID. A 'kind' field has been added to the response, along with an example. ```APIDOC ## GET /statistics/{UUID} ### Description Retrieves statistics information for a given UUID. A 'kind' field has been added to the response, along with an example. ### Method GET ### Endpoint /statistics/{UUID} ### Parameters #### Path Parameters - **UUID** (string) - Required - The unique identifier for the statistics. ``` -------------------------------- ### 200 OK Response Example Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense This snippet illustrates the structure of a successful response (200 OK) when listing products in a campaign. It includes details about each product and the total count. ```json { "products": [ { "bid": 0, "bidPrice": "string", "bidWithoutAdditive": 0, "carrotsAdditive": 0, "carrotsStatus": "CARROTS_STATUS_INVALID", "hint": { "campaignId": "string", "organisationTitle": "string" }, "imageUrl": "string", "isSearchPromoAvailable": true, "previousBid": { "bid": 0, "bidPrice": "string", "updatedAt": "2019-08-24T14:15:22Z" }, "previousVisibilityIndex": "string", "price": "string", "searchPromoStatus": true, "sku": "string", "sourceSku": "string", "title": "string", "views": { "previousWeek": "string", "thisWeek": "string" }, "visibilityIndex": "string" } ], "total": "string" } ``` -------------------------------- ### POST /search_promo/product/enable Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Enables order payment for a specific product. ```APIDOC ## POST /search_promo/product/enable ### Description Enables order payment for a specific product. ### Method POST ### Endpoint /search_promo/product/enable ``` -------------------------------- ### POST /campaign/cpm/v2/product Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Creates a new product campaign using the CPM (Cost Per Mille) model. The description for the 'placement' parameter has been updated. ```APIDOC ## POST /campaign/cpm/v2/product ### Description Creates a new product campaign using the CPM (Cost Per Mille) model. The description for the 'placement' parameter has been updated. ### Method POST ### Endpoint /campaign/cpm/v2/product ### Parameters #### Request Body - **placement** (string) - Description of the placement parameter has been updated. ### Response #### Success Response (200) - **[response fields]** (object) - Description of the response body structure. ``` -------------------------------- ### POST /campaign/search_promo/v2/products Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Adds products for search promotion (v2). ```APIDOC ## POST /campaign/search_promo/v2/products ### Description Adds products to a search promotion campaign using version 2. ### Method POST ### Endpoint /campaign/search_promo/v2/products ### Request Body (Details not provided in source) ### Response (Details not provided in source) ``` -------------------------------- ### Request Body Example Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense This snippet shows the expected JSON payload for the request body when searching for products in a campaign. Ensure 'page' and 'pageSize' are set to appropriate integer values. ```json { "page": 0, "pageSize": 0 } ``` -------------------------------- ### GET Request for Campaign Expense Report Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense This snippet shows a sample HTTP GET request to retrieve a campaign expense report. Ensure the UUID is valid and the Authorization header is correctly set. ```http GET /api/client/statistics/report?UUID=0c159c60-ab92-46d9-9a6b-d225dbf5c7b1 HTTP/1.1 Host: api-performance.ozon.ru:443 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.WyJFTWhVVU...qTz2XXZBv41h4 ``` -------------------------------- ### GET /api/client/statistics/list Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves a list of statistics. ```APIDOC ## GET /api/client/statistics/list ### Description Retrieves a list of statistics. The description of this method has been updated. ### Method GET ### Endpoint /api/client/statistics/list ``` -------------------------------- ### Get Statistics Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves statistics for campaigns. ```APIDOC ## POST /api/client/statistics ### Description Retrieves statistics for campaigns. ### Method POST ### Endpoint /api/client/statistics ``` -------------------------------- ### GET /limits/list Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves a list of available limits. ```APIDOC ## GET /limits/list ### Description Retrieves a list of available limits. ### Method GET ### Endpoint /limits/list ### Response #### Success Response (200) - **[response fields]** (object) - Description of the response body structure. ``` -------------------------------- ### List Products with Bonuses Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieve a list of product SKUs for which bonuses have been accrued. Bonuses are spent first for clicks on a product. If bonuses run out, the campaign's general budget is spent. ```APIDOC ## GET /api/client/products_with_bonuses ### Description Returns a list of product SKUs for which bonuses have been accrued. Clicks on a product will first spend accrued bonuses. If bonuses run out, the campaign's general budget will be spent. ### Method GET ### Endpoint /api/client/products_with_bonuses ### Response #### Success Response (200) - **skus** (Array of strings) - A list of product SKUs. #### Response Example ```json { "skus": [ "string" ] } ``` ``` -------------------------------- ### Response for Minimum Bid by SKU Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense This is a sample response for the minimum bid request, showing the bid size and SKU for each item. It includes an array of bid objects. ```json { "minBids": [ { "bid": 0, "sku": "string" } ] } ``` -------------------------------- ### GET /api/client/statistics/campaign/media Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves media statistics for campaigns. ```APIDOC ## GET /api/client/statistics/campaign/media ### Description Retrieves media statistics for campaigns. ### Method GET ### Endpoint /api/client/statistics/campaign/media ``` -------------------------------- ### Get Recommended Bids Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves recommended bids for a list of product SKUs. This endpoint is useful for optimizing your bidding strategy in search promotions. You can send up to 200 SKUs in a single request. ```APIDOC ## POST /api/client/search_promo/bids/recommendation ### Description Retrieves recommended bids for a list of product SKUs. This endpoint is useful for optimizing your bidding strategy in search promotions. You can send up to 200 SKUs in a single request. ### Method POST ### Endpoint /api/client/search_promo/bids/recommendation ### Parameters #### Request Body - **skus** (Array of strings) - Required - List of product identifiers. ### Request Example ```json { "skus": [ "string" ] } ``` ### Response #### Success Response (200) - **recommendedBids** (object) - List of recommended bids. - **SKU** (string) - The SKU of the product and the recommended bid per order (CPO) as a percentage of the product price. #### Response Example ```json { "recommendedBids": { "sku1": "string", "sku2": "string" } } ``` ``` -------------------------------- ### GET /api/client/campaign/all_sku_promo/deactivate Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Deactivates promotion for all SKUs in a campaign. ```APIDOC ## GET /api/client/campaign/all_sku_promo/deactivate ### Description Deactivates the promotion for all SKUs within a campaign, specifically for order payment promotions. ### Method GET ### Endpoint /api/client/campaign/all_sku_promo/deactivate ``` -------------------------------- ### POST /campaign/cpc/v2/product Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense The description of the `productAutopilotStrategy` parameter in the method request has been updated. ```APIDOC ## POST /campaign/cpc/v2/product ### Description The description of the `productAutopilotStrategy` parameter in the method request has been updated. ### Method POST ### Endpoint /campaign/cpc/v2/product ### Parameters #### Request Body - **productAutopilotStrategy** (string) - Description updated. ``` -------------------------------- ### Get Media Campaign Statistics Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Use this endpoint to retrieve statistics for media campaigns. You can specify a date range using `from` and `to` or `dateFrom` and `dateTo`. To get statistics for specific campaigns, provide their IDs in the `campaignIds` parameter. The report can be requested in CSV or JSON format. ```http GET /api/client/statistics/campaign/media?dateFrom=2024-08-01&dateTo=2024-08-01&campaignIds=11037395&campaignIds=11037396 HTTP/1.1 Host: api-performance.ozon.ru:443 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.WyJFTWhVVU...qTz2XXZBv41h4 Content-Type: application/json ``` -------------------------------- ### Get Campaign Expense Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves a list of campaigns with specified filters. ```APIDOC ## GET /api/client/campaign ### Description Retrieves a list of campaigns based on provided filters such as campaign IDs, advertising object type, and campaign state. ### Method GET ### Endpoint /api/client/campaign ### Query Parameters - **campaignIds** (string) - Required - Comma-separated list of campaign IDs. - **advObjectType** (string) - Optional - Type of advertised campaign (e.g., SKU, BANNER). - **state** (string) - Optional - State of the campaign (e.g., CAMPAIGN_STATE_RUNNING, CAMPAIGN_STATE_UNKNOWN). ### Request Example ``` GET /api/client/campaign?campaignIds=52374&advObjectType=SKU&state=CAMPAIGN_STATE_UNKNOWN HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.WyJFTWhVVU...qTz2XXZBv41h4 Host: api-performance.ozon.ru:443 Content-Type: application/json Accept: application/json ``` ### Response #### Success Response (200) - **id** (string) - Unique identifier for the campaign. - **paymentType** (string) - Type of payment for the campaign (CPC, CPM, CPO). - **title** (string) - The name of the campaign. - **state** (string) - The current state of the campaign (e.g., RUNNING, PLANNED, STOPPED). - **advObjectType** (string) - The type of advertised object for the campaign (e.g., SKU, BANNER). - **fromDate** (string) - The start date of the campaign. - **toDate** (string) - The end date of the campaign. - **autostopStatus** (string) - The autostop status of the campaign. - **isAutocreated** (boolean) - Indicates if the campaign was auto-created. - **budget** (string) - The total budget for the campaign. - **dailyBudget** (string) - The daily budget for the campaign. - **weeklyBudget** (string) - The weekly budget for the campaign. - **placement** (string) - The placement of the advertised products. - **productAutopilotStrategy** (string) - The autopilot strategy used for the campaign. - **autopilot** (object) - Information about the campaign's autopilot settings. - **createdAt** (string) - The creation date of the campaign in RFC3339 format. - **updatedAt** (string) - The update date of the campaign in RFC3339 format. - **productCampaignMode** (string) - The mode of the product campaign (AUTO or MANUAL). #### Response Example ```json { "list": [ { "id": "string", "paymentType": "string", "title": "string", "state": "string", "advObjectType": "string", "fromDate": "string", "toDate": "string", "autostopStatus": "string", "isAutocreated": true, "budget": "string", "dailyBudget": "string", "weeklyBudget": "string", "placement": "string", "productAutopilotStrategy": "string", "autopilot": {}, "createdAt": "string", "updatedAt": "string", "productCampaignMode": "string" } ] } ``` #### Error Response (default) - **message** (string) - Description of the error. ``` -------------------------------- ### GET /vendors/statistics/list Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves all requested reports with external traffic analytics. ```APIDOC ## GET /vendors/statistics/list ### Description Retrieves all requested reports with external traffic analytics. ### Method GET ### Endpoint /vendors/statistics/list ``` -------------------------------- ### GET /api/client/campaign Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves a list of campaigns with updated state information. ```APIDOC ## GET /api/client/campaign ### Description Retrieves a list of campaigns. The `state` parameter in the request and the `list.state` parameter in the response have been updated to include `CAMPAIGN_STATE_STOPPED`. ### Method GET ### Endpoint /api/client/campaign ``` -------------------------------- ### POST /campaign/cpc/v2/product Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Creates a new product campaign using the CPC (Cost Per Click) model. The 'autopilot' parameter has been removed, and the default value for 'productCampaignMode' has been changed. Additionally, the description for 'productAutopilotStrategy' has been updated. ```APIDOC ## POST /campaign/cpc/v2/product ### Description Creates a new product campaign using the CPC (Cost Per Click) model. The 'autopilot' parameter has been removed, and the default value for 'productCampaignMode' has been changed. The description for 'productAutopilotStrategy' has also been updated. ### Method POST ### Endpoint /campaign/cpc/v2/product ### Parameters #### Request Body - **autopilot** (any) - Removed. - **productCampaignMode** (string) - The default value has been changed. - **productAutopilotStrategy** (string) - Description has been updated. ### Response #### Success Response (200) - **[response fields]** (object) - Description of the response body structure. ``` -------------------------------- ### GET /api/client/statistics/externallist Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves a list of reports generated via the API. ```APIDOC ## GET /api/client/statistics/externallist ### Description Retrieves a list of reports that have been generated through the API. ### Method GET ### Endpoint /api/client/statistics/externallist ``` -------------------------------- ### Get Campaign Objects Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves objects associated with a specific campaign. ```APIDOC ## GET /api/client/campaign/{campaignId}/objects ### Description Retrieves the objects associated with a specific campaign. ### Method GET ### Endpoint /api/client/campaign/{campaignId}/objects ### Parameters #### Path Parameters - **campaignId** (string) - Required - The ID of the campaign. ``` -------------------------------- ### Get Campaign Expense Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves the expense data for a specific campaign. ```APIDOC ## GET /api/client/statistics/expense ### Description Retrieves the expense data for a specific campaign. ### Method GET ### Endpoint /api/client/statistics/expense ``` -------------------------------- ### POST /api/client/min/sku Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Obtains the minimum bid for products based on SKU. ```APIDOC ## POST /api/client/min/sku ### Description Obtains the minimum bid for products based on SKU. ### Method POST ### Endpoint /api/client/min/sku ``` -------------------------------- ### Get Organization Vendor Tag Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves the UTM_CAMPAIGN tag prefix for an organization. ```APIDOC ## GET /api/client/organisation/vendor_tag ### Description This method returns the prefix for the UTM_CAMPAIGN tag based on the organization ID. ### Method GET ### Endpoint /api/client/organisation/vendor_tag #### Query Parameters - **orgId** (string ) - Required - The organization's identifier. #### Response ##### Success Response (200) - **tag** (string) - The organization's prefix for the UTM tag. ##### Response Example ```json { "tag": "vendor_org_42" } ``` ``` -------------------------------- ### POST /search_promo/bids/recommendation Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Provides recommended bids for products within the search promotion. ```APIDOC ## POST /search_promo/bids/recommendation ### Description Provides recommended bids for products within the search promotion. ### Method POST ### Endpoint /search_promo/bids/recommendation ``` -------------------------------- ### GET /vendors/statistics/{UUID} Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves information about a report with external traffic analytics. ```APIDOC ## GET /vendors/statistics/{UUID} ### Description Retrieves information about a report with external traffic analytics. ### Method GET ### Endpoint /vendors/statistics/{UUID} ### Parameters #### Path Parameters - **UUID** (string) - Required - The unique identifier of the report. ``` -------------------------------- ### Get Video Banner Statistics Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves statistics for video banner impressions. ```APIDOC ## POST /statistics/video ### Description Retrieves statistics for video banner impressions. ### Method POST ### Endpoint /statistics/video ``` -------------------------------- ### POST /campaign/{campaignId}/search_promo/products Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense This method is deprecated and has been removed from the documentation. Use POST /campaign/search_promo/v2/products instead. ```APIDOC ## POST /campaign/{campaignId}/search_promo/products ### Description This method is deprecated and has been removed from the documentation. Use POST /campaign/search_promo/v2/products instead. ### Method POST ### Endpoint /campaign/{campaignId}/search_promo/products ``` -------------------------------- ### POST /campaign/{campaignId}/search_promo/v2/products Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves a list of products associated with order payment for a campaign. ```APIDOC ## POST /campaign/{campaignId}/search_promo/v2/products ### Description Retrieves a list of products associated with order payment for a campaign. ### Method POST ### Endpoint /campaign/{campaignId}/search_promo/v2/products ``` -------------------------------- ### POST /campaign/{campaignId}/products Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Adds products to a campaign. ```APIDOC ## POST /campaign/{campaignId}/products ### Description Adds products to a specified campaign. ### Method POST ### Endpoint /campaign/{campaignId}/products ### Parameters #### Path Parameters - **campaignId** (string) - Required - The ID of the campaign to which products will be added. ### Request Body (Details not provided in source) ### Response (Details not provided in source) ``` -------------------------------- ### POST /api/client/campaign/{campaignId}/products Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Adds products to a campaign. ```APIDOC ## POST /api/client/campaign/{campaignId}/products ### Description Adds products to a specified campaign. The request body includes a new parameter for `bids.targetCir` and an updated description for `bids.bid`. ### Method POST ### Endpoint /api/client/campaign/{campaignId}/products ### Parameters #### Path Parameters - **campaignId** (string) - Required - The ID of the campaign to which products will be added. #### Request Body - **bids.targetCir** (object) - Required - New parameter for target cost per impression. - **bids.bid** (object) - Required - Updated description for the bid parameter. ``` -------------------------------- ### POST /api/client/search_promo/bids/recommendation Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves bid recommendations for search promotions. ```APIDOC ## POST /api/client/search_promo/bids/recommendation ### Description Retrieves bid recommendations for search promotions. ### Method POST ### Endpoint /api/client/search_promo/bids/recommendation ``` -------------------------------- ### Get Campaign Expense Status Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves the status of a campaign expense report by its UUID. ```APIDOC ## GET /api/client/statistics/{UUID} ### Description Retrieves the status of a campaign expense report. ### Method GET ### Endpoint /api/client/statistics/{UUID} ### Parameters #### Path Parameters - **UUID** (string) - Required - Unique identifier of the request. ### Response #### Success Response (200) - **UUID** (string) - Unique identifier of the request for which the check was performed. - **state** (string) - Current state of the request. Enum: "NOT_STARTED", "IN_PROGRESS", "ERROR", "OK". - **createdAt** (string) - Date and time the request was received by the server (UTC). - **updatedAt** (string) - Date and time of the last request state update (UTC). - **request** (object) - Structure of the original request. - **error** (string) - Brief description of the error if the request failed. - **link** (string) - Relative link to the report in CSV format if the request was successful. - **kind** (string) - Type of the requested report. Enum: "STATS", "SEARCH_PHRASES", "ATTRIBUTION", "VIDEO". #### Response Example (200) { "UUID": "0c159c60-ab92-46d9-9a6b-d225dbf5c7b1", "state": "OK", "createdAt": "2020-03-23T19:30:58.264653Z", "updatedAt": "2020-03-23T19:30:58.689007Z", "request": { "attributionDays": "", "campaignId": 1, "campaigns": [ 12558 ], "dateFrom": "2020-03-01", "dateTo": "2020-03-20", "from": "2020-03-01T00:00:00Z", "groupBy": "DATE", "objects": [ ], "to": "2020-03-20T00:00:00Z" }, "link": "string", "kind": "STATS" } #### Error Response (default) Error response for a bad request. ``` -------------------------------- ### POST /campaign/cpm/v2/product Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense This method is deprecated and has been removed from the documentation. ```APIDOC ## POST /campaign/cpm/v2/product ### Description This method is deprecated and has been removed from the documentation. ### Method POST ### Endpoint /campaign/cpm/v2/product ``` -------------------------------- ### Get Campaign Group Information Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves information about a specific group within a campaign. ```APIDOC ## GET /campaign/{campaignId}/group/{groupId} ### Description Retrieves information about a specific group within a campaign. ### Method GET ### Endpoint /campaign/{campaignId}/group/{groupId} ``` -------------------------------- ### Get Statistics List Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves a list of statistics. The response includes a 'kind' field. ```APIDOC ## GET /statistics/list ### Description Retrieves a list of statistics. The response includes a 'kind' field. ### Method GET ### Endpoint /statistics/list ### Response #### Success Response (200) - **kind** (string) - The type or kind of statistic. ``` -------------------------------- ### Add Products to Campaign Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Use this endpoint to add products to a campaign. You can specify the SKU and bid for each product. The bid parameter is optional and will default to a competitive bid if not provided. A campaign can have a maximum of 500 products. ```json { "bids": [ { "sku": "string", "bid": "string", "targetCir": 15, "topPosition": "Топ-20" } ] } ``` -------------------------------- ### GET /campaign/{campaignId}/objects Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Retrieves a list of objects associated with a specific campaign. ```APIDOC ## GET /campaign/{campaignId}/objects ### Description Retrieves a list of objects associated with a specific campaign. ### Method GET ### Endpoint /campaign/{campaignId}/objects ### Parameters #### Path Parameters - **campaignId** (string) - Required - The ID of the campaign. ### Response #### Success Response (200) - **[response fields]** (object) - Description of the response body structure. ``` -------------------------------- ### POST /campaign/cpc/product Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense This method is deprecated and has been removed from the documentation. Use POST /campaign/cpc/v2/product instead. ```APIDOC ## POST /campaign/cpc/product ### Description This method is deprecated and has been removed from the documentation. Use POST /campaign/cpc/v2/product instead. ### Method POST ### Endpoint /campaign/cpc/product ``` -------------------------------- ### POST /campaign/search_promo/v2/bids/set Source: https://docs.ozon.ru/api/performance/?__rr=4#operation/GetCampaignExpense Sets bids for search promotion (v2), clarifying bid application. ```APIDOC ## POST /campaign/search_promo/v2/bids/set ### Description Sets bids for search promotion campaigns using version 2. The parameters `bid`, `bids`, and `SKU*` clarify that the bid applies only to orders or clicks. ### Method POST ### Endpoint /campaign/search_promo/v2/bids/set ### Parameters #### Query Parameters - **bid** (object) - Optional - Bid information, applicable only to orders or clicks. - **bids** (object) - Optional - Bid information, applicable only to orders or clicks. - **SKU*** (object) - Optional - Bid information, applicable only to orders or clicks. ### Request Body (Details not provided in source) ### Response (Details not provided in source) ```