Version v2 of the Content API is scheduled for sunset on September 30th, 2021. Onboarding to v2 ended on April 30, 2021. To avoid disruptions with your integration, please migrate to v2.1 as soon as possible.

For more information, see Migrating to v2.1 and this blog post.

Published Limits for the Content API for Shopping

The Content API for Shopping imposes quotas and hard limitations on some features. The quotas and limits shown below are provided solely to assist you in developing applications that use the Content API for Shopping. All quotas and limits are subject to elimination, reduction, or change at any time, without notice.

HTTP request limits

The Content API for Shopping endpoint has a 300 queries per second (QPS) limit. This limit is enforced per Google API Console project, not per Merchant Center account. Since this limit is on HTTP requests, not method calls, a custombatch call with multiple method calls will only count as one query for this particular limit. Users that exceed the QPS limit will receive userRateLimitExceeded errors.

Method call quotas

The following limits are the default method call quotas for Merchant Center accounts.

  • Users exceeding the per minute quota will receive quota/request_rate_too_high errors.
  • Users exceeding the per day quota will receive quota/daily_limit_exceeded errors.

If you require a higher quota of a particular method than listed here, please contact us via the Content API for Shopping support forum to request an increase.

Here are some things to keep in mind:

  • The quotas here are per-method. For example, the get method has a separate quota of calls from the update method, though the size of those quotas is the same.
  • Dry runs of a method (i.e., using the dryRun query parameter) are counted separately from normal runs.
  • For quota usage, patch methods count as both a get call and an update call.
  • Each method call within a custombatch call is counted separately against its specific quota.
Service Method Quota per minute Quota per day
Accounts authinfo 600 10,000
all other methods 1,000 10,000
Accounts.labels all methods 1,000 10,000
Accountstatuses all methods 1,000 10,000
Accounttax all methods 1,000 10,000
BuyOnGooglePrograms all methods 100 1,000
Datafeeds fetchnow 10 200
all other methods 500 10,000
Datafeedstatuses all methods 500 10,000
Liasettings requestgmbaccess 500 500
setinventoryverificationcontact 500 500
requestinventoryverification 500 500
all other methods 1,000 10,000
Localinventory all methods 100,000 100,000,000
Orders all methods 10,000 1,000,000
Orders sandbox all Orders methods when using the sandbox environment 40 10,000
Orderinvoices all methods 10,000 1,000,000
Orderreports all methods 10,000 1,000,000
Orderreturns all methods 10,000 1,000,000
Orderreturns.labels all methods 30 10,000
Pos all methods 5,000 1,000,000
Products all methods 60,000 20,000,000
[Promotions][] all methods 50,000 20,000,000
Productstatuses all methods 60000 20,000,000
Regionalinventory all methods 100,000 100,000,000
[Regions][] read methods 250 25,000
write methods 10 25,000
Reports all methods 30 10,000
[RepricingRule][] all methods 10,000 1,000
Settlementreports all methods 10,000 1,000,000
Settlementtransactions all methods 10,000 1,000,000
Shippingsettings all methods 1,000 10,000

Resource representation limits

The following limits describe notable restrictions for certain string values and array fields within the resource representations used in the Content API. These limits are the same for both the Content API and their corresponding feature in the Merchant Center. This list of limits may not be complete, and these limits cannot be extended.

Resource Field Limit
Shippingsettings Shipping services per country (services[]) 20
Shipping groups per shipping service (rateGroups[]) 20
Labels per shipping group (applicableShippingLabels[]) 30
Subtables per shipping group (subtables[]) 100
Number of rows or columns in a single rate table2 150
Length of shipping labels 100

2 The number of rows or columns in a rate table affect the following array fields:

  • Array fields within rowHeaders or columnHeaders:
    • prices[]
    • weights[]
    • numberOfItems[]
    • postalCodeGroupNames[]
    • locations[]
    • rows[]
    • cells[]