YouTubeget/audio/videos

Audio Videos

Audio
Cost / request

$0.01

Response format

JSON

Protocol

REST

About this endpoint

Access YouTube data through agntdata: Audio Videos. Get the latest video published under an audio. Responses are structured JSON for AI agents, analytics, and automation — one API key instead of juggling upstream accounts. Ideal when you need video metadata, channel discovery, comments, subtitles, and recommendations programmatically.

Use cases

AI agents that need YouTube data in structured form
Analytics and monitoring pipelines for YouTube content
Research and GTM workflows that combine YouTube signals with other data

Parameters

NameInTypeRequiredDescription
audio_idquerystringrequiredDefault: 8gVbCk4SPwoLeXo4TlN2bUFhRHcSC3l6OE5Tdm1BYUR3Ggt4bl9ob1RQS0pzUSIKEggIOxDA_4zNAyoKEggIOxDA_4zNAxoLeG5faG9UUEtKc1EogZKBocKFmYSVAQ==

Responses

Response

{
  "title": "ChannelVideos",
  "type": "object",
  "properties": {
    "continuation_token": {
      "title": "Continuation Token",
      "type": "string"
    },
    "videos": {
      "title": "Videos",
      "type": "array",
      "items": {
        "title": "Video",
        "required": [
          "video_id"
        ],
        "type": "object",
        "properties": {
          "video_id": {
            "title": "Video Id",
            "type": "string"
          },
          "title": {
            "title": "Title",
            "type": "string"
          },
          "author": {
            "title": "Author",
            "type": "string"
          },
          "number_of_views": {
            "title": "Number Of Views",
            "type": "integer"
          },
          "video_length": {
            "title": "Video Length",
            "type": "string"
          },
          "description": {
            "title": "Description",
            "type": "string"
          },
          "is_live_content": {
            "title": "Is Live Content",
            "type": "string"
          },
          "published_time": {
            "title": "Published Time",
            "type": "string"
          },
          "channel_id": {
            "title": "Channel Id",
            "type": "string"
          },
          "category": {
            "title": "Category",
            "type": "string"
          },
          "type": {
            "title": "Type",
            "type": "string",
            "default": "NORMAL"
          },
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "thumbnails": {
            "title": "Thumbnails",
            "type": "array",
            "items": {
              "type": "object"
            }
          }
        },
        "description": "Schema Class for a Youtube video"
      }
    }
  },
  "description": "Channel Videos"
}

Agent / Developer Schema

Machine-readable formats for integrating this endpoint into AI agents and toolchains.

