Google 視頻 API

Google 視頻 API

API 詳情

端點 GET https://serpapi.abcproxy.com/search

説明

我們的 Google視頻 API 允許您從 Google 視頻 頁面抓取結果。此 API 可透過以下端點存取：/search?engine=google_videos。

使用者可以使用 GET 請求查詢以下網址：https://serpapi.abcproxy.com/search?engine=google_videos。請前往 工作臺 查看即時互動演示。

---

請求

HTTP 請求

cURL

curl -X GET "https://serpapi.abcproxy.com/search" \
  -d "engine=google_videos" \
  -d "q=Coffee" \
  -d "no_cache=false" \
  -d "api_key=YOUR_API_KEY"

Python

import requests

params = {
    "engine": "google_videos",
    "q": "Coffee",
    "no_cache": "false",
    "api_key": "YOUR_API_KEY"
}
response = requests.get("https://serpapi.abcproxy.com/search", params=params)
print(response.json())

Node.js

const axios = require('axios');

const params = {
  engine: "google_videos",
  q: "Coffee",
  no_cache: "false",
  api_key: "YOUR_API_KEY"
};

axios.get("https://serpapi.abcproxy.com/search", { params })
  .then(response => console.log(response.data));

HTTP

GET /search?engine=google_videos&q=Coffee&no_cache=false&api_key=YOUR_API_KEY HTTP/1.1
Host: serpapi.abcproxy.com

PHP

<?php
$client = new \GuzzleHttp\Client();
$response = $client->get('https://serpapi.abcproxy.com/search', [
    'query' => [
        'engine' => 'google_videos',
        'q' => 'Coffee',
        'no_cache' => 'false',
        'api_key' => 'YOUR_API_KEY'
    ]
]);
echo $response->getBody();

Golang

package main

import (
    "net/http"
    "io/ioutil"
    "log"
)

func main() {
    client := &http.Client{}
    req, _ := http.NewRequest("GET", "https://serpapi.abcproxy.com/search", nil)
    
    q := req.URL.Query()
    q.Add("engine", "google_videos")
    q.Add("q", "Coffee")
    q.Add("no_cache", "false")
    q.Add("api_key", "YOUR_API_KEY")
    req.URL.RawQuery = q.Encode()

    resp, _ := client.Do(req)
    body, _ := ioutil.ReadAll(resp.Body)
    log.Println(string(body))
}

C#

using System;
using System.Net.Http;

class Program
{
    static async Task Main()
    {
        var client = new HttpClient();
        var query = System.Web.HttpUtility.ParseQueryString(string.Empty);
        query["engine"] = "google_videos";
        query["q"] = "Coffee";
        query["no_cache"] = "false";
        query["api_key"] = "YOUR_API_KEY";
        
        var response = await client.GetAsync(
            $"https://serpapi.abcproxy.com/search?{query}"
        );
        Console.WriteLine(await response.Content.ReadAsStringAsync());
    }
}

Java

import java.net.*;
import java.io.*;

public class Main {
    public static void main(String[] args) throws Exception {
        String url = "https://serpapi.abcproxy.com/search" +
            "?engine=google_videos" +
            "&q=Coffee" +
            "&no_cache=false" +
            "&api_key=YOUR_API_KEY";
        
        HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();
        conn.setRequestMethod("GET");
        
        BufferedReader in = new BufferedReader(
            new InputStreamReader(conn.getInputStream())
        );
        String response = in.lines().collect(Collectors.joining());
        System.out.println(response);
    }
}

---

API 參數

搜索查詢

名稱	類型	必填項	描述	範例
q	字符串	是	該參數定義您要搜索的查詢內容。您可以使用在常規Google 視頻搜索中使用的任何內容。例如 book、game。我們還支援高級搜索查詢參數，如 as_dt 和 as_eq。請參閱 完整列表 了解支援的高級搜索查詢參數。	coffee

地理位置

名稱	類型	必填項	描述	範例
location	字符串	否	該參數定義搜索的發起位置。如果有多個位置與請求的位置匹配，我們將選擇最受歡迎的一個。如果您需要更精確的控制，請訪問 /locations.json API。location 和 uule 參數不能同時使用。建議在城市級別指定位置，以模擬真實用戶的搜索。如果省略位置，搜索可能會採用代理的位置。	Japan-Tokyo
uule	字符串	否	該參數是您要用於搜索的谷歌編碼位置。	-

語言地區

