2026-02-16

SerpApiの使い方【Python】インストールから検索順位チェックまで

概要

ページが検索エンジンに表示されているか確認するために、PythonでSerpApiを使用してみました。

googleの検索エンジンに自分のページが掲載されているか自動で確認したくて色々なサービスを比較し、無料で実装できるサービスを探していました。
そこで見つけたのがSerpApiです。

無料プランで月250回まで検索でき、アカウント登録とAPIキーだけで簡単に実装できます。

使い方を自作のサンプルコードをベースに説明していくので、是非見ていってください（^^b

それではやっていきましょう！

SerpApiとは

SerpApiは、Googleなどの検索エンジンの検索結果（SERP）をJSON形式で取得できるAPIサービスです。

通常、検索結果をプログラムで取得しようとするとスクレイピングが必要で手間がかかりますが、SerpApiならリクエストを投げるだけで順位やURLなどの結果を構造化データで受け取れます。
無料プランで月250回まで使えるので、個人サイトの掲載確認用途なら十分に試せます。

前準備

SerpApiのAPIキー取得方法（serpapi_key）

SerpApiの公式サイトで会員登録を行いAPIキーを取得します。

まず下記のサイトにアクセスし、会員登録を行います
SerpApi 公式サイトserpapi.com

登録にはメールアドレスと電話番号が必要です。
それぞれの認証が終わったら登録完了します。

登録後はAPIキーを発行して、API Keyタブから取得します。

SerpApiのPythonライブラリをpip installする（google-search-results）

SerpApiで使用するライブラリ「google-search-results」をインストールします。

コマンド

1	pip install google-search-results

pip install serpapiとの違い

「pip install serpapi」で入るserpapiパッケージは、この記事で使うgoogle-search-resultsとは別のパッケージです。

この記事のサンプルコードはgoogle-search-resultsをインストールして、from serpapi import GoogleSearchで読み込む書き方です。
一方、pip install serpapiで入る新しいパッケージは、import serpapiしてserpapi.Clientから検索する書き方になっています。

新しいserpapiパッケージの書き方

import serpapi

client = serpapi.Client(api_key="[APIキー]")
results = client.search({"engine": "google", "q": "coffee"})

公式リポジトリでは、google-search-resultsは今後serpapi（serpapi-python）に置き換わって非推奨になる予定と案内されています。
これから新しく作る場合は、公式のREADMEで最新の書き方を確認してください。

google-search-results-python（GitHub）github.com
serpapi-python（GitHub）github.com

SerpApiで検索順位をチェックするPythonサンプルコード

サンプルコードでは、自分のドメインが特定のワードの検索結果でトップ10位以内に表示されているかを確認しています。

ワードはリストに格納しており、リスト内のワードを1度の実行ですべて確認します。

結果は下記のファイルに格納されます。

・APIの戻り値JSON
- APIの戻り値（JSON）をJSONファイルに格納
・JSON解析結果CSV
- JSONを解析した結果（トップ10位以内の検索結果の内容）
・サマリCSV
- 検索ワードごとに自分のドメインが存在した場合の順位

serpapi_check.py

import os
import json
import csv
import datetime
from serpapi import GoogleSearch
import mylib.common as common

SERPAPI_KEY = "[APIキー]"  # ここに API キー貼り付け
DOMAIN = "[ドメイン]"  # 自サイトのドメイン
DATA_DIR = '[出力先ディレクトリ]'　# 結果の出力先
SEARCH_WORD_FILE = '[検索ワードファイル]'　# 検索ワードが書かれたTXTファイル

def makeDir(path):
	"""ディレクトリを作成する
	
	Args:
		path (str): 作成するディレクトリのパス
	
	Returns:
		None
	
	Note:
		既に存在するディレクトリの場合、何もしない
	"""
	if not os.path.isdir(path):
		os.mkdir(path)

