---
id: google-cloud-retail
version: "2.11.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# google-cloud-retail — Google Cloud Retail API client library

License: permissive · Maintenance: active · Downloads: 233.9K/mo

## What it is and what it does

This package is the official Python client library for Google Cloud Retail API, part of Vertex AI Search for commerce. It wraps the gRPC-based Retail API to let you call search, browse, and recommendation services from Python code. The library handles authentication, serialization, and network communication with Google's managed retail service.

You use it to integrate personalized product discovery into e-commerce applications—search results ranked by ML models, category browsing with recommendations, and personalized suggestions based on user behavior. It requires an active Google Cloud project with the Retail API enabled and proper authentication credentials; all actual computation and model serving happens on Google's infrastructure, not locally.

Use it for:

- Build a personalized product search endpoint for an e-commerce website using ML-ranked results from Google's Retail API.
- Implement category browse pages with AI-driven product recommendations tailored to individual users.
- Log user interactions (clicks, purchases, views) to the Retail API to improve recommendation models over time.
- Integrate product discovery into a mobile app with search and recommendation features powered by Google's retail ML models.
- Migrate an existing search system to Google Cloud Retail to leverage pre-trained recommendation and ranking models.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides Python bindings to Google Cloud Retail API for implementing personalized search, browse, and recommendation features powered by machine learning models.

Yes. This is an official, actively maintained Google Cloud client library for a managed service. Install it if you are building on Google Cloud Retail or Vertex AI Search for commerce. The low install friction, permissive license, current Python version support (3.10+), and zero known vulnerabilities make it a safe choice. The main constraint is that it requires Google Cloud project setup and API enablement—it is not a standalone library.

## Install

pip install google-cloud-retail
uv add google-cloud-retail
poetry add google-cloud-retail

## Installing google-cloud-retail

Before you install: Low friction installation with a pure-Python wheel. Actively maintained as of 2026-06-22 with recent activity; depends on standard Google Cloud libraries (google-api-core, google-auth, grpcio, proto-plus, protobuf) that are widely used and stable.

License in practice: Licensed under Apache-2.0 (permissive), allowing use in commercial and proprietary projects with minimal restrictions beyond attribution and liability disclaimers.

Quickstart:

pip install google-cloud-retail

from google.cloud import retail_v2

client = retail_v2.SearchServiceClient()
# Configure credentials via GOOGLE_APPLICATION_CREDENTIALS or Application Default Credentials

Requires Python >= 3.10. Requires Google Cloud project setup, billing enabled, Vertex AI Search for commerce API enabled, and authentication credentials (typically via GOOGLE_APPLICATION_CREDENTIALS environment variable or Application Default Credentials).

Verify before relying:

- Whether the package supports async/await patterns for high-concurrency use cases
- Performance characteristics and rate limits for production search and recommendation workloads
- Whether offline or local deployment modes are supported beyond cloud-hosted API calls

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 233.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

google cloud retail api python, vertex ai search commerce, personalized product search, ecommerce recommendations api, ml-powered browse and search, google retail client library, product discovery api, google-cloud, ecommerce-search, ml-recommendations

[View on SkillFed](https://skillfed.io/packages/google-cloud-retail) · [View on PyPI](https://pypi.org/project/google-cloud-retail/)