VX Agents

API directory · Marketing & Analytics

DataForSEO Google Shopping Products

v1.0.0 · 13 endpoints · 0 connections · shared by vx.ai

Who else sells this product on Google Shopping, and for how much? Queue Google Shopping searches for your keywords, compare the stores and prices offering one product, pull its specs and variations, and resolve a shopping ad to the seller's landing page with DataForSEO's Merchant API.

Connect this API to an AI agent Browse all specs

What you can do with DataForSEO Google Shopping Products via MCP

Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.

MethodPathOperationDescription
GET /v3/merchant/google/locations listGoogleShoppingLocations List location names and codes for Google Shopping tasks (free)
GET /v3/merchant/google/locations/{country} listGoogleShoppingLocationsByCountry List Google Shopping locations within one country (free)
GET /v3/merchant/google/languages listGoogleShoppingLanguages List language names and codes for Google Shopping tasks (free)
POST /v3/merchant/google/products/task_post createGoogleShoppingSearchTask Queue Google Shopping searches for one or more keywords
GET /v3/merchant/google/products/tasks_ready listReadyGoogleShoppingSearchTasks List queued Google Shopping searches whose results are ready
GET /v3/merchant/google/products/task_get/advanced/{id} getGoogleShoppingSearchResults Get the Google Shopping results (products, prices, stores) of a search task
POST /v3/merchant/google/sellers/task_post createGoogleShoppingSellersTask Queue a lookup of every store selling one Google Shopping product
GET /v3/merchant/google/sellers/tasks_ready listReadyGoogleShoppingSellersTasks List queued seller lookups whose results are ready
GET /v3/merchant/google/sellers/task_get/advanced/{id} getGoogleShoppingSellersResults Get the stores, prices and shipping offered for a product
POST /v3/merchant/google/product_info/task_post createGoogleShoppingProductInfoTask Queue a lookup of one product's specs, variations and rating
GET /v3/merchant/google/product_info/tasks_ready listReadyGoogleShoppingProductInfoTasks List queued product info lookups whose results are ready
GET /v3/merchant/google/product_info/task_get/advanced/{id} getGoogleShoppingProductInfoResults Get a product's description, specs, images, variations and rating
GET /v3/merchant/google/sellers/ad_url/{shop_ad_aclk} resolveGoogleShoppingAdUrl Resolve a shopping ad id (shop_ad_aclk) to the seller's landing page URL

Authentication

basicAuth

HTTP Basic

DataForSEO uses HTTP basic auth with your API login and API password (not your dashboard password).

How to get a credential

  1. Sign up at https://app.dataforseo.com/register (pay-as-you-go; new accounts get trial credit).
  2. Open API Access in the dashboard (https://app.dataforseo.com/api-access).
  3. Copy the API login (your email) and the API password shown there.

Permissions used

DataForSEO has no scopes: every posted task is billed from your balance.

Access Operations
Billed queued tasks createGoogleShoppingSearchTask, createGoogleShoppingSellersTask, createGoogleShoppingProductInfoTask
Results of your own tasks listReadyGoogleShoppingSearchTasks, getGoogleShoppingSearchResults, listReadyGoogleShoppingSellersTasks, getGoogleShoppingSellersResults, listReadyGoogleShoppingProductInfoTasks, getGoogleShoppingProductInfoResults, resolveGoogleShoppingAdUrl
Free lookups listGoogleShoppingLocations, listGoogleShoppingLocationsByCountry, listGoogleShoppingLanguages

Common errors

DataForSEO answers HTTP 200 and puts the real result in status_code (20000 = ok, 20100 = task created) inside the body and each task.

Code Meaning Fix
401 / 40100 Wrong login or API password Copy both again from API Access.
40200 / 40210 Balance too low Top up the account balance.
40203 Daily cost limit reached Raise the limit under API Settings in the dashboard.
40501 / 40503 Invalid field or location Use location_code from the locations list; give product_id, gid or data_docid for seller and product lookups.
40601 / 40602 Task handed / still in queue Wait 30-60 seconds and fetch the same id again.
40202 Per-minute rate limit exceeded Slow down and retry.

Store the login and API password as a VX Agents basic-auth credential.

Usage guide

Setup

  • Credential: DataForSEO API login + API password as a basic-auth credential (see the authentication notes).
  • Worth pinning: your market's location_code (e.g. 2840 United States, 2826 United Kingdom) and language_code (e.g. en; take the exact value from listGoogleShoppingLanguages).

Compare products and sellers on Google Shopping

All Google Shopping endpoints are queued tasks: post, wait, then fetch by task id.

  1. Look up codes once with listGoogleShoppingLocations (or listGoogleShoppingLocationsByCountry with an ISO code such as us) and listGoogleShoppingLanguages (free).
  2. Every task body is an array of task objects (up to 100), e.g. [{"keyword": "trail running shoes", "location_code": 2840, "language_code": "en", "depth": 40}].
  3. Search: createGoogleShoppingSearchTask with keyword (optional price_min/price_max, sort_by = review_score, price_low_to_high or price_high_to_low). Poll listReadyGoogleShoppingSearchTasks, then getGoogleShoppingSearchResults with the task id. Items of type google_shopping_serp carry title, price, seller, product_rating, product_id, gid, data_docid and shop_ad_aclk.
  4. Who sells it: createGoogleShoppingSellersTask with product_id, gid and data_docid from step 3, then listReadyGoogleShoppingSellersTasks and getGoogleShoppingSellersResults: each seller has base_price, shipping_price, total_price and seller_name.
  5. Product details: createGoogleShoppingProductInfoTask with the same ids, then listReadyGoogleShoppingProductInfoTasks and getGoogleShoppingProductInfoResults for description, specifications, images, variations and rating.
  6. Ad landing page: resolveGoogleShoppingAdUrl with a shop_ad_aclk value from search or seller results.

Good to know

  • Posted tasks cost money from your balance (search billed per 40 results, sellers per 10; get_shops_on_google doubles the sellers cost; priority: 2 costs extra). Confirm with the user before large batches or a high depth.
  • A fetch right after posting can return 40601/40602: wait 30-60 seconds and retry. Results stay available for 30 days.
  • Check status_code in the body and in each task: 20000 = ok, 20100 = task created.
  • tag labels a task (e.g. your SKU) and comes back with the results.

Source: DataForSEO Merchant API reference (https://docs.dataforseo.com/v3/merchant/google/overview/), checked 2026-10-25.

How to use this spec

  1. Create a free VX Agents account (sandbox tools included).
  2. Open the marketplace and connect “DataForSEO Google Shopping Products” to an agent.
  3. Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.

Related APIs