MCP360 Google Shopping API
The google-shopping API from MCP360 — 4 operation(s) for google-shopping.
OpenAPI Specification
openapi: 3.2.0
info:
title: Tools REST Google Shopping API
version: 1.0.0
description: Google Shopping product search, price comparison, and e-commerce insights
servers:
- url: https://connect.mcp360.ai
description: MCP360 API Server
security:
- bearerAuth: []
- apiKey: []
tags:
- name: google-shopping
paths:
/api/v1/google-shopping/search_products:
post:
summary: Execute search_products
operationId: google-shopping_search_products
tags:
- google-shopping
parameters:
- name: validateOutput
in: query
schema:
type: boolean
description: Validate output against schema
- name: strictValidation
in: query
schema:
type: boolean
description: Fail on validation errors
- name: includeMetadata
in: query
schema:
type: boolean
description: Include execution metadata
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/google-shopping_search_products_input'
responses:
'200':
description: Successful execution
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
data:
type: object
metadata:
type: object
properties:
service:
type: string
tool:
type: string
executionTime:
type: string
creditsUsed:
type: number
timestamp:
type: string
format: date-time
required:
- success
- data
'400':
description: Bad request or validation error
'401':
description: Unauthorized
'403':
description: Forbidden (premium access required)
'404':
description: Service or tool not found
'429':
description: Rate limit exceeded
'500':
description: Internal server error
get:
summary: Execute search_products
operationId: google-shopping_search_products_get
tags:
- google-shopping
parameters:
- name: query
in: query
required: true
schema:
type: string
description: Product search query
- name: country
in: query
required: false
schema:
type: string
description: Country code (e.g., 'us', 'uk')
- name: language
in: query
required: false
schema:
type: string
description: Language code (e.g., 'en', 'es')
- name: location
in: query
required: false
schema:
type: string
description: Location for shipping/delivery estimates
- name: min_price
in: query
required: false
schema:
type: number
description: Minimum price filter
- name: max_price
in: query
required: false
schema:
type: number
description: Maximum price filter
- name: condition
in: query
required: false
schema:
type: string
description: 'Product condition: ''new'', ''used'', ''refurbished'''
- name: validateOutput
in: query
schema:
type: boolean
description: Validate output against schema
- name: includeMetadata
in: query
schema:
type: boolean
description: Include execution metadata
responses:
'200':
description: Successful execution
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
data:
type: object
metadata:
type: object
properties:
service:
type: string
tool:
type: string
executionTime:
type: string
creditsUsed:
type: number
timestamp:
type: string
format: date-time
required:
- success
- data
'400':
description: Bad request or validation error
'401':
description: Unauthorized
'403':
description: Forbidden (premium access required)
'404':
description: Service or tool not found
'429':
description: Rate limit exceeded
'500':
description: Internal server error
/api/v1/google-shopping/compare_prices:
post:
summary: Execute compare_prices
operationId: google-shopping_compare_prices
tags:
- google-shopping
parameters:
- name: validateOutput
in: query
schema:
type: boolean
description: Validate output against schema
- name: strictValidation
in: query
schema:
type: boolean
description: Fail on validation errors
- name: includeMetadata
in: query
schema:
type: boolean
description: Include execution metadata
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/google-shopping_compare_prices_input'
responses:
'200':
description: Successful execution
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
data:
type: object
metadata:
type: object
properties:
service:
type: string
tool:
type: string
executionTime:
type: string
creditsUsed:
type: number
timestamp:
type: string
format: date-time
required:
- success
- data
'400':
description: Bad request or validation error
'401':
description: Unauthorized
'403':
description: Forbidden (premium access required)
'404':
description: Service or tool not found
'429':
description: Rate limit exceeded
'500':
description: Internal server error
get:
summary: Execute compare_prices
operationId: google-shopping_compare_prices_get
tags:
- google-shopping
parameters:
- name: product_token
in: query
required: true
schema:
type: string
description: Product token from search_products results
- name: country
in: query
required: false
schema:
type: string
description: Country code (e.g., 'us', 'uk')
- name: language
in: query
required: false
schema:
type: string
description: Language code (e.g., 'en', 'es')
- name: validateOutput
in: query
schema:
type: boolean
description: Validate output against schema
- name: includeMetadata
in: query
schema:
type: boolean
description: Include execution metadata
responses:
'200':
description: Successful execution
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
data:
type: object
metadata:
type: object
properties:
service:
type: string
tool:
type: string
executionTime:
type: string
creditsUsed:
type: number
timestamp:
type: string
format: date-time
required:
- success
- data
'400':
description: Bad request or validation error
'401':
description: Unauthorized
'403':
description: Forbidden (premium access required)
'404':
description: Service or tool not found
'429':
description: Rate limit exceeded
'500':
description: Internal server error
/api/v1/google-shopping/filter_by_price_range:
post:
summary: Execute filter_by_price_range
operationId: google-shopping_filter_by_price_range
tags:
- google-shopping
parameters:
- name: validateOutput
in: query
schema:
type: boolean
description: Validate output against schema
- name: strictValidation
in: query
schema:
type: boolean
description: Fail on validation errors
- name: includeMetadata
in: query
schema:
type: boolean
description: Include execution metadata
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/google-shopping_filter_by_price_range_input'
responses:
'200':
description: Successful execution
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
data:
type: object
metadata:
type: object
properties:
service:
type: string
tool:
type: string
executionTime:
type: string
creditsUsed:
type: number
timestamp:
type: string
format: date-time
required:
- success
- data
'400':
description: Bad request or validation error
'401':
description: Unauthorized
'403':
description: Forbidden (premium access required)
'404':
description: Service or tool not found
'429':
description: Rate limit exceeded
'500':
description: Internal server error
get:
summary: Execute filter_by_price_range
operationId: google-shopping_filter_by_price_range_get
tags:
- google-shopping
parameters:
- name: query
in: query
required: true
schema:
type: string
description: Product search query
- name: min_price
in: query
required: true
schema:
type: number
description: Minimum price
- name: max_price
in: query
required: true
schema:
type: number
description: Maximum price
- name: country
in: query
required: false
schema:
type: string
description: Country code (e.g., 'us', 'uk')
- name: sort_by
in: query
required: false
schema:
type: string
description: 'Sort by: ''price_low_to_high'', ''price_high_to_low'', ''review_score'''
- name: validateOutput
in: query
schema:
type: boolean
description: Validate output against schema
- name: includeMetadata
in: query
schema:
type: boolean
description: Include execution metadata
responses:
'200':
description: Successful execution
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
data:
type: object
metadata:
type: object
properties:
service:
type: string
tool:
type: string
executionTime:
type: string
creditsUsed:
type: number
timestamp:
type: string
format: date-time
required:
- success
- data
'400':
description: Bad request or validation error
'401':
description: Unauthorized
'403':
description: Forbidden (premium access required)
'404':
description: Service or tool not found
'429':
description: Rate limit exceeded
'500':
description: Internal server error
/api/v1/google-shopping/get_product_details:
post:
summary: Execute get_product_details
operationId: google-shopping_get_product_details
tags:
- google-shopping
parameters:
- name: validateOutput
in: query
schema:
type: boolean
description: Validate output against schema
- name: strictValidation
in: query
schema:
type: boolean
description: Fail on validation errors
- name: includeMetadata
in: query
schema:
type: boolean
description: Include execution metadata
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/google-shopping_get_product_details_input'
responses:
'200':
description: Successful execution
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
data:
type: object
metadata:
type: object
properties:
service:
type: string
tool:
type: string
executionTime:
type: string
creditsUsed:
type: number
timestamp:
type: string
format: date-time
required:
- success
- data
'400':
description: Bad request or validation error
'401':
description: Unauthorized
'403':
description: Forbidden (premium access required)
'404':
description: Service or tool not found
'429':
description: Rate limit exceeded
'500':
description: Internal server error
get:
summary: Execute get_product_details
operationId: google-shopping_get_product_details_get
tags:
- google-shopping
parameters:
- name: product_token
in: query
required: true
schema:
type: string
description: Product token from search_products results
- name: country
in: query
required: false
schema:
type: string
description: Country code (e.g., 'us', 'uk')
- name: language
in: query
required: false
schema:
type: string
description: Language code (e.g., 'en', 'es')
- name: validateOutput
in: query
schema:
type: boolean
description: Validate output against schema
- name: includeMetadata
in: query
schema:
type: boolean
description: Include execution metadata
responses:
'200':
description: Successful execution
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
data:
type: object
metadata:
type: object
properties:
service:
type: string
tool:
type: string
executionTime:
type: string
creditsUsed:
type: number
timestamp:
type: string
format: date-time
required:
- success
- data
'400':
description: Bad request or validation error
'401':
description: Unauthorized
'403':
description: Forbidden (premium access required)
'404':
description: Service or tool not found
'429':
description: Rate limit exceeded
'500':
description: Internal server error
components:
schemas:
google-shopping_compare_prices_input:
type: object
properties:
product_token:
type: string
minLength: 1
description: Product token from search_products results
country:
type: string
minLength: 2
maxLength: 2
pattern: ^[a-z]{2}$
description: Country code (e.g., 'us', 'uk')
language:
type: string
minLength: 2
maxLength: 2
pattern: ^[a-z]{2}$
description: Language code (e.g., 'en', 'es')
required:
- product_token
additionalProperties: false
google-shopping_filter_by_price_range_input:
type: object
properties:
query:
type: string
description: Product search query
min_price:
type: number
description: Minimum price
max_price:
type: number
description: Maximum price
country:
type: string
description: Country code (e.g., 'us', 'uk')
sort_by:
type: string
description: 'Sort by: ''price_low_to_high'', ''price_high_to_low'', ''review_score'''
required:
- query
- min_price
- max_price
additionalProperties: false
google-shopping_get_product_details_input:
type: object
properties:
product_token:
type: string
description: Product token from search_products results
country:
type: string
description: Country code (e.g., 'us', 'uk')
language:
type: string
description: Language code (e.g., 'en', 'es')
required:
- product_token
additionalProperties: false
google-shopping_search_products_input:
type: object
properties:
query:
type: string
minLength: 1
maxLength: 200
description: Product search query
country:
type: string
minLength: 2
maxLength: 2
pattern: ^[a-z]{2}$
description: Country code (e.g., 'us', 'uk')
language:
type: string
minLength: 2
maxLength: 2
pattern: ^[a-z]{2}$
description: Language code (e.g., 'en', 'es')
location:
type: string
minLength: 1
maxLength: 100
description: Location for shipping/delivery estimates
min_price:
type: number
minimum: 0
maximum: 1000000
description: Minimum price filter
max_price:
type: number
exclusiveMinimum: 0
maximum: 1000000
description: Maximum price filter
condition:
type: string
enum:
- new
- used
- refurbished
description: 'Product condition: ''new'', ''used'', ''refurbished'''
required:
- query
additionalProperties: false
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
apiKey:
type: apiKey
in: header
name: X-API-Key