# ファイル名をサニタイズする関数
def sanitize_filename(s: str) -> str:
	"""ファイル名として使えない文字を安全な文字に置換する
	
	Args:
		s (str): オリジナルのファイル名（キーワードなど）
	
	Returns:
		str: サニタイズされたファイル名
	
	Note:
		置換対象：/, \\, :, *, ", <, >, | → _
		連続したアンダースコアは1つに統一
		先頭・末尾の空白とアンダースコアは削除
	
	"""
	import re
	# スラッシュ、バックスラッシュ、コロンなどをアンダースコアに置換
	s = re.sub(r'[/\\:*?"<>|]', '_', s)
	# 連続したアンダースコアを1つに統一
	s = re.sub(r'_+', '_', s)
	# 先頭・末尾の空白・アンダースコアを削除
	return s.strip('_ ')

# 検索結果を CSV ファイルに保存する関数
def save_results_as_csv(keyword: str, organic_results: list):
	"""検索結果を CSV ファイルに保存する
	
	SerpAPI から取得した検索結果を CSV ファイルに保存。
	各検索キーワードに対して1つのCSVファイルが生成される。
	
	Args:
		keyword (str): 検索キーワード（ファイル名に使用）
		organic_results (list): オーガニック検索結果のリスト
			各要素は {'title': str, 'link': str, 'snippet': str, ...} の形式
	
	Returns:
		None
		
	Note:
		ファイル名はsanitize_filename()で安全化される
		自サイト判定：DOMAIN がURLに含まれていれば '✓' マーク
	"""
	makeDir(DATA_DIR)
	csv_dir = os.path.join(DATA_DIR, 'csv')
	makeDir(csv_dir)
	
	# ファイル名をサニタイズ
	safe_keyword = sanitize_filename(keyword)
	csv_path = os.path.join(csv_dir, f'{safe_keyword}.csv')
	
	try:
		with open(csv_path, 'w', newline='', encoding='utf-8') as csvfile:
			fieldnames = ['順位', 'タイトル', 'URL', '説明', '自サイト']
			writer = csv.DictWriter(csvfile, fieldnames=fieldnames)
			
			writer.writeheader()
			for idx, result in enumerate(organic_results, 1):
				title = result.get('title', '')
				link = result.get('link', '')
				snippet = result.get('snippet', '')
				is_own_site = '✓' if DOMAIN in link else ''
				
				writer.writerow({
					'順位': idx,
					'タイトル': title,
					'URL': link,
					'説明': snippet,
					'自サイト': is_own_site
				})		
	except Exception as e:
		print(f"[ERROR] CSV save failed: {e}")
# サマリー結果を CSV ファイルに保存する関数
def save_summary_csv(summary_data: list):
	"""複数キーワードの検索結果をサマリー CSV に保存する
	
	全キーワードの検索結果（検出/未検出、順位）を1つの CSV にまとめる。
	
	Args:
		summary_data (list): サマリーデータのリスト
			各要素は {'キーワード': str, '検索結果': str, '順位': int or ''} の形式
	
	Returns:
		None
	
	Note:
		ファイル名には実行日の日付が自動付与される
		検出時：「検出（n位）」、未検出時：「未検出」
	"""
	makeDir(DATA_DIR)
	today = datetime.datetime.today().strftime("%Y%m%d")
	summary_path = os.path.join(DATA_DIR, f'{today}_summary.csv')
	
	try:
		with open(summary_path, 'w', newline='', encoding='utf-8') as csvfile:
			fieldnames = ['キーワード', '検索結果', '順位']
			writer = csv.DictWriter(csvfile, fieldnames=fieldnames)
			
			writer.writeheader()
			for entry in summary_data:
				writer.writerow(entry)		
	except Exception as e:
		print(f"[ERROR] Summary save failed: {e}")

