# Перевірка профілів Instagram перед рекламною кампанією: звіт про невідповідності на Python

https://jsonscraper.com/uk/blog/perevirka-profiley-instagram-pered-kampaniyeiu

Author: Michael Johnson

Published: 2026-11-19T11:42:40+00:00

Updated: 2026-11-19T11:42:40+00:00

Отримайте публічні дані облікових записів із брифу й сформуйте таблицю невідповідностей до запуску кампанії

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

 

## Який результат ви отримаєте

 

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



![Стаття: Перевірка профілів Instagram перед рекламною кампанією: звіт про невідповідності на Python
Короткий опис: Якщо в брифі вказано неправильні імена облікових записів, зайві пробіли або невідповідний профіль, команда може виявити це вже після підготовки кампанії. Показуємо, як перевірити імена користувачів Instagram через документований endpoint jsonscraper і експортувати виявлені невідповідності у CSV.
Роль зображення: обкладинка — центральна ідея
Розділ: Який результат ви отримаєте
Візуальний об’єкт: редакційне фото ](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 команда має такий вигляд:



![Стаття: Перевірка профілів Instagram перед рекламною кампанією: звіт про невідповідності на Python
Короткий опис: Якщо в брифі вказано неправильні імена облікових записів, зайві пробіли або невідповідний профіль, команда може виявити це вже після підготовки кампанії. Показуємо, як перевірити імена користувачів Instagram через документований endpoint jsonscraper і експортувати виявлені невідповідності у CSV.
Роль зображення: допоміжна ілюстрація 2 — інший конкретний аспект
Розділ: Запитайте дані та сформ](https://jsonscraper.com/assets/uploads/journal/2026/11/146a636928d29c035050cacd0aa101b8.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).
