Google 搜尋 API

Google 搜尋 API

API 詳情

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

説明

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

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

---

請求

HTTP 請求

---

cURL

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

Python

import requests

params = {
    "engine": "google",
    "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",
  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&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',
        '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")
    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";
        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" +
            "&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	字符串	是	查詢參數	coffee

語言地區

名稱	類型	必填項	描述	範例
location	字符串	否	參數定義您希望搜尋從哪裡發起。如果有多個 location 與請求的位置匹配，我們將選擇最受歡迎的一個。如果您需要更精確的控制，請前往 /locations.json API。location 和 uule 參數不能一起使用。如果省略 location，搜尋可能會採用代理的位置。	Japan-Tokyo
uule	字符串	否	使用Google編碼的位置進行搜尋。uule 和 location 參數不能一起使用。	-

Google 高級參數

名稱	類型	必填項	描述	範例
ludocid	字符串	否	定義要爬取的 Google 商家列表的 ID (CID)	-
lsig	字符串	否	用於強制顯示知識圖譜地圖視圖的參數。您可以使用我們的 本地套件 API 或 Google本地 API 找到 lsig ID。 lsig ID 也可以通過 Google 在 Google我的商家 中使用的重定向獲得。	-
kgmid	字符串	否	定義要爬取的 Google知識圖譜列表的 ID (KGMID)，使用 kgmid 參數的搜尋將返回原始加密搜尋參數的結果。對於某些搜尋，kgmid 可能會覆蓋除 start 和 num 參數之外的所有其他參數	-
si	字符串	否	定義要爬取的 Google搜尋的緩存搜尋參數	-
ibp	字符串	否	負責渲染某些元素的佈局和擴展	-
uds	字符串	否	用於過濾搜尋的參數。它是Google提供的字串過濾器。uds 值在過濾器部分提供，每個過濾器提供 uds、q 和 serpapi_link 值。	-

語言地區

名稱	類型	必填項	描述	範例
google_domain	字符串	否	該參數定義要使用的 Google網域。預設值為 google.com。前往 Google網域頁面 以獲取支持的 谷歌網域的完整清單。	-
gl	字符串	否	模擬本地搜尋可以提高特定國家/地區搜尋結果的相關性。gl 參數值是兩個字母的國家/地區代碼。前往 Google國家/地區頁面 以獲取支持的 Google 國家/地區的完整清單。	Amgola-ao
hl	字符串	否	主機語言 指定 谷歌搜尋的使用者介面 (UI) 語言。前往 Google語言頁面 以獲取支援的 谷歌語言的完整清單。	Akan-ak
cr	字符串	否	國家限制，指定搜尋結果限於特定國家/地區的網站/頁面。前往 Googlecr 國家/地區頁面 以獲取支持的國家/地區的完整清單。	countryDE
lr	字符串	否	語言限制，指定搜尋結果為特定語言的網站/頁面。 前往 Googlelr 語言頁面 以獲取支持的語言的完整清單。	lang_fr

高級過濾器

名稱	類型	必填項	描述	範例
tbs	字符串	否	(要搜尋的) 參數定義了在常規查詢欄位中無法實現的高級搜尋參數。(例如，專利、日期、新聞、影片、圖片、應用程式或文字內容的高級搜尋)	-
safe	字符串	否	參數定義成人內容的過濾級別	active或off
nfpr	布爾值	否	當原始查詢拼寫錯誤時，此參數定義從查詢中排除結果的自動校正	true或false
filter	布爾值	否	該參數定義 "相似結果" 和 "省略結果" 過濾器是開啟還是關閉true或false	true或false

分頁

名稱	類型	必填項	描述	範例
start	数值	否	搜尋結果的起始索引，指定應包含在搜尋結果中的第一個匹配項。谷歌本地結果僅接受 20 的倍數 (例如，第二頁結果為 20，第三頁結果為 40 等) 作為 start 值。	0
num	数值	否	限制結果數量 指定要在搜尋結果頁面中顯示的搜尋結果數量。使用 num 可能會引入延遲，和/或阻止包含特殊結果類型。除非嚴格需要增加每頁的結果數量，否則最好省略此參數。 結果 不保證 具有 num 中指定的結果數量	10

SerpApi 參數

名稱	類型	必填項	描述	範例
engine	字符串	是	將參數設置為 google (預設值) 以使用 Google API 引擎。	google
no_cache	布爾值	否	即使已有緩存版本，該參數也會強制 SerpApi 獲取 Google 搜尋結果。只有在查詢和所有參數完全相同的情況下才會提供緩存。緩存有效期為 1 小時。緩存搜尋是免費的，不會計入您每月的搜尋次數。可以將其設置為 false (預設值) 以允許從緩存中獲取結果，或設置為 true 以禁止從緩存中獲取結果。no_cache 和 async 參數不應一起使用。	true或false
api_key	字符串	是	參數定義要使用的 SerpApi 私鑰。	YOUR_API_KEY

---

回應

成功 200

回應主體

{
  "code": 200,
  "search_metadata":
    {
        "id":"8a446ec6-522d-4a37-b4b8-dc28e9413ac6",
        "json_endpoint":"https://webserp.abcproxy.com/files/2ae5d93f43d905ea/8a446ec6-522d-4a37-b4b8-dc28e9413ac6.json",
        "created_at":"2025-04-02 09:21:16",
        "google_url":"https://www.google.com/search?filter=0&ie=UTF-8&oe=UTF-8&oq=Coffee12&q=Coffee12&sourceid=chrome",
        "raw_html_file":"https://webserp.abcproxy.com/files/2ae5d93f43d905ea/8a446ec6-522d-4a37-b4b8-dc28e9413ac6.html",
        "xray_html_file":"https://webserp.abcproxy.com/files/2ae5d93f43d905ea/8a446ec6-522d-4a37-b4b8-dc28e9413ac6.xray",
        "total_time_taken":"9.2197",
    },
  "search_parameters":
    {
        "engine":"google",
        "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",
    },
    "organic_results":
	[
        {
        "rank":1,
        "title":"Coffee",
        "url":"https://en.wikipedia.org/wiki/Coffee",
        "site_links":
            {
            "url":"https://en.wikipedia.org/wiki/Coffee_bean",
            "title":"Coffee bean",
            },
        "origin_site":"Wikipedia",
        "img":
            {
                "1":"https://encrypted-tbn0.gstati......h_CyKzA7hfwZKo&usqp=CAE&s",
            },
        }
		......
	],
	"shopping_results_ads":
    [
        {
        "url":"https://www.amazon.com.br/Caffeine-Army-Supercoffee-Original-.....mid=A301RVPME31WTN",
        "title":"Supercoffee Original/Tradicional - Economic Size (380g) - Caffeine ArmySupercoffee Original/Tradicional - Economic Size (380g) - Caffeine Army",
        "description":"Amazon.com.brAmazon.com.br",
        "price":"208,00 R$",
        }
        ......
    ]
  }
}

