Google Shopping Listings and Product Carousels (US, English)
omnial/google-shopping-listings-and-carousels
Returns the US Google Shopping results page, in English, for a product query, in page order. Listings carry title, store or seller, listed price and currency, earlier price and discount label where shown, star rating and rating count where shown, delivery note where shown, and a shopping-page link. Themed carousels carry their heading and their offers (title, seller, price, currency, rating, link). Also returns the query echoed back and the entry count.
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-listings-and-carousels" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/google-shopping-listings-and-carousels" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/google-shopping-listings-and-carousels", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/google-shopping-listings-and-carousels", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot 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": [
"keyword",
"location_code",
"language_code"
],
"properties": {
"depth": {
"enum": [
20,
40
],
"type": "integer",
"default": 40,
"description": "How many listings to ask for: 20 (the value the tested call sent) or 40 (the default); both fetch the same single first page of up to 40."
},
"keyword": {
"type": "string",
"maxLength": 700,
"minLength": 1,
"description": "The product search query, in plain text."
},
"language_code": {
"enum": [
"en"
],
"type": "string",
"description": "The search language; only \"en\" (English), the one tested, is offered."
},
"location_code": {
"enum": [
2840
],
"type": "integer",
"description": "The market searched; only 2840 (United States), the one tested, is 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": {
"tags": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "Short labels shown on a listing, such as a discount, or null."
},
"type": {
"type": "string",
"description": "The entry kind: \"google_shopping_serp\" (a product listing) or \"google_shopping_carousel\" (a themed carousel of offers)."
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"price": {
"type": "number",
"description": "The offer's listed price."
},
"title": {
"type": "string",
"description": "The offer's product title."
},
"seller": {
"type": "string",
"description": "The offer's store or seller."
},
"currency": {
"type": "string",
"description": "The price currency code."
},
"shopping_url": {
"type": "string",
"description": "The link to the offer's Google Shopping product page."
},
"product_rating": {
"type": [
"object",
"null"
],
"properties": {
"value": {
"type": "number",
"description": "Average stars, 0 to 5."
},
"votes_count": {
"type": "number",
"description": "The number of ratings."
}
},
"description": "The offer's star rating, or null when none is shown."
}
}
},
"description": "The offers inside a carousel (carousel entries only)."
},
"price": {
"type": "number",
"description": "A listing's listed price."
},
"title": {
"type": "string",
"description": "The listing's product title, or the carousel's heading."
},
"seller": {
"type": "string",
"description": "The store or marketplace seller of a listing."
},
"currency": {
"type": "string",
"description": "The price currency code."
},
"old_price": {
"type": [
"number",
"null"
],
"description": "The earlier price shown beside a listing, or null."
},
"shopping_url": {
"type": "string",
"description": "The link to the listing's Google Shopping product page."
},
"delivery_info": {
"type": [
"object",
"null"
],
"properties": {
"delivery_message": {
"type": "string",
"description": "The delivery note text."
}
},
"description": "A listing's delivery note, or null when none is shown."
},
"rank_absolute": {
"type": "number",
"description": "Position on the page, from 1."
},
"product_rating": {
"type": [
"object",
"null"
],
"properties": {
"value": {
"type": "number",
"description": "Average stars, 0 to 5."
},
"votes_count": {
"type": "number",
"description": "The number of ratings."
}
},
"description": "A listing's star rating, or null when none is shown."
}
}
},
"description": "The page's entries, in page order."
},
"keyword": {
"type": "string",
"description": "The search query, echoed back."
},
"items_count": {
"type": "number",
"description": "How many entries came back."
}
}
}
}
},
"description": "The shopping results page, wrapped as `{results: [...]}` (one entry per call)."
}