# Проверка Instagram-профилей перед рекламной кампанией: отчёт о расхождениях на Python

https://jsonscraper.com/ru/blog/instagram-campaign-profile-validation-python-report

Author: Michael Johnson

Published: 2026-11-19T11:33:48+00:00

Updated: 2026-11-19T11:44:11+00:00

Получите публичные сведения по аккаунтам из брифа и сформируйте таблицу исключений до запуска кампании

Проверка Instagram-аккаунтов до запуска кампании помогает найти ошибки в списке размещений, пока их ещё легко исправить. Например, бриф содержит опечатку в имени, повтор аккаунта или профиль с неожиданным числом подписчиков. Ниже — небольшой Python-скрипт, который запрашивает публичные данные по каждому username, сравнивает ответ с вашими условиями и сохраняет проверяемые строки в CSV.

 

## Какой результат получится

 

На вход подаётся CSV со списком аккаунтов и необязательными ожидаемыми значениями. На выходе — отдельная строка для каждого обработанного username: статус запроса, имя профиля, отметка о верификации, число подписчиков, публикаций и подписок, а также краткий список найденных расхождений.



![Article: Проверка Instagram-профилей перед рекламной кампанией: отчёт о расхождениях на Python
Summary: Если в брифе указаны неверные имена аккаунтов, лишние пробелы или неподходящий профиль, команда может обнаружить это уже после подготовки кампании. Показываем, как проверить имена Instagram-пользователей через документированный endpoint jsonscraper и выгрузить наблюдаемые расхождения в CSV.
Image role: cover — the central idea
Section: Какой результат получится
Visual subject: Editorial photo ](https://jsonscraper.com/assets/uploads/journal/2026/11/84aacded9a89d423a6289b53b549643f.png.hero.webp)

Отчёт сводит проверенные поля профиля и пометки для ручной проверки перед запуском кампании.© jsonscraper · создано с ИИ

 

Такой отчёт полезен маркетологу, который сверяет подрядчиков с брифом, и разработчику, который собирает внутреннюю проверку в регулярную задачу. Это контроль конкретных полей публичного профиля на момент запроса; ручное решение о соответствии кампании остаётся за командой.

 

## Какие поля можно проверить

 

Документированный маршрут Instagram API `/v1/user/by/username` принимает обязательный параметр `username`. В наблюдаемом формате ответа данные профиля находятся в объекте `ig`; среди возвращённых полей были `username`, `full_name`, `is_private`, `is_verified`, `media_count`, `follower_count`, `following_count` и `biography`. Поля могут отличаться по наличию, поэтому скрипт ниже записывает отсутствующие значения как пустые и не превращает их в ноль. Список маршрутов и имён параметров приведён в [справочнике Instagram API](https://github.com/jsonscraper/instagram-api-python/blob/main/docs/endpoints.md).

 

Проверка особенно наглядна для условий, которые можно выразить явно: профиль должен быть публичным, число подписчиков должно попадать в заданный диапазон, а отметка верификации — совпадать с требованием брифа. Биографию можно сохранить для последующего просмотра, но автоматическое сравнение текста с маркетинговым позиционированием потребует отдельного критерия.

 

## Подготовьте входной файл

 

Создайте `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 команда выглядит так:



![Article: Проверка Instagram-профилей перед рекламной кампанией: отчёт о расхождениях на Python
Summary: Если в брифе указаны неверные имена аккаунтов, лишние пробелы или неподходящий профиль, команда может обнаружить это уже после подготовки кампании. Показываем, как проверить имена Instagram-пользователей через документированный endpoint jsonscraper и выгрузить наблюдаемые расхождения в CSV.
Image role: supporting illustration 2 — a different specific aspect
Section: Запросите данные и сформиру](https://jsonscraper.com/assets/uploads/journal/2026/11/237dc3e9aa5ec9c0135533c954196d2a.png.hero.webp)

Схема показывает путь от CSV со списком аккаунтов до отчёта, где пустые поля сохраняются пустыми, а совпадения с правилами отмечаются отдельно.© jsonscraper · создано с ИИ

 

```
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` можно передать как количество секунд кэширования. Документация указывает, что для Instagram кэширование по умолчанию выключено; значение больше нуля включает его на указанный период. Добавлять этот параметр имеет смысл только тогда, когда допустимо повторно использовать ответ в пределах выбранного интервала.

 

Проверяйте только те данные и сценарии, на которые у вас есть право. Используйте результат как снимок конкретного ответа API, фиксируйте дату запуска в собственном журнале и пересматривайте пороги вместе с брифом. Подробности маршрута, доступные поля и варианты интеграции смотрите на странице [Instagram Scraper API](https://jsonscraper.com/services/ig-scraper-api) и в [официальной документации endpoint](https://github.com/jsonscraper/instagram-api-python/blob/main/docs/endpoints.md).
