Published limits

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.

Method call quotas

Default limits

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 need a higher quota for a particular method, contact us directly.

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.
  • 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.
  • Calls count against the quota of the account you're added to as a user:
    • If you're added to the subaccount directly, the subaccount is charged.
    • If you're added the MCA account only, then the MCA account is charged.

Here are the default limits. For the most up-to-date information on the limits for your merchant account, Check your quotas.

Service Method Per minute Per day
accounts

authinfo

Other methods

600

1,000

10,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
cssproducts All methods 5,000 6,000,000
datafeeds

fetchnow

Other methods

10

200

200

10,000

datafeedstatuses All methods 500 10,000
freelistingsprogram All methods 100 1,000
liasettings

requestgmbaccess

setinventoryverificationcontact

setomnichannelexperience

requestinventoryverification

Other methods

500

500

500

500

1,000

500

500

500

500

10,000

localinventory

Read methods

Write methods

40

100,000

40,000

100,000,000

orders All methods 10,000 1,000,000
orders sandbox All methods 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

Read methods

Write methods

1,000

500

10,000

500

productstatuses All methods 60,000 20,000,000
regionalinventory

Read methods

Write methods

40

100,000

40,000

100,000,000

regions

Read methods

Write methods

250

10

25,000

25,000

reports All methods 100 100,000
settlementreports All methods 10,000 1,000,000
settlementtransactions All methods 10,000 1,000,000
shippingsettings All methods 1,000 10,000
shoppingadsprogram All methods 100 1,000
quotas All methods 10 1,000

Check your quotas

Your method call quotas might be different from the defaults listed in the previous section:

  • Your quotas for products and accounts might change automatically based on number of products in your account.
  • You might have an approved quota increase for a specific method.

You can use quotas.list to view the current method call quotas and method usage for your account.

We recommend checking your quotas periodically to ensure you have sufficient quota for your implementation.

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

Shipping groups per shipping service (rateGroups).

Labels per shipping group (applicableShippingLabels).

Subtables per shipping group (subtables).

Number of rows or columns in a single rate table.

Length of shipping labels.

20

20

30

100

150

100

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

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