Google Shopping Store Offers for One Product, by Product IDs (US, English, Up to 10 Offers)

omnial/google-shopping-product-sellers-us-english

Given the three Google Shopping identifiers of one product, returns the US list of up to 10 stores offering it, in English and in page order: each store's name and web domain, its listing title, the item price, the shipping cost where shown, the total price, the currency, the availability, the star rating and rating count shown on the offer where present, and a price note where shown. Also returns the product title, its star rating and rating count, and the number of offers.

activeper callv1

Price

Up to $0.00273 per call; you pay what the call used

The price shown is the price you pay. No monthly minimum. Top-ups start at $5.

Data source

Google Shopping

Data from Google Shopping.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/google-shopping-product-sellers-us-english" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/google-shopping-product-sellers-us-english" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/google-shopping-product-sellers-us-english", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/google-shopping-product-sellers-us-english", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.00273

Updated: Oct 14, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "product_id",
    "data_docid",
    "gid",
    "location_code",
    "language_code"
  ],
  "properties": {
    "gid": {
      "type": "string",
      "minLength": 1,
      "description": "The product's global Google Shopping id, a long numeric string (the gpcid in a Google Shopping product link)."
    },
    "depth": {
      "enum": [
        10
      ],
      "type": "integer",
      "default": 10,
      "description": "How many store offers to fetch: 10, the default and the depth the tested call returned. The only value offered."
    },
    "data_docid": {
      "type": "string",
      "minLength": 1,
      "description": "The id of the product's headline offer, a long numeric string (the headlineOfferDocid in a Google Shopping product link)."
    },
    "product_id": {
      "type": "string",
      "minLength": 1,
      "description": "The product's Google Shopping catalog id, a long numeric string (the catalogid in a Google Shopping product link)."
    },
    "language_code": {
      "enum": [
        "en"
      ],
      "type": "string",
      "default": "en",
      "description": "The language of the results: \"en\", English. The only value offered."
    },
    "location_code": {
      "enum": [
        2840
      ],
      "type": "integer",
      "default": 2840,
      "description": "The market searched: 2840, the United States. The only value offered."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "domain": {
                  "type": "string",
                  "description": "The store's web domain."
                },
                "rating": {
                  "type": "object",
                  "properties": {
                    "value": {
                      "type": "number",
                      "description": "The average star rating out of 5."
                    },
                    "votes_count": {
                      "type": "number",
                      "description": "How many ratings it has."
                    }
                  },
                  "description": "The star rating shown on the offer; absent when the offer shows none."
                },
                "details": {
                  "type": "string",
                  "description": "The listing title the store gives the item."
                },
                "currency": {
                  "type": "string",
                  "description": "The price currency."
                },
                "base_price": {
                  "type": "number",
                  "description": "The item price."
                },
                "seller_name": {
                  "type": "string",
                  "description": "The store name."
                },
                "total_price": {
                  "type": "number",
                  "description": "The item price plus any shipping cost shown."
                },
                "rank_absolute": {
                  "type": "number",
                  "description": "The offer's position in the list, from 1."
                },
                "shipping_price": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "description": "The shipping cost; null when the offer shows none."
                },
                "product_annotation": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "A price note the offer shows, such as a usual price; null when none."
                },
                "product_availability": {
                  "type": "string",
                  "description": "The stock status, such as in_stock."
                }
              }
            },
            "description": "The store offers, in page order."
          },
          "title": {
            "type": "string",
            "description": "The product title."
          },
          "rating": {
            "type": "object",
            "properties": {
              "value": {
                "type": "number",
                "description": "The average star rating out of 5."
              },
              "votes_count": {
                "type": "number",
                "description": "How many ratings it has."
              }
            },
            "description": "The product's own rating."
          },
          "product_id": {
            "type": "string",
            "description": "The product's catalog id, echoed back."
          },
          "items_count": {
            "type": "number",
            "description": "How many store offers came back."
          }
        }
      }
    }
  },
  "description": "The product's store offers, wrapped as `{results: [...]}` (one entry per call)."
}