SerpBase

Google News Search — API リファレンス

POST
利用可能
/google/news/search

ニュース検索

トピックやキーワードで Google ニュースを検索します。記事と発行元の項目は取得元の結果によります。

type
news
result
news
課金
1 credits

トピックやキーワードで Google ニュースを検索します。記事と発行元の項目は取得元の結果によります。

パラメータ
q
必須
string

必須

検索クエリ文字列。

hl
任意
string

任意

言語コード。デフォルトは en。

gl
任意
string

任意

国コード。デフォルトは us。

page
任意
number

任意

1 始まりのページ番号。デフォルトは 1。

query
例
string

カタログの例。必須項目は API が検証します。

例: "semiconductor supply"

json
{
  "query": "semiconductor supply"
}
Playground で実行
レスポンスフィールド
query
必須
string

必須

リクエストから正規化されたクエリ。

page
必須
number

必須

現在の 1 始まりのページ番号。

news
任意
NewsResult[]

ニュース結果が解析された場合。

Google ニュースの結果。

NewsResult 結果アイテム構造
rank
必須
number

必須

このレスポンス内の 1 始まりの順位。

position
任意
number

利用可能な場合は rank のエイリアス。

position を期待するクライアント向けの正規化順位。

title
必須
string

必須

結果タイトル。

link
必須
string

必須

parser が返す主リンク。

url
任意
string

結果リンクを正規化できる場合に返ります。

正規化されたターゲット URL。通常は link と同じです。

source_url
任意
string

Google のリダイレクト元 URL がある場合のみ返ります。

デバッグと出所確認のために保持される元の Google URL。

display_url
任意
string

Google の表示テキストまたはドメインを取得できる場合。

表示 URL またはソースドメイン。

source
任意
string

発行元のテキストが解析された場合。

発行元・出典ラベル。

time
任意
string

Google が時刻テキストを公開する場合。

公開時刻の原文。

published_at
任意
string

解析時刻があればその別名。

正規化された公開時刻の別名。

snippet
任意
string

スニペットが解析された場合。

記事の要約スニペット。

thumbnail_url
任意
string

Google がサムネイルを公開している場合。

サムネイル URL。

thumbnail
任意
string

利用可能な場合は thumbnail_url のエイリアス。

正規化されたサムネイルエイリアス。

コードとレスポンスの例
bash
curl -X POST 'https://api.serpbase.dev/google/news/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"query":"semiconductor supply"}'
既存の Google リクエスト例
bash
curl -X POST https://api.serpbase.dev/google/news/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "q": "apple event",
    "hl": "en",
    "gl": "us",
    "page": 1
  }'
注記

ブランド監視、トレンド追跡、メディア発見。

出典と時刻は Google の短いメタデータから解析するため、両方とも任意項目として扱ってください。