My favorites | English | Sign in

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

AdWords API Rate Sheet

Link to this version

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

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.

Note: In AdWords API v2009, all operations are inherently per-item.

Counting Fundamental Items

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.

  • 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).

Note: If a request both accepts and returns an array, it counts the items only in the larger array.

Failed Batch Requests

Batch requests, like updateAdGroupList, are atomic: they either succeed and process all elements, or fail and process none of them. If a request fails, you are charged only for elements that caused the request to fail.

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

Operation Rate

CampaignService

get 1 per item
mutate (ADD) 1 per item
mutate (REMOVE) n/a
mutate (SET) 1 per item

CampaignTargetService

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

CampaignCriterionService

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

AdGroupService

get 1 per item
mutate (ADD) 1 per item
mutate (REMOVE) n/a
mutate (SET) 5 per item
10 per item in v13

AdGroupAdService

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

AdGroupCriterionService

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

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