# Marketing API API

> Marketing API API on Apizie: 69 endpoints (This method retrieves the details for all of the seller's defined campaigns. Request parameters can be used…, This method creates a Promoted Listings ad campaign. A Promoted Listings campaign is the structure into…, This method retrieves the campaigns containing the listing that is specified using either a listing ID, or…, This method retrieves the details of a single campaign, as specified with the campaign_name query parameter.…, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/ecommerce:ebay-sell-marketing/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `ecommerce:ebay-sell-marketing`
- Category: E-commerce
- Status: byok
- Source: https://ebay.com
- Page: https://apizie.tech/api/ecommerce/ebay-sell-marketing
- OpenAPI: https://apizie.tech/api/ecommerce/ebay-sell-marketing/openapi.json

The Marketing API offers two platforms that sellers can use to promote and advertise their products: Promoted Listings is an eBay ad service that lets sellers set up ad campaigns for the products they want to promote.…

## Endpoints

### This method retrieves the details for all of the seller's defined campaigns. Request parameters can be used…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-marketing/get-campaigns` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_name | string | no | Specifies the campaign name. The results are filtered to include only the campaign by the specified name. Note: The results might be null… |
| campaign_status | string | no | Include this filter and input a specific campaign status to retrieve campaigns currently in that state. Note: The results might not… |
| end_date_range | string | no | Specifies the range of a campaign's end date. The results are filtered to include only campaigns with an end date that is within specified… |
| funding_strategy | string | no | Specifies the funding strategy for the campaign. The results will be filtered to only include campaigns with the specified funding model.… |
| limit | string | no | Specifies the maximum number of campaigns to return on a page in the paginated response. Default: 10 Maximum: 500 |
| offset | string | no | Specifies the number of campaigns to skip in the result set before returning the first report in the paginated response. Combine offset… |
| start_date_range | string | no | Specifies the range of a campaign's start date in which to filter the results. The results are filtered to include only campaigns with a… |

### This method creates a Promoted Listings ad campaign. A Promoted Listings campaign is the structure into…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/create-campaign` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### This method retrieves the campaigns containing the listing that is specified using either a listing ID, or…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-marketing/find-campaign-by-ad-reference` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| inventory_reference_id | string | no | The seller's inventory reference ID of the listing to be used to find the campaign in which it is associated. This will either be a… |
| inventory_reference_type | string | no | The type of the seller's inventory reference ID, which is a listing or group of items. You must always pass in both inventory_reference_id… |
| listing_id | string | no | Identifier of the eBay listing associated with the ad. |

### This method retrieves the details of a single campaign, as specified with the campaign_name query parameter.…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-marketing/get-campaign-by-name` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_name | string | yes | The name of the campaign. |

### This method retrieves the details of a single campaign, as specified with the campaign_id query parameter.…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-marketing/get-campaign` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |

### This method deletes the campaign specified by the campaign_id query parameter. Note: You can only delete…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/delete-campaign` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |

### This method retrieves Promoted Listings ads that are associated with listings created with either the…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-marketing/get-ads` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ad_group_ids | string | no | A comma-separated list of ad group IDs. The results will be filtered to only include active ads for these ad groups. Call getAdGroups to… |
| ad_status | string | no | A comma-separated list of ad statuses. The results will be filtered to only include the given statuses of the ad. If none are provided,… |
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |
| limit | string | no | Specifies the maximum number of ads to return on a page in the paginated response. Default: 10 Maximum: 500 |
| listing_ids | string | no | A comma-separated list of listing IDs. The response includes only active ads (ads associated with a RUNNING campaign). The results do not… |
| offset | string | no | Specifies the number of ads to skip in the result set before returning the first ad in the paginated response. Combine offset with the… |

### This method adds a listing to an existing Promoted Listings campaign using a listingId value generated by…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/create-ad-by-listing-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |
| body | object | yes | JSON request body |

### This method retrieves the specified ad from the specified campaign. In the request, supply the campaign_id…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-marketing/get-ad` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ad_id | string | yes | A unique identifier for an ad. This ID is generated when the ad is created. |
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |

### This method removes the specified ad from the specified campaign. Pass the ID of the ad to delete with the…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/delete-ad` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ad_id | string | yes | Identifier of an ad. This ID was generated when the ad was created. |
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |

### This method updates the bid percentage (also known as the "ad rate") for the specified ad in the specified…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/update-bid` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ad_id | string | yes | A unique eBay-assigned ID for an ad that's generated when an ad is created. |
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |
| body | object | yes | JSON request body |

### Note: This method is only available for select partners who have been approved for the eBay Promoted…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-marketing/get-ad-groups` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ad_group_status | string | no | A comma-separated list of ad group statuses. The results will be filtered to only include the given statuses of the ad group. The results… |
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |
| limit | string | no | The number of results, from the current result set, to be returned in a single page. |
| offset | string | no | The number of results that will be skipped in the result set. This is used with the limit field to control the pagination of the output.… |

### Note: This method is only available for select partners who have been approved for the eBay Promoted…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/create-ad-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |
| body | object | yes | JSON request body |

### Note: This method is only available for select partners who have been approved for the eBay Promoted…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-marketing/get-ad-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ad_group_id | string | yes | The ID of the ad group that shall be retrieved. |
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |

### Note: This method is only available for select partners who have been approved for the eBay Promoted…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/update-ad-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ad_group_id | string | yes | The ID of the ad group that shall be updated. |
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |
| body | object | yes | JSON request body |

### Note: This method is only available for select partners who have been approved for the eBay Promoted…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/suggest-bids` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ad_group_id | string | yes | The ID of the ad group containing the keywords for which the bid suggestions will be provided. |
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |
| body | object | yes | JSON request body |

### Note: This method is only available for select partners who have been approved for the eBay Promoted…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/suggest-keywords` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ad_group_id | string | yes | The ID of the ad group for which the keyword suggestions will be provided. |
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |
| body | object | no | JSON request body |

### This method adds multiple listings that are managed with the Inventory API to an existing Promoted Listings…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/bulk-create-ads-by-inventory-reference` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Get a seller's campaign IDs by calling… |
| body | object | yes | JSON request body |

### This method adds multiple listings to an existing Promoted Listings campaign using listingId values…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/bulk-create-ads-by-listing-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get a seller's campaign IDs by calling… |
| body | object | yes | JSON request body |

### Note: This method is only available for select partners who have been approved for the eBay Promoted…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/bulk-create-keyword` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |
| body | object | yes | JSON request body |

### This method works with listings created with the Inventory API . The method deletes a set of ads, as…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/bulk-delete-ads-by-inventory-reference` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get a seller's campaign IDs by calling… |
| body | object | yes | JSON request body |

### This method works with listing IDs created with either the Trading API or the Inventory API . The method…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/bulk-delete-ads-by-listing-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get a seller's campaign IDs by calling… |
| body | object | yes | JSON request body |

### This method works with listings created with either the Trading API or the Inventory API . The method…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/bulk-update-ads-bid-by-inventory-reference` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get a seller's campaign IDs by calling… |
| body | object | yes | JSON request body |

### This method works with listings created with either the Trading API or the Inventory API . The method…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/bulk-update-ads-bid-by-listing-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get a seller's campaign IDs by calling… |
| body | object | yes | JSON request body |

### Note: This method is only available for select partners who have been approved for the eBay Promoted…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/bulk-update-ads-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |
| body | object | yes | JSON request body |

### Note: This method is only available for select partners who have been approved for the eBay Promoted…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/bulk-update-ads-status-by-listing-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |
| body | object | yes | JSON request body |

### Note: This method is only available for select partners who have been approved for the eBay Promoted…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/bulk-update-keyword` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |
| body | object | yes | JSON request body |

### This method clones (makes a copy of) the specified campaign's campaign criterion . The campaign criterion is…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/clone-campaign` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. This ID is the campaign ID of the campaign… |
| body | object | yes | JSON request body |

### This method adds a listing that is managed with the Inventory API to an existing Promoted Listings campaign.…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/create-ads-by-inventory-reference` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |
| body | object | yes | JSON request body |

### This method works with listings that are managed with the Inventory API . The method deletes ads using a…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/delete-ads-by-inventory-reference` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |
| body | object | yes | JSON request body |

### This method ends an active ( RUNNING ) or paused campaign. Specify the campaign you want to end by supplying…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/end-campaign` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |

### This method retrieves Promoted Listings ads associated with listings that are managed with the Inventory API…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-marketing/get-ads-by-inventory-reference` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |
| inventory_reference_id | string | yes | The inventory reference ID associated with the ad you want returned. A seller's inventory reference ID is the ID of either a listing or… |
| inventory_reference_type | string | yes | The type of the inventory reference ID. Set this value to either INVENTORY_ITEM (a single listing) or INVENTORY_ITEM_GROUP (a… |

### Note: This method is only available for select partners who have been approved for the eBay Promoted…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-marketing/get-keywords` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ad_group_ids | string | no | A comma-separated list of ad group IDs. This query parameter is used if the seller wants to retrieve keywords from one or more specific ad… |
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |
| keyword_status | string | no | A comma-separated list of keyword statuses. The results will be filtered to only include the given statuses of the keyword. If none are… |
| limit | string | no | Specifies the maximum number of results to return on a page in the paginated response. Default: 10 Maximum: 500 |
| offset | string | no | Specifies the number of results to skip in the result set before returning the first report in the paginated response. Combine offset with… |

### Note: This method is only available for select partners who have been approved for the eBay Promoted…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/create-keyword` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |
| body | object | yes | JSON request body |

### Note: This method is only available for select partners who have been approved for the eBay Promoted…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-marketing/get-keyword` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |
| keyword_id | string | yes | This path parameter is used to identify the keyword to retrieve. |

### Note: This method is only available for select partners who have been approved for the eBay Promoted…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/update-keyword` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |
| keyword_id | string | yes | A unique eBay-assigned ID that is generated when a keyword is created. |
| body | object | yes | JSON request body |

### This method pauses an active (RUNNING) campaign. You can restart the campaign by calling resumeCampaign , as…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/pause-campaign` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |

### This method resumes a paused campaign, as long as its end date is in the future. Supply the campaign_id for…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/resume-campaign` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |

### Note: This method is only available for select partners who have been approved for the eBay Promoted…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-marketing/suggest-items` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |
| category_ids | string | no | Specifies the category ID that is used to limit the results. This refers to an exact leaf category (the lowest level in that category and… |
| limit | string | no | Specifies the maximum number of campaigns to return on a page in the paginated response. If no value is specified, the default value is… |
| offset | string | no | Specifies the number of campaigns to skip in the result set before returning the first report in the paginated response. Combine offset… |

### This method updates the ad rate strategy for an existing Promoted Listings Standard (PLS) rules-based ad…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/update-ad-rate-strategy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |
| body | object | yes | JSON request body |

### Note: This method is only available for select partners who have been approved for the eBay Promoted…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/update-campaign-budget` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |
| body | object | yes | JSON request body |

### This method can be used to change the name of a campaign, as well as modify the start or end dates. Specify…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/update-campaign-identification` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. Note: You can retrieve the campaign IDs for a… |
| body | object | yes | JSON request body |

### This call downloads the report as specified by the report_id path parameter. Call createReportTask to…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-marketing/get-report` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| report_id | string | yes | The unique ID of the Promoted Listings report you want to get. This ID is generated by eBay when you run a report task with a call to… |

### This call retrieves information that details the fields used in each of the Promoted Listings reports. Use…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-marketing/get-report-metadata` (byok)

### This call retrieves metadata that details the fields used by a specific Promoted Listings report type. Use…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-marketing/get-report-metadata-for-report-type` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| report_type | string | yes | The name of the report type whose metadata you want to retrieve. Tip: For details about available report types and their descriptions,… |

### This method returns information on all the existing report tasks related to a seller. Use the…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-marketing/get-report-tasks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | string | no | Specifies the maximum number of report tasks to return on a page in the paginated response. Default: 10 Maximum: 500 |
| offset | string | no | Specifies the number of report tasks to skip in the result set before returning the first report in the paginated response. Combine offset… |
| report_task_statuses | string | no | This parameter filters the returned report tasks by their status. Supply a comma-separated list of the report statuses you want returned.… |

### Note: Using multiple funding models in one report is deprecated. If multiple funding models are used, a…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/create-report-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### This call returns the details of a specific Promoted Listings report task, as specified by the…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-marketing/get-report-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| report_task_id | string | yes | A unique eBay-assigned ID for the report task that's generated when the report task is created by a call to createReportTask . |

### This call deletes the report task specified by the report_task_id path parameter. This method also deletes…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/delete-report-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| report_task_id | string | yes | A unique eBay-assigned ID for the report task that's generated when the report task is created by a call to createReportTask . |

### Note: This method is only available for select partners who have been approved for the eBay Promoted…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/bulk-create-negative-keyword` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Note: This method is only available for select partners who have been approved for the eBay Promoted…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/bulk-update-negative-keyword` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### This method creates an item price markdown promotion (know simply as a "markdown promotion") where a…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/create-item-price-markdown-promotion` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### This method returns the complete details of the item price markdown promotion that's indicated by the…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-marketing/get-item-price-markdown-promotion` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| promotion_id | string | yes | This path parameter takes a concatenation of the ID of the promotion you want to get plus the marketplace ID on which the promotion is… |

### This method updates the specified item price markdown promotion with the new configuration that you supply…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/update-item-price-markdown-promotion` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| promotion_id | string | yes | This path parameter takes a concatenation of the ID of the promotion you want to update plus the marketplace ID on which the promotion is… |
| body | object | no | JSON request body |

### This method deletes the item price markdown promotion specified by the promotion_id path parameter. Call…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/delete-item-price-markdown-promotion` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| promotion_id | string | yes | This path parameter takes a concatenation of the ID of the promotion you want to delete plus the marketplace ID on which the promotion is… |

### This method creates an item promotion , where the buyer receives a discount when they meet the buying…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/create-item-promotion` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### This method returns the complete details of the threshold promotion specified by the promotion_id path…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-marketing/get-item-promotion` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| promotion_id | string | yes | This path parameter takes a concatenation of the ID of the promotion you want to retrieve plus the marketplace ID on which the promotion… |

### This method updates the specified threshold promotion with the new configuration that you supply in the…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/update-item-promotion` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| promotion_id | string | yes | This path parameter takes a concatenation of the ID of the promotion you want to update plus the marketplace ID on which the promotion is… |
| body | object | no | JSON request body |

### This method deletes the threshold promotion specified by the promotion_id path parameter. Call getPromotions…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/delete-item-promotion` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| promotion_id | string | yes | This path parameter takes a concatenation of the ID of the promotion you want to delete plus the marketplace ID on which the promotion is… |

### Note: This method is only available for select partners who have been approved for the eBay Promoted…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-marketing/get-negative-keywords` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ad_group_ids | string | no | A comma-separated list of ad group IDs. This query parameter is used if the seller wants to retrieve the negative keywords from one or… |
| campaign_ids | string | no | A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created. This query parameter is used if the seller… |
| limit | string | no | The number of results, from the current result set, to be returned in a single page. |
| negative_keyword_status | string | no | A comma-separated list of negative keyword statuses. This query parameter is used if the seller wants to filter the search results based… |
| offset | string | no | The number of results that will be skipped in the result set. This is used with the limit field to control the pagination of the output.… |

### Note: This method is only available for select partners who have been approved for the eBay Promoted…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/create-negative-keyword` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Note: This method is only available for select partners who have been approved for the eBay Promoted…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-marketing/get-negative-keyword` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| negative_keyword_id | string | yes | The unique identifier for the negative keyword. This value is returned in the Location response header from the createNegativeKeyword… |

### Note: This method is only available for select partners who have been approved for the eBay Promoted…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/update-negative-keyword` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| negative_keyword_id | string | yes | The unique identifier for the negative keyword. This value is returned in the Location response header from the createNegativeKeyword… |
| body | object | yes | JSON request body |

### This method returns a list of a seller's undeleted promotions. The call returns up to 200…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-marketing/get-promotions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | string | no | Specifies the maximum number of promotions returned on a page from the result set. Default: 200 Maximum: 200 |
| marketplace_id | string | yes | The eBay marketplace ID of the site where the promotion is hosted. Valid values: EBAY_AU = Australia EBAY_DE = Germany EBAY_ES = Spain… |
| offset | string | no | Specifies the number of promotions to skip in the result set before returning the first promotion in the paginated response. Combine… |
| promotion_status | string | no | Specifies the promotion state by which you want to filter the results. The response contains only those promotions that match the state… |
| promotion_type | string | no | Filters the returned promotions based on their campaign promotion type. Specify one of the following values to indicate the promotion type… |
| q | string | no | A string consisting of one or more keywords . eBay filters the response by returning only the promotions that contain the supplied… |
| sort | string | no | Specifies the order for how to sort the response. If you precede the supplied value with a dash, the response is sorted in reverse order.… |

### This method returns the set of listings associated with the promotion_id specified in the path parameter.…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-marketing/get-listing-set` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | string | no | Specifies the maximum number of promotions returned on a page from the result set. Default: 200 Maximum: 200 |
| offset | string | no | Specifies the number of promotions to skip in the result set before returning the first promotion in the paginated response. Combine… |
| promotion_id | string | yes | This path parameter takes a concatenation of the ID of the promotion you want to get plus the marketplace ID on which the promotion is… |
| q | string | no | Reserved for future use. |
| sort | string | no | Specifies the order in which to sort the associated listings in the response. If you precede the supplied value with a dash, the response… |
| status | string | no | This query parameter applies only to markdown promotions. It filters the response based on the indicated status of the promotion.… |

### This method pauses a currently-active (RUNNING) threshold promotion and changes the state of the promotion…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/pause-promotion` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| promotion_id | string | yes | This path parameter takes a concatenation of the ID of the promotion you want to pause plus the marketplace ID on which the promotion is… |

### This method restarts a threshold promotion that was previously paused and changes the state of the promotion…
`POST https://apizie.tech/v1/ecommerce:ebay-sell-marketing/resume-promotion` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| promotion_id | string | yes | This path parameter takes a concatenation of the ID of the promotion you want to resume plus the marketplace ID on which the promotion is… |

### This method generates a report that lists the seller's running, paused, and ended promotions for the…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-marketing/get-promotion-reports` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | string | no | Specifies the maximum number of promotions returned on a page from the result set. Default: 200 Maximum: 200 |
| marketplace_id | string | yes | The eBay marketplace ID of the site for which you want the promotions report. Valid values: EBAY_AU = Australia EBAY_DE = Germany EBAY_ES… |
| offset | string | no | Specifies the number of promotions to skip in the result set before returning the first promotion in the paginated response. Combine… |
| promotion_status | string | no | Limits the results to the promotions that are in the state specified by this query parameter. Valid values: DRAFT SCHEDULED RUNNING PAUSED… |
| promotion_type | string | no | Filters the returned promotions in the report based on their campaign promotion type. Specify one of the following values to indicate the… |
| q | string | no | A string consisting of one or more keywords . eBay filters the response by returning only the promotions that contain the supplied… |

### This method generates a report that summarizes the seller's promotions for the specified eBay marketplace.…
`GET https://apizie.tech/v1/ecommerce:ebay-sell-marketing/get-promotion-summary-report` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| marketplace_id | string | yes | The eBay marketplace ID of the site you for which you want a promotion summary report. Valid values: EBAY_AU = Australia EBAY_DE = Germany… |

## Example
```
curl "https://apizie.tech/v1/ecommerce:ebay-sell-marketing/get-campaigns" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Marketing API API?
Create a free Apizie key, then send GET https://apizie.tech/v1/ecommerce:ebay-sell-marketing/get-campaigns with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Marketing API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Marketing API itself also needs your own key from ebay.com.

### Can AI agents use the Marketing API API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key ecommerce:ebay-sell-marketing.

### What is the status of the Marketing API API?
Needs your own provider key (bring your own key)