Feed Changes

What is the change eBay Partner Network is making to feeds?

Currently, we provide a ‘% of Sale Estimate' field for EPN feeds. This field will be renamed “Commissionable” and the values will change from numerical to “Yes” or “No.” 

What does this mean for me?

Partners who use Data Feeds (or Product Feeds), or have logic tied to this field will need to make changes and adjust integration plans. Review the fields to ensure that they understand whether certain items will receive commissions or not

Partners who do not use feeds have no action.

What else should I know about this change?

The current ‘% of Sale Estimate’ field (soon to be the “Commissionable”) is the last field in most EPN feeds. The exception is the following feeds, in which the estimated earning field is the second to last field:

ePN_Data_Feed_Fixed+Price+Items_eBayDE_{meta_categ_id}_X_01.txt.gz

ePN_DE_ELECTRONIC_YYYMMDD_XX.tsv.gz

ePN_DE_FASHION_YYYMMDD_XX.tsv.gz

ePN_DE_HOME_GARDEN_YYYMMDD_XX.tsv.gz

ePN_Data_Feed_Fashion+-+Optimized+Fixed+Price_eBayDE_0_X_XX.txt.gz

Scripting EPN Reports

This document is only for the very tech- and coding-savvy. Here's the information you need to create scripts for our downloadable reports and feeds.

  • Transaction Download Report / TDR: A report that enables you to download the details all of the transactions generated for any program within the eBay Partner Network.

  • Earnings Per Click Report / EPC: At one time, EPC factored into commission rates, but it doesn't anymore. Nevertheless, we've retained the report for those who still like to have this data. It's a very quick way to see how many of the folks clicking through your links are browsers versus buyers.

To script the download of a file, publishers must use their EPN-registered email and password. If they signed up for EPN using an eBay account, they must go to https://epn.ebay.com/login, click Forgot Password, and use this password for scripts. This does not affect their eBay login password. This simply gives them an EPN-specific password.

These should all be POST requests

Downloadable Reports

TDR

Endpoint: https://publisher.ebaypartnernetwork.ebay.com/PublisherReportsTx

 

Parameters:

user_name={USERNAME}

user_password={PASSWORD}

pt={2} --> 2 = Download All Events. pt=1 is Download Earnings Only

tx_fmt={0} --> 0 = text, 1 = text with headers, 2 = Excel

start_date={MM/DD/YYYY}

end_date={MM/DD/YYYY}

advIdProgIdCombo={} --> if left blank, defaults to All Programs. Otherwise, use 1|{PROGRAMID} e.g., for US 1|1 for DE, 1|11

submit_tx=Download

 

EPC

Endpoint: https://publisher.ebaypartnernetwork.ebay.com/PublisherReportsTx

 

Parameters:

user_name={USERNAME}

user_password={PASSWORD}

epc_start_date={MM/DD/YYYY}

epc_end_date={MM/DD/YYYY}

advIdProgIdCombo={} --> if left blank, defaults to All Programs. Otherwise, use 1|{PROGRAMID} e.g., for US 1|1 for DE, 1|11

epc_fmt={0}

submit_epc=Download

 

Examples:

TDR: curl -k -X POST -d "pt=2&start_date=4%2F25%2F2015&&end_date=5%2F10%2F2015&&advIdProgIdCombo=1%7C1&tx_fmt=1&submit_tx=Download&user_name={USERNAME}&user_password={PASSWORD}" https://publisher.ebaypartnernetwork.ebay.com/PublisherReportsTx

 

EPC: curl -k -X POST -d "epc_start_date=11%2F1%2F16&&epc_end_date=11%2F14%2F16&&advIdProgIdCombo=1%7C1&epc_fmt=1&submit_epc=Download&user_name={USERNAME}&user_password={PASSWORD}" https://publisher.ebaypartnernetwork.ebay.com/PublisherReportsTx

 

Feeds

Endpoint: https://epn.ebay.com/downloadFeeds

 

Parameters (note: only one program ID and one category ID per script):

All Items (vertical feeds) -

programs={PROGRAMID}

feedType=full

categories={CATEGORYID}

username={USERNAME}

password={PASSWORD}

 

Example:

curl -l -k -o "anyFileName.gz" https://epn.ebay.com/downloadFeeds --data "programs=1&feedType=full&categories=8&username=USERNAME&password=PASSWORD"

 

New Items By Date (incremental feeds) –

Fixed Price Feeds:

programs={PROGRAMID}

feedType=daily

feedName=1

categories={CATEGORYID}

date={YYYY-MM-DD}

username={USERNAME}

password={PASSWORD}

 

Example:

curl -l -k -o "anyFileName.gz" https://epn.ebay.com/downloadFeeds --data "programs=1&feedType=daily&feedName=1&categories=260&date=YYYY-MM-DD&username=USERNAME&password=PASSWORD"

 

Others (US program – Motors, Motors v1 – Parts & Accessories, Motors v2 – Auctions, Motors v2 – Fixed Price & Classifieds, Fashion – Optimized Fixed Price, Cons Electronic – Optimized Fixed Price and Auction. DE program – Fashion Optimized Fixed Price):

programs={PROGRAMID}

feedType=special

feedName={2}

date={YYYY-MM-DD}

username={USERNAME}

password={PASSWORD}

 

Note: feedName value correlates to where the feed shows in the portal drop-down menu e.g., US “Motors v2 – Auctions” is 3rd in the drop-down, so feedName=3; US “Fashion – Optimized Fixed Price” is 5th in the drop-down, so feedName=5

 

Example:

curl -l -k -o "anyFileName.gz" https://epn.ebay.com/downloadFeeds --data "programs=1&feedType=special&feedName=2&date=YYYY-MM-DD&username=USERNAME&password=PASSWORD"

Troubleshooting Tips

  • Is your account enabled for feeds?

  • Did you use your EPN email and password, not your eBay login credentials?

  • Does the feed yeu are trying to download exist? E.g., All Items feeds only support Fashion, Electronics, and Home & Garden - are you trying to use a different category ID? All Items feeds are only available for US, UK, DE, and IT - are you attempting the download for one of these programs?

  • Are all parameters included in your script?

  • Are you making a POST, not a GET, call?

Last Updated: December 17, 2017