Ad Insight Service Operations

The Ad Insight service defines the following service operations.

Service Operation Description Request Limits
GetAuctionInsightData Gets auction insight data for an account, campaigns, ad groups, or keywords. 200 EntityIds
GetBidLandscapeByAdGroupIds Given a list of existing ad groups, this operation returns for each a list of suggested bids and estimated performance statistics. 1,000 AdGroupBidLandscapeInput
GetBidLandscapeByKeywordIds Given a list of existing keywords, this operation returns for each a list of suggested bids and estimated performance statistics from 1 to 7 days. 1,000 KeywordIds
GetBidOpportunities Gets the keyword bid opportunities of the specified ad group. 1 AdGroupId
1 CampaignId
GetBudgetOpportunities Gets the campaign budget opportunities of the specified campaign. 1 CampaignId
GetDomainCategories Gets the list of categories available for the website domain and language. 1 DomainName
1 Language
GetEstimatedBidByKeywordIds Gets the estimated bid value of one or more keywords - specified by keyword identifier - that could have resulted in an ad appearing in the targeted position in the search results in the last 7 days. 1,000 KeywordIds
GetEstimatedBidByKeywords Gets the estimated bid value of one or more keywords that could result in an ad appearing in the targeted position in the search results. 1 AdGroupId
1,000 Keywords
GetEstimatedPositionByKeywordIds Gets the estimated position in the search results if the specified bid value had been used for the keywords in the last 7 days. 1,000 KeywordIds
GetEstimatedPositionByKeywords Gets the estimated position in the search results if the specified bid value would be used for the specified keywords. 1 AdGroupId
1,000 Keywords
GetHistoricalKeywordPerformance Gets the historical performance of the normalized search term. 1,000 Keywords
GetHistoricalSearchCount Gets the number of times the normalized term was used in a search during the specified time period. 1,000 Keywords
GetKeywordCategories Gets the keyword categories to which the specified keywords belong. 1,000 Keywords
5 MaxCategories
GetKeywordDemographics Gets the age and gender of users who have searched for the specified keywords. 1,000 Keywords
GetKeywordIdeaCategories Gets the list of keyword idea categories. Not applicable
GetKeywordIdeas Gets the list of keyword ideas. Maximum 1 of each SearchParameter type within SearchParameters
GetKeywordLocations Gets the geographical locations of users who have searched for the specified keywords. 1,000 Keywords
10 MaxLocations
GetKeywordOpportunities Gets a list of keyword suggestions that are relevant to the specified ad group. 1 AdGroupId
1 CampaignId
GetKeywordTrafficEstimates Provides traffic estimates for keywords e.g., average CPC, average position, clicks, CTR, impressions, and total cost. N/A.
SuggestKeywordsForUrl Suggests the possible keywords for the content located at the specified URL. 200 MaxKeywords
1 Url
SuggestKeywordsFromExistingKeywords Suggests keywords that could perform better than the specified keywords. 1,000 Keywords
100 MaxSuggestionsPerKeyword