jsonscraper
市場
ジャーナルに戻る

広告キャンペーン前にIGプロフィールを確認:Pythonで差分レポートを作成

ブリーフに記載されたアカウントの公開情報を取得し、キャンペーン開始前に要確認項目を一覧化

編集方針 誤りを報告する

キャンペーン開始前にIGアカウントを確認しておけば、まだ修正しやすい段階で掲載リストの誤りを見つけられます。たとえば、ブリーフにユーザー名の誤記やアカウントの重複、想定外のフォロワー数のプロフィールが含まれている場合です。以下では、各ユーザー名の公開データを取得し、条件と照合して、確認可能な結果をCSVに保存する小さなPythonスクリプトを紹介します。

作成されるレポート

入力はアカウント一覧と任意の期待値を含むCSVです。出力には処理したユーザー名ごとに1行が作成され、リクエストのステータス、プロフィール名、認証済みの表示、フォロワー数、投稿数、フォロー数、検出された差分の概要が記録されます。

記事:広告キャンペーン前にIGプロフィールを確認:Pythonで差分レポートを作成
概要:ブリーフに誤ったアカウント名や余分な空白、不適切なプロフィールが含まれていると、キャンペーンの準備後に問題が発覚することがあります。ドキュメント化されたjsonscraperのエンドポイントを使ってIGのユーザー名を確認し、検出した差分をCSVに出力する方法を紹介します。
画像の役割:中心的なアイデアを示すカバー
セクション:作成されるレポート
ビジュアルの主題:編集用写真「」
レポートではプロフィールの確認済み項目と、キャンペーン開始前に手作業で確認すべき項目をまとめます。© jsonscraper · AI生成

このレポートは、委託先をブリーフと照合するマーケターや、定期タスクとして社内チェックを組み立てる開発者に役立ちます。確認するのはリクエスト時点の公開プロフィールにある特定の項目であり、キャンペーンへの適合性はチームが判断します。

確認できる項目

ドキュメント化された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では次のように実行します。

記事:広告キャンペーン前にIGプロフィールを確認:Pythonで差分レポートを作成
概要:ブリーフに誤ったアカウント名や余分な空白、不適切なプロフィールが含まれていると、キャンペーンの準備後に問題が発覚することがあります。ドキュメント化されたjsonscraperのエンドポイントを使ってIGのユーザー名を確認し、検出した差分をCSVに出力する方法を紹介します。
画像の役割:異なる具体的な側面を示す補助イラスト2
セクション:データを取得してレポートを作成する
CSVのアカウント一覧からレポートまでの流れを示しています。空欄は空欄のまま保持し、ルールとの一致は個別に記録します。© jsonscraper · AI生成イラスト
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とエンドポイントの公式ドキュメントで確認できます。

人々

この記事にはまだ人物がリストされていません。

読み続けてくださいTikTokの見込み客をCRMに登録する前にIGで確認する方法
次の記事を読む

読んだ内容を実用的な連携へ

jsonscraperのソーシャルデータAPIを調べ、リクエストを試し、次のワークフローを構築しましょう。

APIを探す