AdGooroo API
AdGooroo's API is our industry-leading data in your reports. It is a read-only RESTful service that allows developers to access and customize AdGooroo’s Industry Insight and SEM data. The API also has a long list of informational calls to obtain metadata about Data Accounts, Keywords, Keyword Groups, Campaigns, and Competitor Sets. Data can be returned in either an XML or JSON format.
FAQsUsage Limits and Requirements
To access the API, a valid API user name, password and API key are required. The amount of data consumed is limited by a monthly quota. Informational calls, such as the list of Keywords in a Keyword Group, do not impact the quota. Only accessing data services requires quota points, and one quota point is charged for each row return. Quota points are allotted on a monthly basis, and at the beginning of each month the points reset. Quota stats can be retrieved from the API (there is no charge against your quota points for this call). Quota point stats can also be viewed from this site with a valid API login.
Informational Calls DocumentationHow to Access the API
The API is a read-only RESTful service, so it only responds to HTTP GET requests. POST, PUT and DELETE are not recognized verbs. Also, all calls to the API require HTTPS (SSL). The request header requires an API user name, password and API key. The header can also specify a format for the returned data of either JSON or XML (defaults to JSON). When calling a Data Service, data filters are supplied in the URL. The example code demonstrates the structure of the header as well as the format for data filters.
About Data Services
Data Services provide access to AdGooroo’s industry-leading data. Each service returns a Data Table that developers can use for their custom reports. The Data Services Documentation includes the fields returned and required and optional data filters for each Data Service.
About Data Filters
Data Filters are used to more clearly define the data to return from Data Services. This can include limiting the number of rows returned to setting set start and end dates, search engines, regions, Competitor Sets, Keyword Groups and so on. Data Filters are defined in the URL of the HTTP request. A glossary of Data Filters is available with the Data Services documentation, and the example code demonstrates adding data filters to request URLs.
About Informational Calls
Informational calls allow developers to discover information about Data Accounts and the IDs of many filtering components. For example, they can be used to discover Keyword Group IDs, Competitor Set IDs, and Campaign IDs. Informational calls are useful when configuring Data Filters, and making informational calls does not impact the Data Account’s monthly quota. They do, however, require a valid user name, password and API key.