jsonscraper
시장
저널로 돌아가기

광고 캠페인 전 IG 프로필 확인: Python으로 불일치 보고서 만들기

브리프에 적힌 계정의 공개 정보를 확인하고 캠페인 시작 전에 예외 항목을 표로 정리하세요

편집 정책 오류 제보

캠페인을 시작하기 전에 IG 계정을 확인하면 수정이 쉬울 때 배치 목록의 오류를 찾을 수 있습니다. 예를 들어 브리프에 이름 오타나 중복 계정이 있거나 팔로워 수가 예상과 다른 프로필이 포함될 수 있습니다. 아래는 각 username의 공개 데이터를 요청하고 응답을 조건과 비교한 다음, 확인할 수 있는 항목을 CSV로 저장하는 간단한 Python 스크립트입니다.

결과물

입력은 계정 목록과 선택적 예상값이 담긴 CSV입니다. 출력에는 처리한 각 username에 대해 요청 상태, 프로필 이름, 인증 표시, 팔로워·게시물·팔로잉 수와 발견된 불일치의 간단한 목록이 별도 행으로 기록됩니다.

기사: 광고 캠페인 전 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가 포함됐습니다. 필드가 누락될 수도 있으므로 아래 스크립트는 누락된 값을 빈칸으로 기록하며 0으로 바꾸지 않습니다. 경로와 매개변수 이름은 IG API 참조 문서에서 확인할 수 있습니다.

명시적으로 표현할 수 있는 조건을 점검하면 특히 유용합니다. 예를 들어 프로필이 공개 상태여야 하고, 팔로워 수가 지정 범위에 들어야 하며, 인증 표시가 브리프의 요구사항과 일치해야 합니다. 소개글은 나중에 검토하도록 저장할 수 있지만, 해당 문구가 마케팅 포지셔닝에 부합하는지 자동으로 비교하려면 별도의 기준이 필요합니다.

입력 파일 준비

UTF-8 인코딩으로 profiles.csv를 만듭니다. 최소한 username만 있어도 됩니다. 브리프에 제한이 없는 추가 예상 필드는 비워 두세요.

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로 내보내는 방법을 소개합니다.
이미지 역할: 두 번째 보조 삽화 — 별도의 구체적인 측면
섹션: 데이터 요청 및 보고서 생
이 도식은 계정 목록 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을 입력한 username과 대조하고, 의미를 검토할 담당자에게 biography와 full_name을 전달하세요. 요청 오류, 예상치 못한 API 상태, ig 객체 누락도 보고서에 기록됩니다. 이런 행을 포함하면 기술적 실패와 검증 결과를 구분하는 데 도움이 됩니다.

정기적으로 확인하기

한 번만 확인하려면 스크립트를 수동으로 실행하면 됩니다. 정기적으로 운영하려면 스케줄러나 CI 워크플로에 추가하세요. 최신 목록을 불러와 요청을 실행하고 CSV를 아티팩트로 저장한 뒤, issues 열에 값이 생기면 팀에 알리면 됩니다. 키를 로그에 출력하지 말고 실행 환경의 비밀값으로 보관하세요.

같은 프로필을 자주 확인한다면 cache_timeout 매개변수에 캐시할 초 단위 시간을 전달할 수 있습니다. 문서에 따르면 IG은 기본적으로 캐싱이 꺼져 있으며, 0보다 큰 값을 지정하면 해당 기간 동안 캐싱이 활성화됩니다. 선택한 기간 안에서 응답을 재사용해도 괜찮은 경우에만 이 매개변수를 추가하세요.

권한이 있는 데이터와 사용 사례만 확인하세요. 결과는 특정 시점에 API가 반환한 데이터의 스냅샷으로 활용하고, 실행 날짜를 자체 로그에 기록하며, 브리프에 맞춰 기준을 검토하세요. 경로와 사용 가능한 필드, 통합 방법에 관한 자세한 내용은 IG Scraper API 페이지와 공식 엔드포인트 문서에서 확인할 수 있습니다.

사람들

아직 이 기사에 등록된 사람이 없습니다.

계속 읽으세요CRM에 전달하기 전 TikTok 리드를 IG에서 확인하는 방법
다음 기사 읽기

읽은 내용을 실제 연동으로 구현하세요

jsonscraper 소셜 데이터 API를 살펴보고 요청을 테스트하여 다음 워크플로를 구축하세요.

API 둘러보기