Google Shopping Ads Data: Track Sponsored Product Listings

The Google Shopping API may return product cards with a sponsored flag. Use a supported ad indicator to count labeled ads; leave the status unknown when it is not supplied. Google’s free listings guidance distinguishes unpaid product listings from Shopping ads.

This guide shows how to read a sponsored indicator and the limits of inferring ad coverage from product cards. A saved August 2026 ten-card example had all cards marked sponsored, but one sample cannot establish the mix on other queries or prove current endpoint availability.

Table of Contents

• Why track sponsored product listings
• Reading the sponsored flag
• Working Python: count and analyze ads
• Honest limits of ad tracking
• What it costs
• FAQ

Why track sponsored product listings

Product searches can show both Shopping ads and free listings. Merchant, ordering and displayed price are useful observations, but classify an ad only when a reliable label or returned indicator supports it.

Three uses pop up constantly:

• Share of voice. Are you (or a competitor) present in the product rail for a keyword, and at what position?
• Merchant mix. Who is buying the slots in your category — big marketplaces, brands, or resellers?
• Price context. The price on a paid listing is the price a shopper is actually offered. That is the price worth benchmarking.

All three need the same raw material: a clean list of listings with their ad status, price, and merchant. That is exactly what a shopping API returns.

Reading the sponsored flag

Here is a saved August 4, 2026 sample item for a sony headphones query. Note the Google-style field names — link, source, product_rating:

{
  "position": 1,
  "title": "Sony WH-1000XM6",
  "link": "https://www.bestbuy.com/product/sony-wh1000xm6-...",
  "source": "Best Buy",
  "price": "$299.99",
  "currency": "USD",
  "thumbnail": "https://img.example.com/products/wh1000xm6.jpg",
  "product_rating": null,
  "product_reviews": null,
  "sponsored": true,
  "snippet": "These are ideal for users seeking top-tier noise cancellation..."
}

The sponsored field is true in this saved sample. Classify only cards with a supported ad indicator; otherwise mark status unknown. Report the observed split rather than assuming one.

Working Python: count and analyze ads

Here is a complete, runnable script. It pulls listings for a query, filters the sponsored ones, and prints an ad table plus a merchant breakdown.

Replace sk_live_your_key with your key from the dashboard.

import requests
from collections import Counter

API_KEY = "sk_live_your_key"
BASE_URL = "https://apiserpent.com/api/shopping"

def shopping_listings(query, num=10):
    resp = requests.get(
        BASE_URL,
        params={"q": query, "engine": "google", "num": num},
        headers={"X-API-Key": API_KEY},
        timeout=60,
    )
    resp.raise_for_status()
    return resp.json()["results"]["shopping"]

def money(item):
    return item.get("price") or "n/a"

products = shopping_listings("nike running shoes")
ads = [p for p in products if p.get("sponsored")]
organic = [p for p in products if not p.get("sponsored")]

print(f"listings: {len(products)} | sponsored: {len(ads)} | non-sponsored: {len(organic)}")
print()
print("Sponsored listings")
print("-" * 74)
for p in ads:
    print(f"#{p['position']:>2} {p['title'][:32]:32} {money(p):10} {p['source'][:20]:20}")

print()
print("Merchants in the sponsored rail")
for merchant, count in Counter(p.get("source") for p in ads).most_common():
    print(f"  {merchant or 'unknown':22} {count}")

Run it and you get output like this (trimmed):

listings: 10 | sponsored: 10 | non-sponsored: 0

Sponsored listings
----------------------------------------------------------------------
# 1 Nike Vomero 18                       $155.00    Macy's
# 2 Nike Pegasus 42                      $145.00    Fleet Feet
# 3 Nike Vaporfly 4                      $270.00    Fleet Feet
...

Merchants in the sponsored rail
  Macy's                    3
  Fleet Feet                2
  Foot Locker               1
...

In this saved ten-card example, every listing was marked sponsored. The script demonstrates counting labeled cards; it does not establish a general ad share.

Honest limits of ad tracking

Tracking ads from product listings is powerful but has ceilings. Say them out loud before you build on top:

• The ad mix varies. Count labeled ads separately from free or unlabeled cards. Do not treat an unlabeled card as paid.
• No bid or spend data. A listing price is not an ad bid. You can observe which merchant won the slot and at what price, but not what they paid for it.
• Short depth. One query returns roughly a dozen listings. Track many keywords to build a representative picture.
• Price can be null. A small share of listings appear without a displayed price at read time; the API returns null rather than inventing a number.

Those limits are why ad tracking from a shopping API works best as a position + price + merchant monitor, not as a replacement for an advertising platform's own reporting.

What it costs

Shopping searches are billed per 1,000 calls, pay-as-you-go. Tiers: $0.35 / 1K at Default, $0.32 / 1K at Growth, $0.25 / 1K at Scale. No per-page multiplier, no subscription, credits never expire. Full table on the pricing page.

FAQ