PHPackages                             macropage/sdk-ebay-rest-marketing - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [HTTP &amp; Networking](/categories/http)
4. /
5. macropage/sdk-ebay-rest-marketing

ActiveLibrary[HTTP &amp; Networking](/categories/http)

macropage/sdk-ebay-rest-marketing
=================================

&lt;p&gt;The &lt;i&gt;Marketing API &lt;/i&gt; offers two platforms that sellers can use to promote and advertise their products:&lt;/p&gt; &lt;ul&gt;&lt;li&gt;&lt;b&gt;Promoted Listings&lt;/b&gt; is an eBay ad service that lets sellers set up &lt;i&gt;ad campaigns &lt;/i&gt; for the products they want to promote. eBay displays the ads in search results and in other marketing modules as &lt;b&gt;SPONSORED&lt;/b&gt; listings. If an item in a Promoted Listings campaign sells, the seller is assessed a Promoted Listings fee, which is a seller-specified percentage applied to the sales price. For complete details, refer to the &lt;a href="/api-docs/sell/static/marketing/pl-landing.html"&gt;Promoted Listings playbook&lt;/a&gt;.&lt;/li&gt;&lt;li&gt;&lt;b&gt;Promotions Manager&lt;/b&gt; gives sellers a way to offer discounts on specific items as a way to attract buyers to their inventory. Sellers can set up discounts (such as "20% off" and other types of offers) on specific items or on an entire customer order. To further attract buyers, eBay prominently displays promotion &lt;i&gt;teasers&lt;/i&gt; throughout buyer flows. For complete details, see &lt;a href="/api-docs/sell/static/marketing/promotions-manager.html"&gt;Promotions Manager&lt;/a&gt;.&lt;/li&gt;&lt;/ul&gt; &lt;p&gt;&lt;b&gt;Marketing reports&lt;/b&gt;, on both the Promoted Listings and Promotions Manager platforms, give sellers information that shows the effectiveness of their marketing strategies. The data gives sellers the ability to review and fine tune their marketing efforts.&lt;/p&gt;&lt;p&gt;&lt;b&gt;Store Email Campaign&lt;/b&gt; allows sellers to create and send email campaigns to customers who have signed up to receive their newsletter. For more information on email campaigns, see &lt;a href="/api-docs/sell/static/marketing/store-email-campaigns.html#email-campain-types" target="\_blank"&gt;Store Email Campaigns&lt;/a&gt;.&lt;p class="tablenote"&gt;&lt;b&gt;Important!&lt;/b&gt; Sellers must have an active eBay Store subscription, and they must accept the &lt;b&gt;Terms and Conditions&lt;/b&gt; before they can make requests to these APIs in the Production environment. There are also site-specific listings requirements and restrictions associated with these marketing tools, as listed in the "requirements and restrictions" sections for &lt;a href="/api-docs/sell/marketing/static/overview.html#PL-requirements"&gt;Promoted Listings&lt;/a&gt; and &lt;a href="/api-docs/sell/marketing/static/overview.html#PM-requirements"&gt;Promotions Manager&lt;/a&gt;.&lt;/p&gt; &lt;p&gt;The table below lists all the Marketing API calls grouped by resource.&lt;/p&gt;

v1.21.0.4(1y ago)017unlicensePHPPHP ^7.4 || ^8.0

Since Apr 17Pushed 1y ago1 watchersCompare

[ Source](https://github.com/michabbb/sdk-ebay-rest-marketing)[ Packagist](https://packagist.org/packages/macropage/sdk-ebay-rest-marketing)[ Docs](https://openapi-generator.tech)[ RSS](/packages/macropage-sdk-ebay-rest-marketing/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (4)Dependencies (4)Versions (5)Used By (0)

> ### Important Notice
>
> [](#important-notice)
>
> Before using this SDK, you **must** modify the OpenAPI specification file (`sell_marketing_v1_oas3.yaml`) to remove duplicate `Content-Type` headers. Run the `fix_openapi_schema_file` script to apply these changes and review the fixed file carefully. If the output is correct, update the original specification file accordingly.

sdk-ebay-rest-marketing
=======================

[](#sdk-ebay-rest-marketing)

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. eBay displays the ads in search results and in other marketing modules as **SPONSORED** listings. If an item in a Promoted Listings campaign sells, the seller is assessed a Promoted Listings fee, which is a seller-specified percentage applied to the sales price. For complete details, refer to the [Promoted Listings playbook](\"/api-docs/sell/static/marketing/pl-landing.html\").
- **Promotions Manager** gives sellers a way to offer discounts on specific items as a way to attract buyers to their inventory. Sellers can set up discounts (such as \\"20% off\\" and other types of offers) on specific items or on an entire customer order. To further attract buyers, eBay prominently displays promotion *teasers* throughout buyer flows. For complete details, see [Promotions Manager](\"/api-docs/sell/static/marketing/promotions-manager.html\").

**Marketing reports**, on both the Promoted Listings and Promotions Manager platforms, give sellers information that shows the effectiveness of their marketing strategies. The data gives sellers the ability to review and fine tune their marketing efforts.

**Store Email Campaign** allows sellers to create and send email campaigns to customers who have signed up to receive their newsletter. For more information on email campaigns, see [Store Email Campaigns](\"/api-docs/sell/static/marketing/store-email-campaigns.html#email-campain-types\").

**Important!** Sellers must have an active eBay Store subscription, and they must accept the **Terms and Conditions** before they can make requests to these APIs in the Production environment. There are also site-specific listings requirements and restrictions associated with these marketing tools, as listed in the \\"requirements and restrictions\\" sections for [Promoted Listings](\"/api-docs/sell/marketing/static/overview.html#PL-requirements\") and [Promotions Manager](\"/api-docs/sell/marketing/static/overview.html#PM-requirements\").

The table below lists all the Marketing API calls grouped by resource.

Installation &amp; Usage
------------------------

[](#installation--usage)

### Requirements

[](#requirements)

PHP 7.4 and later. Should also work with PHP 8.0.

### Composer

[](#composer)

To install the bindings via [Composer](https://getcomposer.org/), add the following to `composer.json`:

```
{
  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/macropage/sdk-ebay-rest-marketing.git"
    }
  ],
  "require": {
    "macropage/sdk-ebay-rest-marketing": "*@dev"
  }
}
```

Then run `composer install`

### Manual Installation

[](#manual-installation)

Download the files and include `autoload.php`:

```