Common Terms

  • Keyword
  • This is a word or phrase that is searched (for example: "snowboards" or "cheap cameras").
  • Keyword Group
  • This is a group of related keywords. Keyword Groups allow reports to aggregate data on multiple, related keywords as opposed to individual keywords.
  • Campaign
  • This is a collection of Keyword Groups, and it allows reports to aggregate data on multiple, related Keyword Groups. Campaigns are an optional grouping level, so Keyword Groups do not have to be part of a Campaign.
  • Advertiser
  • This is the display URL of an ad (for example, bestbuy.com or walmart.com), and it identifies the organization behind the ad.
  • Competitor Sets
  • These are groups of related Advertisers, and it allows reports to include only Advertisers of interest as opposed to all Advertisers.
  • Data Account
  • This represents an entity that has access to AdGooroo's industry-leading data, and all Data Accounts are represented by a unique ID. This is not to be confused with the user name and password needed to access the API -- one user may have the ability to see multiple Data Accounts.
  • Category
  • This is the classification unit used to relate an Advertiser to a specific Industry.

About Informational Calls

Informational calls allow developers to discover information about Data Accounts and the IDs of many filtering components. Informational calls are not counted against the monthly quota, and they include the following:

Advertisers ServiceList Operations

  • To get an Advertiser's ID based on the Advertiser's name (where AdvertiserName is the display URL of the Advertiser)
  • https://insights.adgooroo.com/api/v3/advertiserids/AdvertiserName

Campaigns ServiceList Operations

  • To get list of all Campaign names and IDs for a Data Account (where 123 is the Data Account ID)
  • https://insights.adgooroo.com/api/v3/campaigns/123
  • To get list of Keyword Groups in a specific Campaign (where 123 is the Data Account ID and 789 is the Campaign ID)
  • https://insights.adgooroo.com/api/v3/campaigns/123/789

Categories ServiceList Operations

  • To get a list of Industry Categories (where 123 is the Data Account ID)
  • https://insights.adgooroo.com/api/v3/taxonomy/categories/123

Competitor Sets ServiceList Operations

  • To get list of Advertisers in a specific Competitors Set (where 123 is the Data Account ID and 789 is the Competitor Set ID)
  • https://insights.adgooroo.com/api/v3/competitorsets/123/789
  • To get list of Competitor Sets for a Data Account (where 123 is the Data Account ID)
  • https://insights.adgooroo.com/api/v3/competitorsets/123

Data Accounts ServiceList Operations

  • To get a list of Data Accounts accessible to an API user name (note: this requires a valid user name and password in the HTTP request header)
  • https://insights.adgooroo.com/api/v3/dataaccounts
  • To get general information about a Data Accounts such as the ID, name, number of targets and license type (where 123 is the Data Account ID)
  • https://insights.adgooroo.com/api/v3/dataaccounts/123/Info

Data ServicesList Operations

  • To get a list of Data Services available to Data Accounts with a SEM license
  • https://insights.adgooroo.com/api/v3/dataservices/SEM
  • To get a list of Data Services available to Data Accounts with an Industry Insight license
  • https://insights.adgooroo.com/api/v3/dataservices/IndustryInsight

Keyword Groups ServiceList Operations

  • To get a list of all Keyword Group name and IDs for a Data Account (where 123 is the Data Account ID)
  • https://insights.adgooroo.com/api/v3/keywordgroups/123
  • To get a list of keywords in a keyword groups (where 123 is the Data Account ID and 789 is the keyword group ID)
  • https://insights.adgooroo.com/api/v3/keywordgroups/123/789/Keywords
  • To get general information about a Keyword Group, such as number of Targets, date created and list of Keywords (where 123 is the Data Account ID and 789 is the Keyword Group ID)
  • https://insights.adgooroo.com/api/v3/keywordgroups/123/789/Info

Quota ServiceList Operations

  • To get remaining monthly API quota points and the total points allowed per month for a specific Data Account (where 123 is the Data Account ID)
  • https://insights.adgooroo.com/api/v3/quotastats/123
  • To get remaining monthly API quota points and the total points allowed per month for all Data Accounts a user can access (note: this requires a valid user name and password in the HTTP request header)
  • https://insights.adgooroo.com/api/v3/quotastats

Regions ServiceList Operations

  • To get a list of available Regions in Industry Insight (where 123 is the Data Account ID)
  • https://insights.adgooroo.com/api/v3/Regions/IndustryInsight/123

Search Engines ServiceList Operations

  • To get a list of available Search Engines in Industry Insight (where 123 is the Data Account ID)
  • https://insights.adgooroo.com/api/v3/SearchEngines/IndustryInsight/123