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

# YouTube SERP

> Retrieves organic search results from YouTube



## OpenAPI

````yaml post /youtube-serp
openapi: 3.0.0
info:
  title: Growth Marketing API
  description: API for company information, logos, MOZ metrics, and SERP data
  version: 1.0.0
  contact:
    name: Growth Marketing AI
    url: https://growthmarketing.ai
servers:
  - url: https://api.growthmarketing.ai
    description: Production server
security:
  - ApiKeyAuth: []
paths:
  /youtube-serp:
    post:
      summary: YouTube SERP
      description: Retrieves organic search results from YouTube
      operationId: getYouTubeSerp
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - keyword
              properties:
                keyword:
                  type: string
                  description: Search term
                  example: audi
                language_code:
                  type: string
                  description: Language code
                  default: en
                  example: en
                location_code:
                  type: integer
                  description: Location code (2840 for US)
                  default: 2840
                  example: 2840
                device:
                  type: string
                  description: Device type
                  default: desktop
                  enum:
                    - desktop
                    - mobile
                  example: desktop
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      data:
                        type: object
                        properties:
                          api:
                            type: string
                            example: serp
                          function:
                            type: string
                            example: live
                          se:
                            type: string
                            example: youtube
                          se_type:
                            type: string
                            example: organic
                          keyword:
                            type: string
                            example: audi
                          language_code:
                            type: string
                            example: en
                          location_code:
                            type: integer
                            example: 2840
                          device:
                            type: string
                            example: desktop
                      result:
                        type: array
                        items:
                          $ref: '#/components/schemas/YouTubeSerpResult'
components:
  schemas:
    YouTubeSerpResult:
      type: object
      properties:
        type:
          type: string
          example: video
        rank_group:
          type: integer
          example: 1
        rank_absolute:
          type: integer
          example: 1
        title:
          type: string
          example: Example Video Title
        url:
          type: string
          example: https://www.youtube.com/watch?v=example
        channel_title:
          type: string
          example: Channel Name
        channel_url:
          type: string
          example: https://www.youtube.com/channel/example
        channel_image:
          type: string
          example: https://yt3.ggpht.com/example
        duration:
          type: string
          example: '10:30'
        views:
          type: integer
          example: 1000000
        uploaded_date:
          type: string
          format: date
          example: '2024-01-01'
        description:
          type: string
          example: Video description
        thumbnail_url:
          type: string
          example: https://i.ytimg.com/vi/example/default.jpg
        live:
          type: boolean
          example: false
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````