Quotas and limits

Stay organized with collections Save and categorize content based on your preferences.

This page provides information about Retail API quotas and limits.

Default quotas

By default, your project has the following Retail quotas:

Quota Value
User event writes per minute 60,000
User event imports per minute 100
User event writes per user per minute 240
User event reads per minute 300
Product writes per minute 12,000
Product imports per minute 100
Product reads per minute 300
Predictions per minute 60,000
Predictions per minute for a specific user 60,000
Searches per minute 300
Completion read per minute 300
Total user events 40,000,000,000
Total products (search not enabled) 40,000,000
Total products (search enabled) 4,000,000
Total tags
(sum of per-product tag counts, not unique tags)
Pending Cloud Storage import long running operations 300
Pending BigQuery import long running operations 100
Pending Merchant Center import long running operations 10
Concurrent active models 10
Total models (active and paused) 20
Total placements 100
Total Controls 100

Check your quotas

To check the current quotas for Retail resources in your project, go to the Quotas page in the Google Cloud console and select Retail in the Services dropdown list.

You can see recent quota usage by going to the API Dashboard, selecting the Retail API, and opening the Quotas tab.

Increase your quotas

As your use of Google Cloud expands over time, your quotas can increase accordingly. If you expect a notable upcoming increase in usage, you should make your request a few days in advance to ensure your quotas are adequately sized.

  1. In the Quotas page, select Retail in the Services dropdown list.

  2. Select the quotas you want to change.

  3. Click EDIT QUOTAS.

  4. Fill out your name, email, and phone number and click Next.

  5. Fill in your quota request and click Submit request.

You will receive a response from the Retail team within 48 hours of your request.


The Retail API enforces the following limits:

  • You can start up to 5 model operations per minute. Limited model operations include creation, deletion, pause, and resume.

  • Your site can have up to 250,000 user event writes per visitor ID or user ID per week.

  • Your site can have up to 10,000 product writes per product ID per week.