def check_site_in_results(keyword):
	"""キーワード検索を実行し、自サイトが検索結果に含まれているか確認する
	
	SerpAPI を使用して Google 検索を実行。取得した検索結果から
	自サイト（DOMAIN 変数で指定）が含まれているか確認し、
	順位を取得する。結果は JSON と CSV の両形式で保存する。
	
	Args:
		keyword (str): 検索キーワード（例：「湊線で行く磯崎海岸...」）
	
	Returns:
		tuple: (found: bool, rank: int or None)
			found (bool):
				True - 自サイトが検索結果の1～10位に見つかった
				False - 見つからなかった
			rank (int or None):
				自サイトの順位（1～10）
				未検出の場合は None
	
	Note:
		- 検索は日本向け（gl=jp, hl=ja）で実行
		- 上位10件の検索結果を取得
		- 全結果は JSON で保存、整形結果は CSV で保存
	"""
	try:
		params = {
			"q": keyword,
			"api_key": SERPAPI_KEY,
			"gl": "jp",  # 日本
			"hl": "ja",  # 検索言語：日本語
			"num": 10
		}
		search = GoogleSearch(params)
		results = search.get_dict()

		# 結果をファイルに保存
		makeDir(DATA_DIR)
		save_dir = os.path.join(DATA_DIR, 'response')
		makeDir(save_dir)
		
		with open(os.path.join(save_dir, f'response_{keyword}.json'), 'w', encoding='utf-8') as f:
			json.dump(results, f, ensure_ascii=False, indent=2)
		
		# 検索結果を確認
		organic_results = results.get('organic_results', [])

		found = False
		rank = None
		for idx, result in enumerate(organic_results, 1):
			link = result.get('link', '')
			title = result.get('title', '')
			if DOMAIN in link:
				found = True
				rank = idx
				break
		
		if not found:
			print(f"✗ '{keyword}' - サイトが見つかりません")
		
		# CSV に結果を保存
		save_results_as_csv(keyword, organic_results)
		
		return found, rank
	except Exception as e:
		print(f"[ERROR] {e}")
		return False, None

def main():
	"""メイン処理：url.txt から読み込んだキーワードで一括検索を実行
	
	処理フロー：
	1. url.txt からキーワードリストを読み込み
	2. 各キーワードについて check_site_in_results() を呼び出し
	3. 結果をサマリーに集約
	4. 最終結果を20260215_summary.csv のような
	   日付付きサマリーファイルに出力
	
	Returns:
		None
	
	Note:
		- url.txt がない or 空の場合は処理終了
		- キーワード毎に print で進捗表示
		- エラーは個別キーワードでキャッチされ、全体処理は続行
	"""
	lists = common.read_file(SEARCH_WORD_FILE)
	if not lists:
		print("no urls to process")
		return
	
	summary_data = []
	
	for i, keyword in enumerate(lists, start=1):
		print(f"\n[{i}/{len(lists)}] start: {keyword}")
		found, rank = check_site_in_results(keyword)
		
		# サマリーに追加
		status = f"検出" if found else "未検出"
		summary_data.append({
			'検索結果': status,
			'順位': rank if rank else '',
			'キーワード': keyword,
		})
		print(f"\n[{i}/{len(lists)}] end: {keyword}")
	
	# サマリーをファイルに保存
	save_summary_csv(summary_data)

if __name__ == "__main__":
	main()

基本的にはコメントを見れば何とかなると思いますが、下記で要点を説明していきます。

サンプルコードの要点（from serpapi import GoogleSearchの使い方）

定数

定数を設定します。

自分の環境に合わせて設定してみてください。
※ここだけ設定すればこのソースは動作するはずです。

serpapi_check.py

SERPAPI_KEY = "[APIキー]"  # ここに API キー貼り付け
DOMAIN = "[ドメイン]"  # 自サイトのドメイン
DATA_DIR = '[出力先ディレクトリ]'　# 結果の出力先
SEARCH_WORD_FILE = '[検索ワードファイル]'　# 検索ワードが書かれたTXTファイル

SERPAPI_KEY
- SerpApi登録後に取得したAPIキー
DOMAIN
- 自サイトのドメイン名
DATA_DIR
- 結果の出力ディレクトリ
SEARCH_WORD_FILE
- 検索ワードが書かれたTXTファイル

