Ad Insight Service Operations

The Ad Insight service defines the following service operations.

Service Operation	Description	Request Limits
ApplyRecommendations	Apply one or more recommendations.	N/A.
DismissRecommendations	Dismiss one or more recommendations.	N/A.
GetAuctionInsightData	Gets auction insight data for an account, campaigns, ad groups, or keywords.	200 EntityIds
GetAudienceFullEstimation	Gets the audience full estimation.	N/A.
GetAutoApplyOptInStatus	Get the auto-apply recommendations opt-in status for a single account.	The number of distinct recommendation types is no more than 100
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.
GetPerformanceInsightsDetailDataByAccountId	Gets the performance insights detail data for a single account.	N/A.
GetRecommendations	Discover your recommendations.	Returns a maximum of 2,000 Recommendations.
GetTextAssetSuggestionsByFinalUrls	Gets text asset suggestions by final URLs.	5 FinalUrls
RetrieveRecommendations	Retrieve a list of recommendations.	N/A.
SetAutoApplyOptInStatus	Set the auto-apply recommendations opt-in status for a single account.	100 AutoApplyOptInStatusInputs
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
TagRecommendations	Notifies Microsoft Advertising that the specific recommendation to create responsive search ads should be tagged as applied or dismissed.	100 RecommendationsInfo