YouTube Search List

1积分/次
ae_youtube_search_list

通过关键词、主题或位置搜索 YouTube 视频、频道和播放列表。

视频社交娱乐
1积分/次

价格说明

1积分/次
条件费用
每次调用1积分/次

工具参数

未传入的可选参数将使用平台默认值。

参数类型必填说明默认值
qstring否Textual search terms to match.—
partenum (snippet)是The *part* parameter specifies a comma-separated list of one or more search resource properties that the API response will include. Set the parameter value to snippet.—
typestring否Restrict results to a particular set of resource types from One Platform.—
orderenum (searchSortUnspecified | date | rating | viewCount | relevance | title | videoCount)否Sort order of the results.—
forMineboolean否Search for the private videos of the authenticated user.—
topicIdstring否Restrict results to a particular topic.—
locationstring否Filter on location of the video—
channelIdstring否Filter on resources belonging to this channelId.—
eventTypeenum (none | upcoming | live | completed)否Filter on the livestream status of the videos.—
pageTokenstring否Optional opaque pagination token. Omit on the first request. To fetch the next page, copy nextPageToken exactly from the previous response into pageToken and call this same endpoint again, keeping the playlist/channel/video identifiers, filters, part and other query settings unchanged. Use prevPageToken to go back when provided. Do not invent tokens or use a token from another query. Stop when nextPageToken is absent; no nextPageToken means no further page is advertised, even if a page contains fewer items than maxResults.—
videoTypeenum (videoTypeUnspecified | any | movie | episode)否Filter on videos of a specific type.—
maxResultsinteger否Maximum number of items requested per page, not a limit on the total query results. Use nextPageToken as pageToken to retrieve subsequent pages when available. Direct API tests accepted values above 50 but capped the effective page size at 50; requesting more does not increase page size. Zero is accepted and can return an empty page.—
regionCodestring否Display the content as seen by viewers in this country.—
safeSearchenum (safeSearchSettingUnspecified | none | moderate | strict)否Indicates whether the search results should include restricted content as well as standard content.—
channelTypeenum (channelTypeUnspecified | any | show)否Add a filter on the channel search.—
forDeveloperboolean否Restrict the search to only retrieve videos uploaded using the project id of the authenticated user.—
videoCaptionenum (videoCaptionUnspecified | any | closedCaption | none)否Filter on the presence of captions on the videos.—
videoLicenseenum (any | youtube | creativeCommon)否Filter on the license of the videos.—
videoDurationenum (videoDurationUnspecified | any | short | medium | long)否Filter on the duration of the videos.—
locationRadiusstring否Filter on distance from the location (specified above).—
publishedAfterstring否Filter on resources published after this date.—
videoDimensionenum (any | 2d | 3d)否Filter on 3d videos.—
forContentOwnerboolean否Search owned by a content owner.—
publishedBeforestring否Filter on resources published before this date.—
videoCategoryIdstring否Filter on videos in a specific category.—
videoDefinitionenum (any | standard | high)否Filter on the definition of the videos.—
videoEmbeddableenum (videoEmbeddableUnspecified | any | true)否Filter on embeddable videos.—
videoSyndicatedenum (videoSyndicatedUnspecified | any | true)否Filter on syndicated videos.—
relevanceLanguagestring否Return results relevant to this language.—
onBehalfOfContentOwnerstring否*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.—
videoPaidProductPlacementenum (videoPaidProductPlacementUnspecified | any | true)否Filter by paid product placement status. Options: videoPaidProductPlacementUnspecified, any, true.—

调用示例

复制请求代码,查看对应的返回示例。

POST/agent-api/v1/tool/executeX-Api-Key
请求代码request.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_youtube_search_list' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "maxResults": 50,
    "order": "date",
    "part": "snippet",
    "publishedAfter": "2026-11-04T16:00:00Z",
    "publishedBefore": "2026-11-12T03:03:26.565Z",
    "q": "Huawei glasses",
    "type": "video"
  }
}'
返回示例response.json
JSON部分内容
{
  "etag": "Z_vlPJLLIQMWe3e5UYo0E3zR-WA",
  "items": [
    {
      "etag": "HuAJ-U7bH-QPeHE--MWYJljBySs",
      "id": {
        "kind": "youtube#video",
        "videoId": "G7h1xLFwiPM"
      },
      "kind": "youtube#searchResult",
      "snippet": {
        "channelId": "UCoZQStUZBYPDytmcyhhRsTA",
        "channelTitle": "1 วัน 1000 เรื่องราว",
        "description": "รีวิวแว่นตาเสียงอัจฉริยะ (Smart Audio Glasses) ศูนย์ไทยแท้ 2 รุ่นเด่นที่รองรับการตัดเลนส์สายตาจริง ได้แก่ OWNDAYS × HUAWEI Eyewear ...",
        "liveBroadcastContent": "none",
        "publishTime": "2026-11-11T05:12:00Z",
        "title": "แว่น AI EP.6 OWNDAYS vs Xiaomi แว่นเสียงตัดเลนส์"
      }
    }
  ],
  "kind": "youtube#searchListResponse",
  "pageInfo": {
    "resultsPerPage": 2,
    "totalResults": 54
  },
  "regionCode": "SG"
}

返回示例仅展示部分内容,不代表完整响应;复制内容为合法 JSON。