Проверка 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.