Google 本地 API

Google 本地 API

API 詳情

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

説明

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

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

---

請求

HTTP 請求

cURL

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

Python

import requests

params = {
    "engine": "google_local",
    "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_local",
  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_local&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_local',
        '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_local")
    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_local";
        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_local" +
            "&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 本地搜尋中使用的任何內容。	coffee

地理位置

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

語言地區

名稱	類型	必填項	描述	範例
google_domain	字符串	否	參數定義要使用的 Google 域名。它預設為 google.com。前往 Google 域名 以獲取支持的 Google 域名的完整清單。	-
gl	字符串	否	參數定義用於 Google 本地搜尋的國家/地區。它是一個兩個字母的國家/地區代碼。（例如，us 表示美國，uk 表示英國，或 fr 表示法國）前往 Google 國家/地區 以獲取支持的 Google 國家/地區的完整清單。	Amgola-ao
hl	字符串	否	參數定義用於 Google 本地搜尋的語言。它是一個兩個字母的語言代碼。（例如，en 表示英語，es 表示西班牙語，或 fr 表示法語）前往 Google 語言以獲取支持的 Google 語言 的完整清單。	Akan-ak

高級參數

名稱	類型	必填項	描述	範例
ludocid	字符串	否	參數定義您要抓取的 Google 我的商家列表的 ID (CID)。也稱為 Google 地點 ID。要獲取 ludocid，您可以使用 Google 的 CID 轉換器，或從 SerpApi 的 Google 地圖 API 獲取 data_cid。	"New York, NY, USA": 14414772292044717666.

高級篩選器

名稱	類型	必填項	描述	範例
tbs	字符串	否	（要搜尋的）參數定義了在常規查詢欄位中無法使用的高級搜尋參數。（例如，專利、日期、新聞、視頻、圖片、應用程式或文字內容的高級搜尋）	-

分頁

名稱	類型	必填項	描述	範例
start	數值	否	搜尋結果的起始索引，指定應包含在搜尋結果中的第一個匹配項	0

Serpapi 參數

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

---

回應

成功 200

回應主體

{
  "code": 200,
  "search_metadata":
    {
        "created_at":"2025-04-02 16:11:25",
        "google_url":"https://www.google.com/search?location=us&q=coffee&tbm=lcl",
        "raw_html_file":"https://webserp.abcproxy.com/files/a8ef8bdba824414b/715f4b9e-caf1-42b6-9f91-016badf3cc0b.html",
        "xray_html_file":"https://webserp.abcproxy.com/files/a8ef8bdba824414b/715f4b9e-caf1-42b6-9f91-016badf3cc0b.xray",
        "total_time_taken":"5.9268",
        "id":"715f4b9e-caf1-42b6-9f91-016badf3cc0b",
        "json_endpoint":"https://webserp.abcproxy.com/files/a8ef8bdba824414b/715f4b9e-caf1-42b6-9f91-016badf3cc0b.json",
    },
  "search_parameters":
    {
        "engine":"google_local",
        "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",
    },
    "url":"https://www.google.com/search?location=us&q=coffee&tbm=lcl",
    "local_results":
    [
        {
        "title":"San Fernando Coffee Company",
        "address":"California, Moorpark",
        "place_id":"7902348745307883272",
        "position":1,
        "rating":"5.0",
        "reviews":"(15)",
        "price":"$1-10",
        "gps_coordinates":
        {
            "latitude":"34.2681423",
            "longitude":"-118.8976022",
        },
            ......
     ],
    "pagination":
    {
        "current":1,
     	"next":"/search?q=coffee&sca_esv=6a9fea083e3aea47&tbm=lcl&ei=Kv.....2YmX87iMAxW_K1kFHcyhOLcQ8NMDegQIHBAe",
        "other_pages":
        {
        "2":"/search?q=coffee&sca_esv=6a9fea083e3aea47&tbm=lcl&ei=KvHsZ7GcDb_X5NoPzMP....1kFHcyhOLcQ8tMDegQIHBAM",
        "3":"/search?q=coffee&sca_esv=6a9fea083e3aea47&tbm=lcl&ei=KvHsZ7GcDb_X5NoPzMPiuQs&start...._K1kFHcyhOLcQ8tMDegQIHBAO",
            ......
    	 },
    },
  }
}

響應字段

名稱	類型	範例
search_metadata	對象	包含 時間 和 狀態資訊
search_parameters	對象	包含查詢 參數 和 搜尋上下文
Url	字符串	用戶訪問的 連結
LocalResults	對象數組	商家詳情 和 位置資訊
MorePlaces	對象數組	地圖圖片連結
Pagination	對象	分頁資料資訊

錯誤回應

常見錯誤

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

---