> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zilodata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search

> Search the content of the platform, like search video, music etc.



## OpenAPI

````yaml api-reference/youtube-openapi.json get /api/v1/search
openapi: 3.1.0
info:
  title: YouTube APIs
  description: YouTube API Documentation
  version: 1.0.0
servers:
  - url: https://youtube-scraper-api-v21.p.rapidapi.com
security: []
paths:
  /api/v1/search:
    get:
      tags:
        - Explore
      summary: Search
      description: Search the content of the platform, like search video, music etc.
      operationId: getApiV1Search
      parameters:
        - in: query
          name: keyword
          schema:
            type: string
            description: Search keyword
            example: funny videos
          required: true
        - in: query
          name: gl
          schema:
            type: string
            default: US
            description: Geographical code
            example: US
            enum:
              - US
              - AE
              - AR
              - AT
              - AU
              - AZ
              - BD
              - BE
              - BG
              - BR
              - CA
              - CH
              - CL
              - CO
              - CZ
              - DE
              - DK
              - DO
              - DZ
              - EC
              - EG
              - ES
              - FI
              - FR
              - GB
              - GH
              - GR
              - GT
              - HK
              - HN
              - HR
              - HU
              - ID
              - IE
              - IL
              - IN
              - IQ
              - IT
              - JP
              - KE
              - KR
              - LB
              - LT
              - LV
              - MA
              - MX
              - MY
              - NG
              - NL
              - 'NO'
              - NZ
              - PE
              - PH
              - PK
              - PL
              - PT
              - RO
              - RU
              - SA
              - SE
              - SG
              - TH
              - TR
              - TW
              - UA
              - VE
              - VN
              - ZA
          required: false
        - in: query
          name: uploadDate
          schema:
            type: string
            default: 1_HOUR_AGO
            description: Upload date
            example: 1_HOUR_AGO
            enum:
              - 1_HOUR_AGO
              - TODAY
              - THIS_WEEK
              - THIS_MONTH
              - THIS_YEAR
          required: false
        - in: query
          name: type
          schema:
            type: string
            default: VIDEO
            description: Type
            example: VIDEO
            enum:
              - VIDEO
              - MOVIE
          required: false
        - in: query
          name: hl
          schema:
            type: string
            description: Language code
            example: en
            enum:
              - ar
              - az
              - bg
              - bn
              - cs
              - da
              - de
              - el
              - en
              - en-GB
              - en-IE
              - en-NZ
              - en-SG
              - es
              - es-419
              - fi
              - fil
              - fr
              - he
              - hi
              - hr
              - hu
              - id
              - it
              - ja
              - ko
              - lt
              - lv
              - ms
              - nl
              - 'no'
              - pl
              - pt-BR
              - pt-PT
              - ro
              - ru
              - sv
              - th
              - tr
              - uk
              - ur
              - vi
              - zh-Hant
            default: en
          required: false
        - in: query
          name: continuation
          schema:
            type: string
            description: Continuation token for pagination
            example: ''
          required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Success
                  statusCode:
                    type: number
                    example: 200
                  pagination:
                    type: object
                    properties:
                      total:
                        type: number
                        example: 100
                      hasMore:
                        type: boolean
                        example: true
                      continuation:
                        type:
                          - string
                          - 'null'
                        description: Continuation token for pagination
                        example: CDsQ8FsiEwje95_F1pmRAxXlsykDHUX
                  data:
                    type: object
                    properties:
                      contents:
                        type: array
                        items:
                          type: object
                          properties:
                            author:
                              type: object
                              properties:
                                avatar:
                                  type: object
                                  properties:
                                    url:
                                      type: string
                                      description: Author avatar image URL
                                      example: >-
                                        https://yt3.ggpht.com/Lw8D7ol21pLxWEDvnIwcV0DsXIA1d_6DK4_wlkTtaP7SEGBg-2FLRDvs57NPnE1DcNarWPkQpvs=s88-c-k-c0x00ffffff-no-rj
                                    width:
                                      type: number
                                      description: Avatar image width in pixels
                                      example: 68
                                    height:
                                      type: number
                                      description: Avatar image height in pixels
                                      example: 68
                                  required:
                                    - url
                                    - width
                                    - height
                                  description: Author avatar image information
                                badges:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      type:
                                        type: string
                                        description: Badge type identifier
                                        example: AUDIO_BADGE
                                      text:
                                        type: string
                                        description: Badge display text or tooltip
                                        example: Official Artist Channel
                                    required:
                                      - type
                                      - text
                                    description: Author badge information
                                  description: >-
                                    Array of author badges (e.g., verified,
                                    official artist channel)
                                  example:
                                    - type: AUDIO_BADGE
                                      text: Official Artist Channel
                                name:
                                  type: string
                                  description: Author/channel name
                                  example: Luis Fonsi
                              required:
                                - avatar
                                - name
                              description: Video author/channel information
                            videoId:
                              type: string
                              description: YouTube video ID
                              example: kJQP7kiw5Fk
                            channelId:
                              type: string
                              description: YouTube channel ID
                              example: UCxoq-PAQeAdk_zyg8YS0JqA
                            thumbnails:
                              type: array
                              items:
                                type: object
                                properties:
                                  url:
                                    type: string
                                    description: Thumbnail image URL
                                    example: >-
                                      https://i.ytimg.com/vi/kJQP7kiw5Fk/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLCj96Jh8NkTqgJqkcXFQKo7MnO30g
                                  width:
                                    type: number
                                    description: Thumbnail image width in pixels
                                    example: 360
                                  height:
                                    type: number
                                    description: Thumbnail image height in pixels
                                    example: 202
                                required:
                                  - url
                                  - width
                                  - height
                                description: Thumbnail image information
                              description: >-
                                Array of video thumbnail images in different
                                sizes
                              example:
                                - url: >-
                                    https://i.ytimg.com/vi/kJQP7kiw5Fk/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLCj96Jh8NkTqgJqkcXFQKo7MnO30g
                                  width: 360
                                  height: 202
                                - url: >-
                                    https://i.ytimg.com/vi/kJQP7kiw5Fk/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLBH3EhyCr_aZDODXzXVDL-taforQw
                                  width: 720
                                  height: 404
                            publishedTimeText:
                              type: string
                              description: Human-readable published time text
                              example: 8 years ago
                            title:
                              type: string
                              description: Video title
                              example: Luis Fonsi - Despacito ft. Daddy Yankee
                            views:
                              type: number
                              description: Number of video views
                              example: 8871198622
                            duration:
                              type: string
                              description: Video duration in format MM:SS or HH:MM:SS
                              example: '4:42'
                            url:
                              type: string
                              description: YouTube video watch URL
                              example: https://www.youtube.com/watch?v=kJQP7kiw5Fk
                          required:
                            - author
                            - videoId
                            - channelId
                            - thumbnails
                            - publishedTimeText
                            - title
                            - views
                            - duration
                            - url
                        description: Array of search results
                      refinements:
                        type: array
                        items:
                          type: string
                        description: Array of search refinements or filters
                        example:
                          - video
                          - music
                          - image
                    required:
                      - contents
                required:
                  - data
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Bad request
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Invalid API key
        '403':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: >-
                      You are not subscribed to this API, please subscribe
                      before using
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: Internal Server Error
                  status_code:
                    type: number
                    example: 500
                  cost:
                    type: number
                    example: 0
                  explain:
                    type: string
                    example: Internal Server Error
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-rapidapi-key
      description: API Key

````