Перевірка облікових записів IG до запуску кампанії допомагає виявити помилки у списку розміщень, поки їх ще легко виправити. Наприклад, у брифі може бути помилка в імені, повтор облікового запису або профіль із неочікуваною кількістю підписників. Нижче наведено невеликий скрипт Python, який запитує публічні дані для кожного username, порівнює відповідь із вашими умовами й зберігає перевірені рядки у CSV.
Який результат ви отримаєте
На вході — CSV зі списком облікових записів і необов’язковими очікуваними значеннями. На виході — окремий рядок для кожного обробленого username: статус запиту, ім’я профілю, позначка верифікації, кількість підписників, публікацій і підписок, а також короткий список виявлених невідповідностей.

Такий звіт стане в пригоді маркетологу, який звіряє підрядників із брифом, і розробнику, який налаштовує внутрішню перевірку як регулярне завдання. Це контроль конкретних полів публічного профілю на момент запиту; остаточне рішення щодо відповідності кампанії ухвалює команда.
Які поля можна перевірити
Документований маршрут IG API /v1/user/by/username приймає обов’язковий параметр username. У спостережуваному форматі відповіді дані профілю містяться в об’єкті ig; серед повернутих полів були username, full_name, is_private, is_verified, media_count, follower_count, following_count і biography. Набір полів може відрізнятися, тому наведений нижче скрипт записує відсутні значення як порожні, а не як нулі. Перелік маршрутів та імен параметрів наведено в довіднику IG API.
Перевірка особливо наочна для умов, які можна чітко сформулювати: профіль має бути публічним, кількість підписників має потрапляти в заданий діапазон, а позначка верифікації — відповідати вимогам брифу. Біографію можна зберегти для подальшого перегляду, але автоматичне зіставлення тексту з маркетинговим позиціюванням потребуватиме окремого критерію.
Підготуйте вхідний файл
Створіть файл profiles.csv у кодуванні UTF-8. Мінімальний варіант містить лише 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 команда має такий вигляд:

python -m pip install requests
export JSONSCRAPER_INSTAGRAM_LICENSE_KEY='ваш-ключ'
Збережіть наведений нижче скрипт як check_profiles.py. Він працює з Python 3.8+, перевіряє зовнішній статус відповіді, окремо зчитує корисне навантаження ig і створює файл profile_check.csv. Ключ передається як query-параметр 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 кешування за замовчуванням вимкнене; значення більше нуля вмикає його на вказаний період. Додавати цей параметр варто лише тоді, коли повторне використання відповіді протягом вибраного інтервалу прийнятне.
Перевіряйте лише ті дані та сценарії, на використання яких маєте право. Використовуйте результат як знімок конкретної відповіді API, фіксуйте дату запуску у власному журналі й переглядайте порогові значення разом із брифом. Докладнішу інформацію про маршрут, доступні поля та варіанти інтеграції шукайте на сторінці IG Scraper API та в офіційній документації endpoint.