{
  "operationId": "Audio_Videos",
  "method": "get",
  "path": "/audio/videos",
  "summary": "Audio Videos",
  "description": "Get the latest video published under an audio",
  "parameters": [
    {
      "name": "audio_id",
      "in": "query",
      "required": true,
      "schema": {
        "type": "string",
        "default": "8gVbCk4SPwoLeXo4TlN2bUFhRHcSC3l6OE5Tdm1BYUR3Ggt4bl9ob1RQS0pzUSIKEggIOxDA_4zNAyoKEggIOxDA_4zNAxoLeG5faG9UUEtKc1EogZKBocKFmYSVAQ=="
      }
    }
  ],
  "responses": [
    {
      "statusCode": "200",
      "description": "Response",
      "content": {
        "application/json": {
          "schema": {
            "title": "ChannelVideos",
            "type": "object",
            "properties": {
              "continuation_token": {
                "title": "Continuation Token",
                "type": "string"
              },
              "videos": {
                "title": "Videos",
                "type": "array",
                "items": {
                  "title": "Video",
                  "required": [
                    "video_id"
                  ],
                  "type": "object",
                  "properties": {
                    "video_id": {
                      "title": "Video Id",
                      "type": "string"
                    },
                    "title": {
                      "title": "Title",
                      "type": "string"
                    },
                    "author": {
                      "title": "Author",
                      "type": "string"
                    },
                    "number_of_views": {
                      "title": "Number Of Views",
                      "type": "integer"
                    },
                    "video_length": {
                      "title": "Video Length",
                      "type": "string"
                    },
                    "description": {
                      "title": "Description",
                      "type": "string"
                    },
                    "is_live_content": {
                      "title": "Is Live Content",
                      "type": "string"
                    },
                    "published_time": {
                      "title": "Published Time",
                      "type": "string"
                    },
                    "channel_id": {
                      "title": "Channel Id",
                      "type": "string"
                    },
                    "category": {
                      "title": "Category",
                      "type": "string"
                    },
                    "type": {
                      "title": "Type",
                      "type": "string",
                      "default": "NORMAL"
                    },
                    "keywords": {
                      "title": "Keywords",
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "thumbnails": {
                      "title": "Thumbnails",
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    }
                  },
                  "description": "Schema Class for a Youtube video"
                }
              }
            },
            "description": "Channel Videos"
          },
          "example": {
            "videos": [
              {
                "video_id": "vrUENCsv_C8",
                "thumbnails": [
                  {
                    "url": "https://i.ytimg.com/vi/vrUENCsv_C8/oardefault.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQY=&rs=AOn4CLDjarGTLtkApEOcRV65i2EfFTbA-g",
                    "width": 405,
                    "height": 720
                  }
                ],
                "view_count": 16000000,
                "type": "SHORTS"
              },
              {
                "video_id": "QC0cE_5AgI0",
                "thumbnails": [
                  {
                    "url": "https://i.ytimg.com/vi/QC0cE_5AgI0/oardefault.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQY=&rs=AOn4CLCaWSpBQF7cj3EeCh4PvqjEX-dxzg",
                    "width": 405,
                    "height": 720
                  }
                ],
                "view_count": 48000000,
                "type": "SHORTS"
              },
              {
                "video_id": "LfZJLTe2aQc",
                "thumbnails": [
                  {
                    "url": "https://i.ytimg.com/vi/LfZJLTe2aQc/oardefault.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQY=&rs=AOn4CLDlU8iNURWAF4lg-CRSScwqJklCOA",
                    "width": 405,
                    "height": 720
                  }
                ],
                "view_count": 66000000,
                "type": "SHORTS"
              },
              {
                "video_id": "xn_hoTPKJsQ",
                "thumbnails": [
                  {
                    "url": "https://i.ytimg.com/vi/xn_hoTPKJsQ/oardefault.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQY=&rs=AOn4CLCcX5lyPqHlqbJAioeH6HJR89gmkg",
                    "width": 405,
                    "height": 720
                  }
                ],
                "view_count": 23000000,
                "type": "SHORTS"
              },
              {
                "video_id": "nTziHQ1fv1A",
                "thumbnails": [
                  {
                    "url": "https://i.ytimg.com/vi/nTziHQ1fv1A/oar2.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQY=&rs=AOn4CLDBWiU9aTy7iIPxvuYCf8U5jqATnA",
                    "width": 405,
                    "height": 720
                  }
                ],
                "view_count": 12000000,
                "type": "SHORTS"
              },
              {
                "video_id": "3IiBPey_LZ0",
                "thumbnails": [
                  {
                    "url": "https://i.ytimg.com/vi/3IiBPey_LZ0/oardefault.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQY=&rs=AOn4CLAQvQdhgJ7ABj5OfoxaYLrclJa5nw",
                    "width": 405,
                    "height": 720
                  }
                ],
                "view_count": 28000000,
                "type": "SHORTS"
              },
              {
                "video_id": "FffWnOcNocM",
                "thumbnails": [
                  {
                    "url": "https://i.ytimg.com/vi/FffWnOcNocM/oar2.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQY=&rs=AOn4CLDKCy1Q3JPxdPWH4cwktAIw8xhnjQ",
                    "width": 405,
                    "height": 720
                  }
                ],
                "view_count": 23000000,
                "type": "SHORTS"
              },
              {
                "video_id": "3EfnSzKlpqI",
                "thumbnails": [
                  {
                    "url": "https://i.ytimg.com/vi/3EfnSzKlpqI/hq720.jpg?sqp=-oaymwEdCJUDENAFSFXyq4qpAw8IARUAAIhCcAHAAQbQAQE=&rs=AOn4CLD26rbSj3C02TpTVNuH-zpajnfvyA",
                    "width": 405,
                    "height": 720
                  }
                ],
                "view_count": 43000000,
                "type": "SHORTS"
              },
              {
                "video_id": "YbU87KMkWlU",
                "thumbnails": [
                  {
                    "url": "https://i.ytimg.com/vi/YbU87KMkWlU/hq720.jpg?sqp=-oaymwEdCJUDENAFSFXyq4qpAw8IARUAAIhCcAHAAQbQAQE=&rs=AOn4CLBCmi5_iK9dPfh3gpH1htIw9LOykg",
                    "width": 405,
                    "height": 720
                  }
                ],
                "view_count": 53000000,
                "type": "SHORTS"
              },
              {
                "video_id": "yM9CNZQZZIg",
                "thumbnails": [
                  {
                    "url": "https://i.ytimg.com/vi/yM9CNZQZZIg/oardefault.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQY=&rs=AOn4CLALxTN0BFY_Og0k1D1Y73BwQsBDvw",
                    "width": 405,
                    "height": 720
                  }
                ],
                "view_count": 45000000,
                "type": "SHORTS"
              },
              {
                "video_id": "cRcNk_13gu8",
                "thumbnails": [
                  {
                    "url": "https://i.ytimg.com/vi/cRcNk_13gu8/oardefault.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQY=&rs=AOn4CLAj23QesHlYENxlxjdPPUbDmb5VzA",
                    "width": 405,
                    "height": 720
                  }
                ],
                "view_count": 45000000,
                "type": "SHORTS"
              },
              {
                "video_id": "6iQQFQ-vuyU",
                "thumbnails": [
                  {
                    "url": "https://i.ytimg.com/vi/6iQQFQ-vuyU/oardefault.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQY=&rs=AOn4CLBg-T7CUCkIUd7s32Pisvofvhue8Q",
                    "width": 405,
                    "height": 720
                  }
                ],
                "view_count": 56000000,
                "type": "SHORTS"
              },
              {
                "video_id": "dCOkzJy9jy4",
                "thumbnails": [
                  {
                    "url": "https://i.ytimg.com/vi/dCOkzJy9jy4/oar2.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQY=&rs=AOn4CLA3IxZY-RXmcsdQz1T6Nayvgatl4Q",
                    "width": 405,
                    "height": 720
                  }
                ],
                "view_count": 97000000,
                "type": "SHORTS"
              },
              {
                "video_id": "mKzAqP2gpYU",
                "thumbnails": [
                  {
                    "url": "https://i.ytimg.com/vi/mKzAqP2gpYU/oardefault.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQY=&rs=AOn4CLBm4ZJhL8fE6sD24LTXdktmyEVBmQ",
                    "width": 405,
                    "height": 720
                  }
                ],
                "view_count": 74000000,
                "type": "SHORTS"
              },
              {
                "video_id": "ZsljZOFbvaI",
                "thumbnails": [
                  {
                    "url": "https://i.ytimg.com/vi/ZsljZOFbvaI/oar2.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQY=&rs=AOn4CLAf_Z9fflSVjwaJ6Ud7OT8SeQaA5w",
                    "width": 405,
                    "height": 720
                  }
                ],
                "view_count": 19000000,
                "type": "SHORTS"
              }
            ],
            "continuation_token": "4qmFsgL5AhIRRkVzZnZfYXVkaW9fcGl2b3QaxAJDQkI2a0FGRFFtTlJRa0p3UlhWbldrSkRhamhMUXpOc05rOUZOVlJrYlRGQ1dWVlNNMFZuZERWbGFtaFBWVE5hZEZGWFJrVmtlRzlNWlVjMVptRkhPVlZWUlhSTFl6RkZhVU5vU1VsRFJITlJkMUF0VFhwUlRYRkRhRWxKUTBSelVYZFFMVTE2VVUxcFJWRnZVRTVFYjNoT2VrVjVUbFJOTTA1cVNYZE5ha0V5UzJjd1MwTXphR1pOTTBKTFVqSlNhVk5XV1RUeUJWc0tUaElfQ2d0NWVqaE9VM1p0UVdGRWR4SUxlWG80VGxOMmJVRmhSSGNhQzNodVgyaHZWRkJMU25OUklnb1NDQWc3RU1EX2pNMERLZ29TQ0FnN0VNRF9qTTBER2d0NGJsOW9iMVJRUzBwelVTaUJrb0dod29XWmhKVUKaAhxicm93c2UtZmVlZEZFc2Z2X2F1ZGlvX3Bpdm90"
          }
        }
      }
    },
    {
      "statusCode": "422",
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "title": "HTTPValidationError",
            "type": "object",
            "properties": {
              "detail": {
                "title": "Detail",
                "type": "array",
                "items": {
                  "title": "ValidationError",
                  "required": [
                    "loc",
                    "msg",
                    "type"
                  ],
                  "type": "object",
                  "properties": {
                    "loc": {
                      "title": "Location",
                      "type": "array",
                      "items": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "integer"
                          }
                        ]
                      }
                    },
                    "msg": {
                      "title": "Message",
                      "type": "string"
                    },
                    "type": {
                      "title": "Error Type",
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "example": {
            "detail": [
              {
                "loc": [],
                "msg": "",
                "type": ""
              }
            ]
          }
        }
      }
    }
  ]
}

Pricing

$0.01per successful request

Credits are deducted from your agntdata balance on each successful API call. Failed requests (4xx/5xx) are not charged.

Related endpoints

Start using this endpoint

Generate your API key and make your first call in under a minute. Free tier available with transparent pricing.

YouTube APIYouTube data APIaudio videos APIAI agents data APIYouTube APIYouTube data APIYouTube for AI agents