> ## Documentation Index > Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt > Use this file to discover all available pages before exploring further. # Search > Unified Google Trends dispatcher — pick interest over time, compared breakdown, interest by region, related topics, or related queries via `data_type`. ## OpenAPI ````yaml GET /v1/google/trends/search openapi: 3.1.0 info: title: ScrapeBadger Google Scraper description: >- Dedicated API for scraping Google products (SERP, Maps, News, Hotels, Trends, Jobs, Shopping, Patents, Scholar, Autocomplete, Images, Videos, Finance, AI Mode, Lens, Products). version: 1.0.0 servers: - url: https://scrapebadger.com description: Production security: - apiKeyAuth: [] paths: /v1/google/trends/search: get: tags: - Google Trends summary: Google Trends — unified search description: Unified Google Trends dispatcher. Pick the shape via `data_type`. operationId: trends_search_api_v1_trends_search_get parameters: - name: q in: query required: true schema: type: string description: >- Search term(s). Up to 5 comma-separated terms for TIMESERIES / GEO_MAP; single term for GEO_MAP_0 / RELATED_TOPICS / RELATED_QUERIES. Also accepts a topic MID. title: Q description: >- Search term(s). Up to 5 comma-separated terms for TIMESERIES / GEO_MAP; single term for GEO_MAP_0 / RELATED_TOPICS / RELATED_QUERIES. Also accepts a topic MID. - name: data_type in: query required: false schema: enum: - TIMESERIES - GEO_MAP - GEO_MAP_0 - RELATED_TOPICS - RELATED_QUERIES type: string description: >- Dispatch on: TIMESERIES (interest over time), GEO_MAP (compared breakdown, multi-query), GEO_MAP_0 (interest by region, single query), RELATED_TOPICS (top + rising topics), RELATED_QUERIES (top + rising queries). default: TIMESERIES title: Data Type description: >- Dispatch on: TIMESERIES (interest over time), GEO_MAP (compared breakdown, multi-query), GEO_MAP_0 (interest by region, single query), RELATED_TOPICS (top + rising topics), RELATED_QUERIES (top + rising queries). - name: geo in: query required: false schema: type: string description: Country / region code (e.g. US, GB, US-CA). default: '' title: Geo description: Country / region code (e.g. US, GB, US-CA). - name: date in: query required: false schema: type: string description: Time range. default: today 12-m title: Date description: Time range. - name: cat in: query required: false schema: type: integer description: Category filter ID (0 = all). default: 0 title: Cat description: Category filter ID (0 = all). - name: gprop in: query required: false schema: type: string description: 'Property filter: "" (web), "images", "news", "froogle", "youtube".' default: '' title: Gprop description: 'Property filter: "" (web), "images", "news", "froogle", "youtube".' - name: region in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Geo resolution for GEO_MAP / GEO_MAP_0: COUNTRY / REGION / DMA / CITY. Omit to use the widget's own default. title: Region description: >- Geo resolution for GEO_MAP / GEO_MAP_0: COUNTRY / REGION / DMA / CITY. Omit to use the widget's own default. - name: language in: query required: false schema: anyOf: - type: string - type: 'null' description: Alias for `hl`. Defaults to en-US. title: Language description: Alias for `hl`. Defaults to en-US. - name: tz in: query required: false schema: type: string description: Timezone offset in minutes. default: '0' title: Tz description: Timezone offset in minutes. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/TrendsSearchResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: TrendsSearchResponse: properties: query: type: string title: Query data_type: type: string title: Data Type timeline: items: $ref: '#/components/schemas/TrendsTimelinePoint' type: array title: Timeline averages: items: $ref: '#/components/schemas/TrendsTimelineValue' type: array title: Averages regions: items: $ref: '#/components/schemas/TrendsRegionInterest' type: array title: Regions top_topics: items: $ref: '#/components/schemas/TrendsRelatedItem' type: array title: Top Topics rising_topics: items: $ref: '#/components/schemas/TrendsRelatedItem' type: array title: Rising Topics top_queries: items: $ref: '#/components/schemas/TrendsRelatedItem' type: array title: Top Queries rising_queries: items: $ref: '#/components/schemas/TrendsRelatedItem' type: array title: Rising Queries type: object required: - query - data_type title: TrendsSearchResponse description: |- Unified response for GET /api/v1/trends/search. A single endpoint that dispatches on ``data_type`` (TIMESERIES, GEO_MAP, GEO_MAP_0, RELATED_TOPICS, RELATED_QUERIES). Only the field set relevant to the requested ``data_type`` is populated; others stay at their empty defaults. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError TrendsTimelinePoint: properties: date: type: string title: Date timestamp: anyOf: - type: integer - type: 'null' title: Timestamp values: items: $ref: '#/components/schemas/TrendsTimelineValue' type: array title: Values type: object required: - date title: TrendsTimelinePoint description: A single point in interest over time. TrendsTimelineValue: properties: query: type: string title: Query value: type: integer title: Value extracted_value: anyOf: - type: integer - type: 'null' title: Extracted Value type: object required: - query - value title: TrendsTimelineValue description: A single value in a trends timeline point. TrendsRegionInterest: properties: region: type: string title: Region region_code: anyOf: - type: string - type: 'null' title: Region Code value: type: integer title: Value default: 0 max_value_index: type: integer title: Max Value Index default: 0 type: object required: - region title: TrendsRegionInterest description: Interest for a specific region. TrendsRelatedItem: properties: title: type: string title: Title value: anyOf: - type: string - type: 'null' title: Value link: anyOf: - type: string - type: 'null' title: Link topic_id: anyOf: - type: string - type: 'null' title: Topic Id topic_type: anyOf: - type: string - type: 'null' title: Topic Type type: object required: - title title: TrendsRelatedItem description: A related topic or query. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError securitySchemes: apiKeyAuth: type: apiKey in: header name: x-api-key ````