MCP360 Google Trends API
The google-trends API from MCP360 — 3 operation(s) for google-trends.
OpenAPI Specification
openapi: 3.2.0
info:
title: Tools REST Google Trends API
version: 1.0.0
description: Google Trends analysis, search interest data, and trending topics
servers:
- url: https://connect.mcp360.ai
description: MCP360 API Server
security:
- bearerAuth: []
- apiKey: []
tags:
- name: google-trends
paths:
/api/v1/google-trends/get_interest_over_time:
post:
summary: Execute get_interest_over_time
operationId: google-trends_get_interest_over_time
tags:
- google-trends
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-trends_get_interest_over_time_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
/api/v1/google-trends/get_interest_by_region:
post:
summary: Execute get_interest_by_region
operationId: google-trends_get_interest_by_region
tags:
- google-trends
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-trends_get_interest_by_region_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_interest_by_region
operationId: google-trends_get_interest_by_region_get
tags:
- google-trends
parameters:
- name: query
in: query
required: true
schema:
type: string
description: Search term or topic to analyze
- name: timeframe
in: query
required: false
schema:
type: string
description: Time range (e.g., 'today 12-m', 'today 3-m')
- name: country
in: query
required: false
schema:
type: string
description: Country code (e.g., 'US', 'GB')
- name: resolution
in: query
required: false
schema:
type: string
description: 'Geographic resolution: ''COUNTRY'', ''REGION'', ''CITY'', ''DMA'''
- 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-trends/get_related_topics:
post:
summary: Execute get_related_topics
operationId: google-trends_get_related_topics
tags:
- google-trends
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-trends_get_related_topics_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_related_topics
operationId: google-trends_get_related_topics_get
tags:
- google-trends
parameters:
- name: query
in: query
required: true
schema:
type: string
description: Search term to find related topics
- name: timeframe
in: query
required: false
schema:
type: string
description: Time range (e.g., 'today 12-m')
- name: country
in: query
required: false
schema:
type: string
description: Country code (e.g., 'US', 'GB')
- 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-trends_get_interest_by_region_input:
type: object
properties:
query:
type: string
minLength: 1
maxLength: 200
description: Search term or topic to analyze
timeframe:
type: string
pattern: ^(now \d+-[hdm]|today \d+-m|today \d+-m|all|\d{4}-\d{2}-\d{2} \d{4}-\d{2}-\d{2})$
default: today 12-m
description: Time range (e.g., 'today 12-m', 'today 3-m')
country:
type: string
minLength: 2
maxLength: 2
pattern: ^[A-Z]{2}$
description: Country code (e.g., 'US', 'GB')
resolution:
type: string
enum:
- COUNTRY
- REGION
- CITY
- DMA
description: 'Geographic resolution: ''COUNTRY'', ''REGION'', ''CITY'', ''DMA'''
required:
- query
additionalProperties: false
google-trends_get_interest_over_time_input:
type: object
properties:
query:
type: string
minLength: 1
maxLength: 200
description: Search term or topic to analyze
timeframe:
type: string
pattern: ^(now \d+-[hdm]|today \d+-m|today \d+-m|all|\d{4}-\d{2}-\d{2} \d{4}-\d{2}-\d{2})$
default: today 12-m
description: Time range (e.g., 'today 12-m', 'today 3-m', 'all')
country:
type: string
minLength: 2
maxLength: 2
pattern: ^[A-Z]{2}$
description: Country code (e.g., 'US', 'GB')
category:
type: integer
minimum: 0
maximum: 9999
description: Category ID (optional)
required:
- query
additionalProperties: false
google-trends_get_related_topics_input:
type: object
properties:
query:
type: string
minLength: 1
maxLength: 200
description: Search term to find related topics
timeframe:
type: string
pattern: ^(now \d+-[hdm]|today \d+-m|today \d+-m|all|\d{4}-\d{2}-\d{2} \d{4}-\d{2}-\d{2})$
default: today 12-m
description: Time range (e.g., 'today 12-m')
country:
type: string
minLength: 2
maxLength: 2
pattern: ^[A-Z]{2}$
description: Country code (e.g., 'US', 'GB')
required:
- query
additionalProperties: false
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
apiKey:
type: apiKey
in: header
name: X-API-Key