響應字段

名稱	類型	備註
ads	對象數組	贊助搜尋 結果
ai_overview	對象	AI 回應
albums	對象數組	專輯
also_ask	對象數組	其他 使用者的 問題
answer_box	對象	問題 方塊
available_on	對象數組	可用於 播放服務提供商，通常在 搜尋 電影 時出現
buying_guide	對象數組	購買 指南
cast	對象數組	角色
complementary_results	對象數組	人物 的小型介紹標籤 – 右上角
discussions_and_forums	對象數組	討論 和 論壇
dmca_messages	對象數組	底部的 版權 通知
episode_guide	對象數組	劇集 指南
events_results	對象數組	附近 活動
filters	對象數組	網頁頂部的 過濾器
find_results_on	對象數組	網站上的 搜尋 結果
grammar_check	對象數組	語法 檢查 訊息
hereto	對象數組	相關 介紹
immersive_products	對象數組	沉浸式 產品 列表
inline_images	對象數組	搜尋 結果 中的 圖片
jobs_results	對象數組	工作 搜尋 相關 結果
knowledge_graph	對象數組	知識 圖譜
local_map	對象數組	地圖 圖片 連結
local_results	對象數組	商家 資訊 位置
menu_highlights	對象數組	菜單 高亮
movies	對象數組	電影 相關
organic_results	對象數組	搜尋 結果 中的 常見 資料
pagination	對象	分頁
perspectives	對象數組	觀點
places_sit	對象數組	關於 NFL
places_sites	對象數組	食譜 結果 – 地名
players	對象數組	運動員
popular_destinations	對象數組	熱門 目的地
product_sites	對象數組	產品 網站
questions_and_answers	對象數組	一組 問題 和相應的 答案，用於解答特定 主題 或 領域 的 問題
recipes_results	對象數組	食譜 結果
refine_this_search	對象數組	精煉 此 搜尋 – 網頁頂部的分類
related_brands	對象數組	人們 也 從 購買
related_categories	對象數組	相關 類別，在 搜尋 汽車 時出現 – 探索 更多
related_searches	對象	omitempty。如果欄位值為零或空引用，則不會在 JSON 中創建相應的 鍵值 對
scholarly_articles	對象數組	學術 文章
search_information	對象	搜尋 資訊
search_metadata	對象	包含 時間 和 狀態資訊
search_parameters	對象	商家詳細資訊 和 位置資訊
shopping_results	對象數組	線上 購物
shopping_results_ads	對象數組	贊助 廣告
showtimes	對象數組	放映時間 結果，在 搜尋 目前正在放映的 電影 時出現
songs	對象數組	歌曲
sports_results	對象數組	體育 活動 資訊
things_to_know	對象數組	其他 使用者 想法
top_sights	對象數組	頭條 新聞
top_stories	對象數組	頭條 故事
total_results_count	数值	搜尋 結果 總數
tvShows	對象數組	電視 節目 相關
twitter_results	對象數組	Twitter 結果
url	字符串	使用者 的 搜尋 參數
videos	對象數組	搜尋 結果 中的 影片

錯誤回應

常見錯誤

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"
}

---