openapi: 3.2.0
info:
title: Amazon Product Search Tools REST Amazon Search API
version: 1.0.0
description: Amazon product search, position tracking, reviews, and pricing data
servers:
- url: https://connect.mcp360.ai
description: MCP360 API Server
security:
- bearerAuth: []
- apiKey: []
tags:
- name: amazon-search
paths:
/api/v1/amazon-search/search_products:
post:
summary: Execute search_products
operationId: amazon-search_search_products
tags:
- amazon-search
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/amazon-search_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: amazon-search_search_products_get
tags:
- amazon-search
parameters:
- name: query
in: query
required: true
schema:
type: string
description: Product search query
- name: country
in: query
required: false
schema:
type: string
description: 'Amazon marketplace: ''us'', ''uk'', ''de'', ''fr'', ''jp'', ''ca'', ''in'', etc.'
- 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: prime_only
in: query
required: false
schema:
type: boolean
description: Show only Prime-eligible products
- name: min_rating
in: query
required: false
schema:
type: number
description: Minimum customer rating (1-5)
- 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/amazon-search/get_product_details:
post:
summary: Execute get_product_details
operationId: amazon-search_get_product_details
tags:
- amazon-search
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/amazon-search_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: amazon-search_get_product_details_get
tags:
- amazon-search
parameters:
- name: asin
in: query
required: true
schema:
type: string
description: Amazon ASIN (product identifier)
- name: country
in: query
required: false
schema:
type: string
description: 'Amazon marketplace: ''us'', ''uk'', ''de'', ''fr'', ''jp'', ''ca'', ''in'''
- 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/amazon-search/filter_by_category:
post:
summary: Execute filter_by_category
operationId: amazon-search_filter_by_category
tags:
- amazon-search
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/amazon-search_filter_by_category_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_category
operationId: amazon-search_filter_by_category_get
tags:
- amazon-search
parameters:
- name: query
in: query
required: true
schema:
type: string
description: Search query
- name: category
in: query
required: true
schema:
type: string
description: Category (e.g., 'Electronics', 'Books', 'Clothing')
- name: country
in: query
required: false
schema:
type: string
description: 'Amazon marketplace: ''us'', ''uk'', ''de'', ''fr'', ''jp'', ''ca'', ''in'''
- name: sort_by
in: query
required: false
schema:
type: string
description: 'Sort by: ''featured'', ''price_low_to_high'', ''price_high_to_low'', ''average_review'', ''newest_arrivals'', ''bestsellers'''
- 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/amazon-search/search_prime_products:
post:
summary: Execute search_prime_products
operationId: amazon-search_search_prime_products
tags:
- amazon-search
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/amazon-search_search_prime_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_prime_products
operationId: amazon-search_search_prime_products_get
tags:
- amazon-search
parameters:
- name: query
in: query
required: true
schema:
type: string
description: Product search query
- name: country
in: query
required: false
schema:
type: string
description: 'Amazon marketplace: ''us'', ''uk'', ''de'', ''fr'', ''jp'', ''ca'', ''in'''
- name: min_rating
in: query
required: false
schema:
type: number
description: Minimum customer rating (1-5)
- 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/amazon-search/find_product_position:
post:
summary: Execute find_product_position
operationId: amazon-search_find_product_position
tags:
- amazon-search
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/amazon-search_find_product_position_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 find_product_position
operationId: amazon-search_find_product_position_get
tags:
- amazon-search
parameters:
- name: keyword
in: query
required: true
schema:
type: string
description: Search keyword or phrase to check your product's ranking for (e.g., 'wireless headphones', 'running shoes')
- name: product_url
in: query
required: true
schema:
type: string
description: Your Amazon product URL (e.g., 'https://amazon.com/dp/B08XYZ' or just ASIN like 'B08XYZ')
- name: country
in: query
required: false
schema:
type: string
description: 'Amazon marketplace: ''us'', ''uk'', ''de'', ''fr'', ''jp'', ''ca'', ''in'''
- 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/amazon-search/bulk_find_product_position:
post:
summary: Execute bulk_find_product_position
operationId: amazon-search_bulk_find_product_position
tags:
- amazon-search
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/amazon-search_bulk_find_product_position_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
components:
schemas:
amazon-search_find_product_position_input:
type: object
properties:
keyword:
type: string
minLength: 1
maxLength: 200
description: Search keyword or phrase to check your product's ranking for (e.g., 'wireless headphones', 'running shoes')
product_url:
type: string
description: Your Amazon product URL (e.g., 'https://amazon.com/dp/B08XYZ' or just ASIN like 'B08XYZ')
country:
type: string
pattern: ^(us|uk|de|fr|jp|ca|in|es|it|au|br|mx|nl|ae|sg|se|pl|tr|sa|eg)$
default: us
description: 'Amazon marketplace: ''us'', ''uk'', ''de'', ''fr'', ''jp'', ''ca'', ''in'''
required:
- keyword
- product_url
additionalProperties: false
amazon-search_bulk_find_product_position_input:
type: object
properties:
keywords:
type: array
items:
type: string
minLength: 1
maxLength: 200
minItems: 1
maxItems: 10
description: Array of keywords or phrases to check your product's position for (max 10 keywords, e.g., ['wireless headphones', 'bluetooth headphones'])
product_url:
type: string
description: Your Amazon product URL (e.g., 'https://amazon.com/dp/B08XYZ' or just ASIN like 'B08XYZ')
country:
type: string
pattern: ^(us|uk|de|fr|jp|ca|in|es|it|au|br|mx|nl|ae|sg|se|pl|tr|sa|eg)$
default: us
description: 'Amazon marketplace: ''us'', ''uk'', ''de'', ''fr'', ''jp'', ''ca'', ''in'''
required:
- keywords
- product_url
additionalProperties: false
amazon-search_get_product_details_input:
type: object
properties:
asin:
type: string
minLength: 10
maxLength: 10
pattern: ^[A-Z0-9]{10}$
description: Amazon ASIN (product identifier)
country:
type: string
pattern: ^(us|uk|de|fr|jp|ca|in|es|it|au|br|mx|nl|ae|sg|se|pl|tr|sa|eg)$
default: us
description: 'Amazon marketplace: ''us'', ''uk'', ''de'', ''fr'', ''jp'', ''ca'', ''in'''
required:
- asin
additionalProperties: false
amazon-search_search_prime_products_input:
type: object
properties:
query:
type: string
minLength: 1
maxLength: 500
description: Product search query
country:
type: string
pattern: ^(us|uk|de|fr|jp|ca|in|es|it|au|br|mx|nl|ae|sg|se|pl|tr|sa|eg)$
default: us
description: 'Amazon marketplace: ''us'', ''uk'', ''de'', ''fr'', ''jp'', ''ca'', ''in'''
min_rating:
type: number
minimum: 1
maximum: 5
description: Minimum customer rating (1-5)
required:
- query
additionalProperties: false
amazon-search_search_products_input:
type: object
properties:
query:
type: string
minLength: 1
maxLength: 500
description: Product search query
country:
type: string
pattern: ^(us|uk|de|fr|jp|ca|in|es|it|au|br|mx|nl|ae|sg|se|pl|tr|sa|eg)$
default: us
description: 'Amazon marketplace: ''us'', ''uk'', ''de'', ''fr'', ''jp'', ''ca'', ''in'', etc.'
min_price:
type: number
exclusiveMinimum: 0
description: Minimum price filter
max_price:
type: number
exclusiveMinimum: 0
description: Maximum price filter
prime_only:
type: boolean
default: false
description: Show only Prime-eligible products
min_rating:
type: number
minimum: 1
maximum: 5
description: Minimum customer rating (1-5)
required:
- query
additionalProperties: false
amazon-search_filter_by_category_input:
type: object
properties:
query:
type: string
minLength: 1
maxLength: 500
description: Search query
category:
type: string
minLength: 1
description: Category (e.g., 'Electronics', 'Books', 'Clothing')
country:
type: string
pattern: ^(us|uk|de|fr|jp|ca|in|es|it|au|br|mx|nl|ae|sg|se|pl|tr|sa|eg)$
default: us
description: 'Amazon marketplace: ''us'', ''uk'', ''de'', ''fr'', ''jp'', ''ca'', ''in'''
sort_by:
type: string
enum:
- featured
- price_low_to_high
- price_high_to_low
- average_review
- newest_arrivals
- bestsellers
description: 'Sort by: ''featured'', ''price_low_to_high'', ''price_high_to_low'', ''average_review'', ''newest_arrivals'', ''bestsellers'''
required:
- query
- category
additionalProperties: false
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
apiKey:
type: apiKey
in: header
name: X-API-Key