My favorites | English | Sign in

Faster apps faster - GWT 2.0 with Speed Tracer New!

v2009 Docs | v13 Docs

Documentation for the requested version is not available.Documentation for the requested diff is not available.

AdWords API Rate Sheet

Each AdWords API operation performed consumes a certain number of API units, as specified in the rate sheet below. Costs are charged at a rate of US$0.25 (or local currency equivalent) per thousand API units.

Operations are charged either per call or per item:

  • Per call: Cost is constant. For example, getAccountInfo consumes 1 API unit per call.
  • Per item: Cost is (cost per item × number of items operated upon). For example, a call to updateAdGroupList (which costs 10 API units per item) with an AdGroup array of length 20 would consume 200 API units.

Per-item operations count the items operated upon in one of the following ways:

  • Length of array passed in. For example, addAds counts the Ad objects passed in.
  • Length of the returned array. For example, getClientAccounts counts the strings (login emails) returned. If a request both accepts and returns an array, it counts the items only in the larger array.
  • Number of inner objects operated upon. For example, estimateAdGroupList counts the inner KeywordRequest objects in the AdGroupRequestp[] parameter (each AdGroupRequest has an array of KeywordRequest objects).

If a batch operation (like updateAdGroupList) fails, you are charged only for elements that caused the operation to fail. None of the elements will be processed.

Operation Costs

Because AdWords API v2009 operations are more resource-efficient to process, we've lowered the cost of frequently used operations by approximately 20%.

v2009 Rates

Setting the validateOnly request header to true will reduce the cost of the request to 0.05 API units per item, rounded up to the nearest integer.

Request Cost

CampaignService

get 1 per Campaign
mutate (ADD) 1 per Campaign
mutate (SET) 1 per Campaign

CampaignTargetService

get 1 per TargetList
mutate (SET) 1 per TargetList

CampaignAdExtensionService

get 1 per CampaignAdExtension
mutate (ADD) 1 per CampaignAdExtension
mutate (REMOVE) 1 per CampaignAdExtension

CampaignCriterionService

get 1 per CampaignCriterion
mutate (ADD) 1 per CampaignCriterion
mutate (REMOVE) 1 per CampaignCriterion
mutate (SET) 1 per CampaignCriterion

AdGroupService

get 1 per AdGroup
mutate (ADD) 1 per AdGroup
mutate (SET) 5 per AdGroup
10 per item in v13

AdGroupAdService

get 1 per AdGroupAd
mutate (ADD) 40 per AdGroupAd
50 per item in v13
mutate (REMOVE) 1 per AdGroupAd
mutate (SET) 1 per AdGroupAd

AdGroupAdExtensionService

get 1 per AdExtensionOverride
mutate (ADD) 1 per AdExtensionOverride
mutate (REMOVE) 1 per AdExtensionOverride

AdGroupCriterionService

get 1 per AdGroupCriterion
mutate (ADD) 15 per AdGroupCriterion
20 per item in v13
mutate (REMOVE) 1 per AdGroupCriterion
mutate (SET) 3 per AdGroupCriterion

AdParamService

get 0.1 per AdParam
Rounded up to the nearest integer
mutate (REMOVE) 0.1 per AdParam
Rounded up to the nearest integer
mutate (SET) 0.1 per AdParam
Rounded up to the nearest integer

TargetingIdeaService

get 1 per TargetingIdea
getBulkKeywordIdeas 1 per TargetingIdea

BulkMutateJobService

get 1 per BulkMutateJob
mutate (ADD) 1 per BulkMutateJob
+ (cost of successful operations × .5)
mutate (SET) 1 per BulkMutateJob
+ (cost of successful operations × .5)

InfoService

get1 per ApiUsageInfo

GeoLocationService

get 1 per GeoLocation

Remaining services coming soon

v13 Rates

Operation Rate

AccountService

getAccountInfo 1
getClientAccountInfos 1 per item
getClientAccounts 1 per item
getMccAlerts 1 per item
updateAccountInfo 1

AdGroupService

addAdGroup 1
addAdGroupList 1 per item
getActiveAdGroups 1 per item
getAdGroup 1
getAdGroupList 1 per item
getAdGroupStats 1 per item
getAllAdGroups 1 per item
updateAdGroup 10
updateAdGroupList 10 per item

AdService

addAds 50 per item
checkAds 1 per item
findBusinesses 1 per item
getActiveAds 1 per item
getAd 1
getAdStats 1 per item
getAllAds 1 per item
getMyBusinesses 1 per item
getMyVideos 1 per item
updateAds 1 per item

CampaignService

addCampaign 1
addCampaignList 1 per item
getActiveAdWordsCampaigns 1 per item
getAllAdWordsCampaigns 1 per item
getCampaign 1
getCampaignList 1 per item
getCampaignStats 1 per item
getConversionOptimizerEligibility 1 per item
getOptimizeAdServing 1
getRecommendedBudgetList 1 per item
setOptimizeAdServing 1
updateCampaign 1
updateCampaignList 1 per item

CriterionService

addCriteria 20 per item
checkCriteria 1 per item
getAllCriteria 1 per item
getCampaignNegativeCriteria 1 per item
getCriteria 1 per item
getCriterionStats 1 per item
removeCriteria 1 per item
setCampaignNegativeCriteria 1 per item
updateCriteria 3 per item

InfoService

getFreeUsageQuotaThisMonth 1
getMethodCost 1
getOperationCount 1
getOperationsQuotaThisMonth * 1
getUnitCount 1
getUnitCountForClients 1 per item
getUnitCountForMethod 1
getUsageQuotaThisMonth 1

KeywordToolService

getKeywordsFromSite 20
getKeywordVariations 20

ReportService

deleteReport 1
getAllJobs 1 per item
getGzipReportDownloadUrl 1
getReportDownloadUrl 1
getReportJobStatus 1
scheduleReportJob 500
validateReportJob 1

SiteSuggestionService

getSitesByCategoryName 1
getSitesByDemographics 1
getSitesByTopics 1
getSitesByUrls 1

TrafficEstimatorService

checkKeywordTraffic 1 per item
estimateAdGroupList 20 per item
estimateCampaignList 20 per item
estimateKeywordList 20 per item