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