キャンペーン開始前にIGアカウントを確認しておけば、まだ修正しやすい段階で掲載リストの誤りを見つけられます。たとえば、ブリーフにユーザー名の誤記やアカウントの重複、想定外のフォロワー数のプロフィールが含まれている場合です。以下では、各ユーザー名の公開データを取得し、条件と照合して、確認可能な結果をCSVに保存する小さなPythonスクリプトを紹介します。
作成されるレポート
入力はアカウント一覧と任意の期待値を含むCSVです。出力には処理したユーザー名ごとに1行が作成され、リクエストのステータス、プロフィール名、認証済みの表示、フォロワー数、投稿数、フォロー数、検出された差分の概要が記録されます。

このレポートは、委託先をブリーフと照合するマーケターや、定期タスクとして社内チェックを組み立てる開発者に役立ちます。確認するのはリクエスト時点の公開プロフィールにある特定の項目であり、キャンペーンへの適合性はチームが判断します。
確認できる項目
ドキュメント化されたIG APIのルート /v1/user/by/username では、必須パラメーター username を指定します。確認されたレスポンス形式では、プロフィールデータは ig オブジェクトに含まれ、username、full_name、is_private、is_verified、media_count、follower_count、following_count、biography などの項目が返されていました。項目が常に存在するとは限らないため、以下のスクリプトは値がない場合は空欄として記録し、ゼロには置き換えません。ルートとパラメーター名の一覧はIG APIリファレンスに記載されています。
明示的に表せる条件なら、特に確認しやすくなります。たとえば、プロフィールが公開されていること、フォロワー数が指定範囲内であること、認証済み表示がブリーフの要件と一致することです。自己紹介文は後から確認できるよう保存できますが、そのテキストがマーケティング上の位置付けに合うかを自動判定するには、別途基準が必要です。
入力ファイルを準備する
UTF-8の profiles.csv を作成します。最小構成ではユーザー名だけを指定し、ブリーフに条件がない項目は空欄にします。
username,min_followers,max_followers,verified
brand_example,5000,50000,false
creator_example,10000,,true
min_followers と max_followers は確認する範囲の下限と上限です。verified には true または false を指定します。各プロフィールには、該当する条件だけを設定できます。
データを取得してレポートを作成する
requests をインストールし、ソースファイルではなくプロセスの環境変数にキーを設定します。macOSまたはLinuxでは次のように実行します。