SerpApiのパラメータ設定

SerpApiの実行に必要なパラメータを設定します。

検索ワードやAPIキーなどのSerpApiを実行するために必要な設定を行います。

必要に応じて変更してみてください

# パラメータを設定
params = {
	"q": keyword,# 検索ワード
	"api_key": SERPAPI_KEY,# SerpのApiキー
	"gl": "jp",  # 日本
	"hl": "ja",  # 検索言語：日本語
	"num": 10    # 検索数
}
search = GoogleSearch(params)

設定項目は下記のとおりです。

“q”
- 検索エンジンで検索するワード
“api_key”
- 公式サイトから取得したSerpApiのApiキー
“gl”
- 検索地域
“hl”
- 検索言語
“num”
- 検索結果の取得数

SerpApiの検索を実行

SerpApiで検索を実行します。
「get_dict」を使えば検索を実行できます。

1 2	# SerpApiで検索を実行 results = search.get_dict()

SerpApiの結果をJSONファイルに保存

結果はjsonで返却され、下記のコードでjsonファイルに保存されます。

# 結果をファイルに保存
makeDir(DATA_DIR)
save_dir = os.path.join(DATA_DIR, 'response')
makeDir(save_dir)

with open(os.path.join(save_dir, f'response_{keyword}.json'), 'w', encoding='utf-8') as f:
	json.dump(results, f, ensure_ascii=False, indent=2)

保存されたJSONファイルは下記のようになっています。

JSONを解析し、自サイトの順位を取得

SerpApiで返却されたJSONから必要なデータだけを抜き出して、自分のサイトが検索結果に表示されているかを確認します。

JSONの”organic_results”に検索結果と順位が格納されているので、項目をループさせて、判定処理を行っています。

# 取得した検索結果を確認し、自サイトの順位を取得
organic_results = results.get('organic_results', [])

found = False
rank = None
for idx, result in enumerate(organic_results, 1):
	link = result.get('link', '')
	title = result.get('title', '')
	if DOMAIN in link:
		found = True
		rank = idx
		break

JSON解析結果とサマリをファイルに出力

check_site_in_resultsでJSONを解析した結果をファイルに格納。
save_summary_csvで処理全体のサマリをファイルに格納しています。

詳細はソースのコメントをお読みください。

締め

SerpApiいかがでしょうか？

最初はseleniumで実装を試みましたが、BOT検知に引っかかって実装できなかったんですよね。
まぁそりゃそうか、、といった感じですが、回避策で簡単に実装できて個人的には満足です。

ちなみにseleniumそのものの使い方（要素取得で詰まらないクラス例）は別記事にまとめているので、よければどうぞ。

seleniumの使い方を具体例と共に解説【Python】🔗 shinpinoshi.com

本当に無料でいいのか？と思うくらい優秀なAPIなので是非皆さんも使っていってください。
SerpApiは無料アカウントならクレジットカードの登録も不要なので、安心です！

自分のサイトではこんな感じでエンジニアの知識をメモ間隔で残しています。
是非他の記事も見ていってください（^^

以上
タダで何でもできる時代万歳！！サービスを提供してくださる方には感謝しかありません。
それではお疲れさまでした。

エンジニアリング

エンジニアリング, Python, ツール

概要

目次

SerpApiとは

前準備

SerpApiのAPIキー取得方法（serpapi_key）

SerpApiのPythonライブラリをpip installする（google-search-results）

pip install serpapiとの違い

SerpApiで検索順位をチェックするPythonサンプルコード

サンプルコードの要点（from serpapi import GoogleSearchの使い方）

定数

SerpApiのパラメータ設定

SerpApiの検索を実行

SerpApiの結果をJSONファイルに保存

JSONを解析し、自サイトの順位を取得

JSON解析結果とサマリをファイルに出力

締め

関連記事