Google 新聞 API

Google 新聞 API

API 詳情

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

説明

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

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

---

請求

HTTP 請求

cURL

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

Python

import requests

params = {
    "engine": "google_news",
    "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_news",
  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_news&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_news',
        '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_news")
    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_news";
        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_news" +
            "&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

語言地區

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

高級參數

名稱	類型	必填項	描述	範例
topic_token	字符串	否	參數定義 Google 新聞主題令牌。它用於存取特定主題的新聞結果。 此參數不能與 q、故事_token 和 publication_token 參數一起使用。	-
publication_token	字符串	否	參數定義 Google 新聞出版物令牌。它用於存取特定出版商的新聞結果。 此參數不能與 q、故事_token 和 topic_token 參數一起使用。	CNN BBC
section_token	字符串	否	參數定義 Google 新聞部分令牌。它用於存取特定主題的子部分。 該令牌可以在我們的 JSON 回應或 Google 新聞頁面的 URL 中找到（在 URL 中，它是一個位於 /sections/ 之後的字元串） 此參數只能與 topic_token 或 publication_token 參數結合使用。	Business -> Economy
story_token	字符串	否	參數定義 Google 新聞故事令牌。它用於存取特定故事的完整報導的新聞結果。 該令牌可以在我們的 JSON 回應或 Google 新聞頁面的 URL 中找到（在 URL 中，它是一個位於 /stories/ 之後的字元串） 此參數不能與 q、topic_token 和 publication_token 參數一起使用。	-
so	字符串	否	參數定義排序方法。結果可以按相關性或日期排序。預設情況下，結果按相關性排序。支援的值列表為：0 - 相關性；1 - 日期 此參數只能與 故事_token 參數結合使用。	-

Serpapi 參數

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

---

回應

成功 200

回應主體

{
  "code": 200,
  "search_metadata":
    {				 
        "json_endpoint":"https://webserp.abcproxy.com/files/35422250ed41076e/533d1496-06f8-43e7-8c09-b97b0554c1d9.json",
        "created_at":"2025-04-02 16:54:57",
        "google_news_url":"https://news.google.com/search?q=coffee",
        "raw_html_file":"https://webserp.abcproxy.com/files/35422250ed41076e/533d1496-06f8-43e7-8c09-b97b0554c1d9.html",
        "xray_html_file":"https://webserp.abcproxy.com/files/35422250ed41076e/533d1496-06f8-43e7-8c09-b97b0554c1d9.xray",
        "total_time_taken":"7.7934",
        "id":"533d1496-06f8-43e7-8c09-b97b0554c1d9",
    },
  "search_parameters":
    {
        "engine":"google_news",
        "q":"Coffee",
        "api_key":"YOUR_API_KEY",
        "hl":"en",
        "gl":"us",
    },
    "news_results":
    [
        {
            "position":1,
            "title":"Dunkin' April Fools' Day giveaway",
            "stories":
             [
                {
                    "position":1,
                    "thumbnail":"/api/attachments/CC8iK0NnNXRkVWRUUm5OeWFuQmpOVzB5VFJERUF4aW1C......4-h64-p-df-rw",
                    "date":"2025-04-01T04:01:00Z",
                    "title":"No Pranks, Just Perks: Dunkin’ Is Giving Away a Million Free Coffees on April 1",
                    "link":....,
                }
                 ......
            ]
            ......
        }
    ],
   "related_topics":
    [
        {
        "name":"Coffeezilla",
        "topic_token":"CAAqKAgKIiJDQkFTRXdvTkwyY3ZNVEYwWnpWNU5uZzJlUklDWlc0b0FBUAE",
        }
        ......
    ],
}

響應字段

名稱	類型	描述
search_metadata	對象	包含 時間 和 狀態資訊
search_parameters	對象	包含查詢 參數 和 搜尋上下文
title	字符串	頁面 標題
top_stories_link	對象	聚焦 新聞連結
news_results	對象數組	新聞搜尋 結果
menu_links	對象數組	菜單連結
sub_menu_links	對象數組	子菜單連結
related_topics	對象數組	相關主題
related_publications	對象數組	相關 出版物
stories	對象	故事
highlight	字符串	高亮顯示 結果部分
story_token	字符串	故事令牌

錯誤回應

常見錯誤

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

---