Google Shopping MCP server

🛍️ Google Shopping API: Products, Prices, and Deals in Clean JSON

The efficient, reliable, and developer-friendly way to use the Google Shopping API.

Actor page: apify.com/johnvc/google-shopping-api-google-shopping-products-prices-deals Input schema: apify.com/johnvc/google-shopping-api-google-shopping-products-prices-deals/input-schema

The Google Shopping API returns Google Shopping product listings for a query as clean, structured JSON: title, merchant source, current and original price, rating, review count, sale tag, delivery terms, and a product ID. Filter by price band, sort order, free shipping, and on-sale status, and localize by country, language, and Google domain. Built for price comparison, deal tracking, competitive monitoring, and AI agent workflows.

Video Walkthrough

Quick Start

Prerequisites

• Python 3.11 or higher
• An Apify account and API key (get a free key here)

1. Clone the repository

git clone https://github.com/johnisanerd/Apify-Google-Shopping-API.git
   cd Apify-Google-Shopping-API

1. Install dependencies with UV

# Install UV if you do not have it:
   curl -LsSf https://astral.sh/uv/install.sh | sh

   # Install project dependencies:
   uv sync

1. Configure your API key

cp .env.example .env
   # Edit .env and add your Apify API key
   # Get your free API key at: https://apify.com?fpr=9n7kx3

1. Run the example

uv run python google-shopping-api-example.py

Alternative: set the API key directly

export APIFY_API_TOKEN="your_api_key_here"
uv run python google-shopping-api-example.py

Why Use This Google Shopping API?

Prices across merchants. Get the products Google Shopping shows for a query, each with its merchant source, current price, and original price when discounted.

Built-in deal signals. Sale tags (for example 16% OFF), original prices, and an on-sale filter make deal tracking straightforward.

Ratings and delivery. Each listing carries a rating, review count, and delivery terms, so you can rank on more than price.

Flexible filtering. Narrow by minprice and maxprice, sort by price, and restrict to free shipping or on-sale items.

Localized. Target by location, country (gl), language (hl), and Google domain, and emulate desktop, tablet, or mobile.

Predictable, pay-per-use pricing. Billing is per page processed (about 40 products each), with a small per-run fee.

Features

Core Capabilities

• Product search with price-band, sort, free-shipping, and on-sale filters
• Merchant source, current and original price, and sale tag per product
• Ratings, review counts, and delivery terms
• Localization by location, country, language, and Google domain
• Pagination with a configurable page cap

Data Quality

• One item per page, each with a shopping_results array
• Formatted price plus numeric extracted_price
• Sale fields (old_price, tag) when a product is discounted
• The available refinement filters returned per page

Usage Examples

Basic search

{
  "q": "wireless headphones",
  "max_pages": 1
}

Price band, on sale, sorted low to high

{
  "q": "4k monitor",
  "min_price": 200,
  "max_price": 500,
  "on_sale": true,
  "sort_by": 1
}

Input Parameters

Shortened. The full README is on GitHub.