名稱	類型	必填項	描述	範例
google_domain	字符串	否	該參數定義要使用的谷歌域名。預設為 google.com。請訪問 谷歌域名頁面 查看支持的谷歌域名的完整列表。	-
gl	字符串	否	該參數定義用於谷歌搜索的國家。它是一個雙字母國家代碼。（例如，us 代表美國，uk 代表英國，fr 代表法國）。請訪問 谷歌國家頁面 查看支持的谷歌國家的完整列表。	Amgola-ao
hl	字符串	否	該參數定義用於谷歌搜索的語言。它是一個雙字母語言代碼。（例如，en 代表英語，es 代表西班牙語，fr 代表法語）。請訪問 谷歌語言頁面 查看支持的谷歌語言的完整列表。	Akan-ak
lr	字符串	否	該參數定義限制搜索的一種或多種語言。它使用 lang_{雙字母語言代碼} 來指定語言，並使用 `	作為分隔符。（例如，lang_fr

高級篩選器

名稱	類型	必填項	描述	範例
tbs	字符串	否	（待搜索）該參數定義了常規查詢字段中無法實現的高級搜索參數。（例如，對專利、日期、新聞、視頻、圖像、應用程序或文本內容的高級搜索）	-
safe	字符串	否	該參數定義成人內容的過濾級別。它可以設置為 active 或 off，預設情況下，谷歌會模糊顯示明確內容。	Active 或 Off
nfpr	布爾值	否	當原始查詢拼寫錯誤時，該參數定義自動糾正從查詢中排除的結果	true 或 false
filter	布爾值	否	該參數定義“相似結果”和“省略結果”的篩選器是開啟還是關閉。它可以設置為 1（預設）以啟用這些篩選器，或設置為 0 以禁用這些篩選器	true 或 false

分頁

名稱	類型	必填項	描述	範例
start	數值	否	該參數定義結果偏移量。它會跳過指定數量的結果。用於分頁。（例如，0（預設）是第一頁結果，10 是第二頁結果，20 是第三頁結果，依此類推）。	0
num	數值	否	該參數定義要返回的最大結果數。（例如，10（預設）返回 10 個結果，40 返回 40 個結果，100 返回 100 個結果）。	10

SerpApi 參數

名稱	類型	必填項	描述	範例
engine	字符串	是	將參數設置為 google_videos 以使用谷歌視頻 API 引擎。	google_videos
no_cache	布爾值	否	該參數將強制 SerpApi 獲取谷歌視頻結果，即使已經存在緩存版本。只有當查詢和所有參數完全相同時，才會提供緩存。緩存 1 小時後過期。緩存搜索是免費的，不計入您每月的搜索次數。它可以設置為 false（預設）以允許使用緩存結果，或設置為 true 以禁止使用緩存結果。no_cache 和 async 參數不應同時使用。	true 或 false
api_key	字符串	是	該參數定義要使用的 SerpApi 私鑰。	YOUR_API_KEY

---

回應

成功 200

回應主體

{
  "code": 200,
  "search_metadata":
    {
        "google_url":"https://www.google.com/search?filter=0&q=coffee&udm=7",
        "raw_html_file":"https://webserp.abcproxy.com/files/dfea92b11ed6a437/3443f61c-77a5-4577-9c0b-13e964642ae1.html",
        "xray_html_file":"https://webserp.abcproxy.com/files/dfea92b11ed6a437/3443f61c-77a5-4577-9c0b-13e964642ae1.xray",
        "total_time_taken":"5.3540",
        "id":"3443f61c-77a5-4577-9c0b-13e964642ae1",
        "json_endpoint":"https://webserp.abcproxy.com/files/dfea92b11ed6a437/3443f61c-77a5-4577-9c0b-13e964642ae1.json",
        "created_at":"2025-04-02 16:41:51",
    },
  "search_parameters":
    {
        "engine":"google_videos",
        "q":"Coffee",
        "location_requested":"Austin, Texas, United States",
        "location_used":"Austin,Texas,United States",
        "google_domain":"google.com",
        "api_key":"YOUR_API_KEY",
        "hl":"en",
        "gl":"us",
    },
    "video_results":
    {
        "position":1,
        "displayed_link":"www.youtube.com › watch",
        "snippet":"I think all coffee geeks have to have hair that defies gravity. 13:57 Go to channel How a coffee champion actually brews at home",
        "thumbnail":"https://i.ytimg.com/vi/e747SIBmWPE/mqdefau....EFCJQBEFM&rs=AMzJL3lov-aVyHMSnF8kNeWtFYv19aZtbA",

        "link":"https://www.youtube.com/watch?v=e747SIBmWPE",
        "video_link":"#",
        "key_moments":
        [
            {
                "title":"Mindset",
                "time":"00:00",
                "link":"https://www.youtube.com/watch?v=e747SIBmWPE&t=0",
                "thumbnail":"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSKBhatF_lT__NJ_x1LRa4K8sKCG_ipqcpHct6DLAz7Tw&s",
            },
            {
                "link":"https://www.youtube.com/watch?v=e747SIBmWPE&t=68",
                "thumbnail":"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd....un9MdXzm7QITq-7jg&s",
                "title":"Kopi Luwak",
                "time":"01:08",
            },
            ......
        ],
            ......
     },
  }
}

響應字段

名稱	類型	備註
search_metadata	對象	包含 計時 和 狀態資訊
search_parameters	對象	包含查詢 參數 和 搜索上下文
video_results	對象數組	視頻 結果區域
related_searches	對象數組	用戶還搜索 - 區域

錯誤回應

常見錯誤

HTTP 狀態	錯誤代碼	描述
200	400	API 私鑰不能為空
200	401	參數錯誤
200	402	API 私鑰錯誤
200	403	餘額不足
200	404	扣費失敗
200	405	記錄使用次數失敗
200	406	不支援的引擎
200	407	網路錯誤
200	408	檔案未找到
200	409	限制參數錯誤
200	410	構建 URL 錯誤
200	411	查詢最近記錄失敗
200	412	未找到 JSON 檔案
200	413	獲取 HTML 錯誤
200	414	HTML 為空
200	429	請求過多

錯誤範例

{
  "code": 400,
  "message": "API Key can not be empty"
}

---