python -m pip install requests
export JSONSCRAPER_INSTAGRAM_LICENSE_KEY='あなたのキー'
以下のスクリプトを check_profiles.py として保存します。Python 3.8以降を使用し、HTTPレスポンスのステータスを確認してから ig のデータを読み取り、profile_check.csv を作成します。サービスのドキュメントに従い、キーはクエリーパラメーター license_key として渡します。
import csv
import os
import sys
from typing import Dict, List, Optional
import requests
API_URL = "https://ig.jsonscraper.com/v1/user/by/username"
API_KEY = os.environ.get("JSONSCRAPER_INSTAGRAM_LICENSE_KEY")
if not API_KEY:
raise SystemExit("JSONSCRAPER_INSTAGRAM_LICENSE_KEYを設定してください")
def parse_bool(value: str) -> Optional[bool]:
normalized = value.strip().lower()
if normalized in ("true", "1", "yes", "да"):
return True
if normalized in ("false", "0", "no", "нет"):
return False
return None
def check_row(row: Dict[str, str]) -> Dict[str, str]:
username = row.get("username", "").strip().lstrip("@")
result = {
"requested_username": username,
"status": "",
"returned_username": "",
"full_name": "",
"is_private": "",
"is_verified": "",
"follower_count": "",
"media_count": "",
"following_count": "",
"biography": "",
"issues": "",
}
if not username:
result["status"] = "skipped_empty_username"
result["issues"] = "empty_username"
return result
try:
response = requests.get(
API_URL,
params={"license_key": API_KEY, "username": username},
timeout=30,
)
response.raise_for_status()
payload = response.json()
except (requests.RequestException, ValueError) as exc:
result["status"] = "request_error"
result["issues"] = type(exc).__name__
return result
if payload.get("status") != "ok":
result["status"] = "api_error"
result["issues"] = "unexpected_outer_status"
return result
profile = payload.get("ig")
if not isinstance(profile, dict):
result["status"] = "missing_profile_data"
result["issues"] = "missing_ig_object"
return result
result["status"] = "ok"
fields = (
"username", "full_name", "is_private", "is_verified",
"follower_count", "media_count", "following_count", "biography",
)
for field in fields:
value = profile.get(field)
if value is not None:
result["returned_username" if field == "username" else field] = str(value)
issues: List[str] = []
private = profile.get("is_private")
if private is True:
issues.append("private_profile")
followers = profile.get("follower_count")
if isinstance(followers, int):
minimum = row.get("min_followers", "").strip()
maximum = row.get("max_followers", "").strip()
if minimum:
try:
if followers < int(minimum):
issues.append("below_min_followers")
except ValueError:
issues.append("invalid_min_followers_rule")
if maximum:
try:
if followers > int(maximum):
issues.append("above_max_followers")
except ValueError:
issues.append("invalid_max_followers_rule")
elif row.get("min_followers", "").strip() or row.get("max_followers", "").strip():
issues.append("follower_count_unavailable")
expected_verified = parse_bool(row.get("verified", ""))
actual_verified = profile.get("is_verified")
if expected_verified is not None and isinstance(actual_verified, bool):
if actual_verified != expected_verified:
issues.append("verified_flag_mismatch")
elif row.get("verified", "").strip():
issues.append("verified_value_unavailable_or_invalid")
result["issues"] = ";".join(issues)
return result
with open("profiles.csv", newline="", encoding="utf-8-sig") as source:
rows = list(csv.DictReader(source))
output = [check_row(row) for row in rows]
fieldnames = list(output[0].keys()) if output else [
"requested_username", "status", "returned_username", "full_name",
"is_private", "is_verified", "follower_count", "media_count",
"following_count", "biography", "issues",
]
with open("profile_check.csv", "w", newline="", encoding="utf-8") as destination:
writer = csv.DictWriter(destination, fieldnames=fieldnames)
writer.writeheader()
writer.writerows(output)
print(f"処理した行数:{len(output)}件。レポート:profile_check.csv")
差分がある行の読み方
python check_profiles.py を実行します。status 列の ok は、スクリプトが想定したプロフィールオブジェクトを取得し、記録を作成できたことを意味します。issues 列には、確認したルールに関する項目だけが記録されます。たとえば、private_profile や below_min_followers です。列が空であれば、設定した条件で差分が見つからなかったという意味であり、コンテンツの品質や契約上のほかの要件への適合を示すものではありません。
returned_username を入力したユーザー名と照合し、biography と full_name は担当者に渡して内容を確認してください。リクエストエラー、想定外のAPIステータス、ig オブジェクトの欠落もレポートに記録されます。これらの行も対象に残るため、技術的な問題と確認結果を区別できます。
定期的な確認を実行する方法
1回だけ確認するなら、スクリプトを手動で実行すれば十分です。定期処理では、スケジューラーやCIワークフローに追加し、最新のリストを読み込み、リクエストを実行して、CSVを成果物として保存し、issues 列に値があればチームに通知します。キーをログに出力せず、実行環境のシークレットとして保管してください。
同じプロフィールを頻繁に確認する場合、cache_timeout パラメーターにキャッシュする秒数を指定できます。ドキュメントによると、IGではキャッシュはデフォルトで無効で、ゼロより大きい値を指定すると、その期間有効になります。選択した期間内でレスポンスを再利用してよい場合に限り、このパラメーターを追加してください。
権限のあるデータと用途だけを確認してください。結果は特定のAPIレスポンス時点のスナップショットとして扱い、実行日を独自のログに記録し、ブリーフに合わせてしきい値を見直します。ルート、利用可能な項目、連携方法の詳細はIG Scraper APIとエンドポイントの公式ドキュメントで確認できます。