EPN Tools for Item Feeds
Welcome to the Affiliate Data Feeds Quick Start Guide! In this guide we’ll go over the basics of using the RSS Feed Generator, Promotions and Sales Portal, API, and Product Feeds tools.
RSS Feed Generator
Our RSS Feed Generator allows you to customize and generate feeds that are tied to your EPN account. Partners use RSS feeds to access up-to-date listings on eBay without having to use an API. It allows you to pick what you want to show, uses live eBay listings based on your custom search criteria, and allows you to use CSS to add your own style to the output.
To get started, follow the steps below:
- Visit epn.ebay.com
- Select "RSS Feed" from the Tools menu in the top navigation of the EPN Portal
- In the Affiliate Details section:
- Program: pick the country, which determines which eBay site the feed draws from (e.g. for eBay US it will show items from eBay.com, for eBay UK it will show items from eBay.co.uk, etc.)
Feed Type: If you select the eBay US program, you can select "All eBay Inventory" or "Deals". For all other programs, only "All eBay Inventory" is available.
Campaign Name or ID: The Campaign from your account you want associated with the RSS feed
Custom ID (optional): If you use Custom IDs in your account, enter it here.
- In the Ad Content section:
- Search Criteria
- Category Name ID (optional): Limits your search to a single eBay Category. Type a Category ID or click "Find Category ID" and select the Category you want. You can include up to three categories.
- Keywords: The terms you want to include in the search. You can include up to five. If you want the search to include Title and Description you can check the box.
- Search Exclusions
- Category Name ID (optional): You can exclude up to five categories.
- Keywords: You can exclude up to five keywords from the search.
- Search Criteria
- In the Advanced Search section:
- Sort By: Choose how you want the results to be sorted
- Best Match
- Items Ending First
- Newly-Listed Items First
- Price + Shipping: Lowest First
- Price + Shipping: Highest First
- Seller ID(s): Only show items from specific eBay Sellers. If you want to specify more than one Seller ID, separate them in the field with commas and no spaces. You can specify up to ten Seller IDs.
- Price Range: Limit search results that fall below a minimum price and/or go above a maximum price, using whole numbers only.
- Distance: Limit the items that display by distance, in miles, of a postal code you specify
- Show these items: Choose to display All Listings, Auction Only, or BIN (Buy it Now) Only
- Options: Choose to display only items that have Free Shipping, items that allow for PayPal payment, or items from Top Sellers only
- Sort By: Choose how you want the results to be sorted
- Click Generate Link - a preview of the results will appear
- Copy the Feed URL, and use an RSS parser to incorporate the data into your site
Promotions and Sales Portal
Our Promotions and Sales Portal allows you to easily link to the best promotions on eBay. Using simple search functionality, you can quickly find promotions by site, vertical and type.
Start by visiting epn.ebay.com, and then selecting "Promotions and Sales" from the Tools menu in the top navigation of the EPN Portal. Once you’ve decided what to promote, you have two options:
- Promote the entire event by selecting the Promote Event button in the top right-hand corner, or:
- Promote the individual item by selecting the link icon below the specific item
This tool currently supports six programs: United States, United Kingdom, Germany, France, Italy and Spain.
Links created use a default campaign ID located at the top of the page, which can be changed by clicking the Edit button (see below):
Our API (application programming interface) allows developers to access eBay’s data in real-time, including category information and listings, which can be customized to further enhance the shopping experience on your site.
This tool is intended for publishers with a strong programming background, or who have access to developers. You must join the eBay Developers Program to access eBay’s APIs. Our APIs can pull data from any eBay site, and certain calls provide filters which are a powerful way to curate the information returned. The Finding API, for example, allows you to filter returned items by Seller, Condition, FreeShippingOnly, or TopRatedSellerOnly, to name a few.
EPN's available APIs include, but are not limited to:
- Sell APIs
- Buy APIs
- Search APIs
- After Sale APIs
Before you get started, you will need to do the following:
To gain access to EPN’s Product Feeds, you must email Customer Support: firstname.lastname@example.org
Once Product Feeds are enabled for your account, click on the Tools drop-down and select "All Tools". The Product Feeds icon will display in the bottom right corner.
As with APIs, Product Feeds require programming knowledge. They are great for high-volume sites, especially those that cannot work within the 1.5 million API calls per day limit. Many publishers use one or more of these feeds, along with API calls, to provide a highly customized experience for their audience.
EPN offers two types of feeds - “New Items By Date”, which includes all new listings from the previous day, and “All Items”, which include all listings from the previous day. Each Product Feed has details about listings on eBay in a compressed, tab-delimited text file. The columns used in each type of feed will be different, and determined by the type of listings in that feed. For example, the Motors feed will contain a Mileage column, but this column will not be in the Fixed Price feed because most items for sale on eBay do not have any mileage.
eBay has optimized many feeds to display only top-converting items and those with multiple quantities to ensure the best inventory. “All Items” feeds also include a field for itemScore that ranges from 1-1000, where a higher score indicates the item is more likely to be bought.
Please note that the “All Items” feeds can contain millions of listings. Some of the files can be quite large (upwards of 2GB) depending on the type of feed and the volume of items in a category.
Product Feeds contain a significant amount of data, which can be overwhelming. While “All Items” feeds are curated to include items that eBay believes will convert the best, there are also filtering best practices that you can implement. These include, but are not limited to:
- Top Rated Seller: these are listings created by sellers who continuously deliver outstanding customer experiences. They provide same-day or one-day handling, offer a 14-day return policy, create accurate and complete listings, use good quality pictures, and provide great customer service
- Free Shipping: listings that offer this option attract more buyers and get higher placement in search results (New Items By Date feeds: 0 = false, 1 = true; All Items feeds: N = false, Y = true)
- Item Quantity: listings with multiple quantities of items tend to convert better because the item is more likely to be available once your user clicks through. Item Quantity is an example of a field that could be checked against the API before displaying the listing to your users
- Item Score: The higher the score, the more likely the item is to convert
In addition, use your By Tool/Creative reports to see how items promoted from Product Feeds convert.
Please note that the field “% of Sale Estimate” is based on aggregate, typical earnings for the category of the item in question. Additionally, data contained in the Downloadable Feeds may change from the time when the Feeds are created to the time when the Feeds are received.
For help getting started, watch a Product Feeds webinar.
Best Practices for Item Feeds
For more technologically sophisticated partners, using Feeds and APIs is a way to create completely customized experiences. You get access to the full breadth of eBay listing data, which can be used in a myriad of ways to creatively display relevant content to relevant audiences.
It does take technical skill (or access to a developer) to use APIs and/or Feeds to design and implement these customized solutions. If this is something you're interested in, you can follow the links in the sections above to view webinars and read more information.