Adthena's RESTful API service

Adthena has a RESTful API service that allows you to programmatically request your account data at scale. We have a unidirectional API, which essentially means that you can request data 'from' Adthena, but not send data 'to' Adthena. 

To use the API you will need an API Key, which can be requested by contacting Adthena Support.

Why should I use the API service to request data?

Anyone receiving regular reports will be familiar with the following processes:

a) log into the application, load each of the pages you have bookmarked, export the data, open each CSV and do something with the data
b) set up Scheduled Reports to be emailed to you daily / weekly / monthly, open each CSV and do something with the data

Both options are fine for a handful of standard reports or if you are pulling data monthly. But if you want to do this more regularly or want to pull a large number of reports, then it will quickly become an arduous task. Receiving reports via our API service provides a faster, easier way to migrate data and with greater flexibility, since you're able to further customise the reports.

Use cases / examples:

1. You want Market Trends data for a list of 12 (rather than 10) competitors.
2. You have 20 Search Term Groups, one for each product category (TVs, Mens Clothing, etc. or Compact Cars, Saloon Cars, etc.) and you want to pull a Market Share report every week for every group of terms, and put this data into 20 worksheets in an Excel workbook.
3. You want to add Market Trends Share of Clicks, Share of Spend, Average Position and Frequency charts to an internal dashboard for non-Adthena users to have visibility.
4. You want to pull a filtered Market Share report each month, then for each competitor in this report request a monthly Search Term Detail report and aggregate these into one CSV.
5. You want to see any adverts containing a '$' from a selection of competitors to track over time how your direct competitors are changing offers and prices in their ad copy over time.
6. You want to pull Search Term Opportunities directly into a Google Sheet so that you can use a Google Script to automatically add them to you Adwords account.

This list could literally have an infinite number of other examples. If you have an idea and you are unsure of how it could be accomplished then let us know so that we can discuss it with you.

I am not technical, where do I start?

Our Adthena's API technical documentation explains how to build out reports using our API service but we do recommend working with an engineer. The best thing to do is think about what you want to achieve and ignore how it would be done. For example, if your end goal is to have a Market Trends widget in Tableau next to your Google Ads, Google Analytics and internal BI data, just think about how you'd like to filter it and the date range. Once you've exported the data, share it with your engineer along with Adthena's API documentation.

Related articles

Adthena's API technical documentation