# Ověření instagramových profilů před reklamní kampaní: přehled nesrovnalostí v Pythonu

https://jsonscraper.com/cs/blog/overeni-instagramovych-profilu-pred-kampani

Author: Michael Johnson

Published: 2026-11-19T11:35:17+00:00

Updated: 2026-11-19T11:35:17+00:00

Získejte veřejné údaje o účtech z briefu a před spuštěním kampaně vytvořte tabulku výjimek

Kontrola instagramových účtů před spuštěním kampaně pomáhá odhalit chyby v seznamu umístění, dokud se dají snadno opravit. Brief může například obsahovat překlep v názvu, duplicitní účet nebo profil s neočekávaným počtem sledujících. Níže najdete krátký skript v Pythonu, který načte veřejné údaje pro každé uživatelské jméno, porovná odpověď se zadanými podmínkami a uloží kontrolovatelné řádky do CSV.

 

## Jaký bude výsledek

 

Vstupem je CSV se seznamem účtů a případnými očekávanými hodnotami. Výstupem je samostatný řádek pro každé zpracované uživatelské jméno: stav požadavku, jméno profilu, údaj o ověření, počet sledujících, příspěvků a sledovaných účtů a také stručný seznam zjištěných nesrovnalostí.



![Článek: Ověření instagramových profilů před reklamní kampaní: přehled nesrovnalostí v Pythonu
Shrnutí: Pokud brief obsahuje nesprávná jména účtů, nadbytečné mezery nebo nevhodný profil, tým si toho může všimnout až po přípravě kampaně. Ukazujeme, jak ověřit uživatelská jména na Instagramu pomocí zdokumentovaného endpointu jsonscraper a exportovat zjištěné nesrovnalosti do CSV.
Role obrázku: úvodní — ústřední myšlenka
Sekce: Jaký bude výsledek
Vizuální námět: redakční fotografie ](https://jsonscraper.com/assets/uploads/journal/2026/11/84aacded9a89d423a6289b53b549643f.png.hero.webp)

Přehled shrnuje ověřená profilová pole a poznámky k ruční kontrole před spuštěním kampaně.© jsonscraper · vytvořeno pomocí AI

 

Takový přehled se hodí marketérovi, který porovnává dodavatele s briefem, i vývojáři, který připravuje interní kontrolu jako pravidelnou úlohu. Jde o ověření konkrétních veřejných profilových polí v okamžiku požadavku; o tom, zda profil kampani vyhovuje, nadále rozhoduje tým.

 

## Která pole lze ověřit

 

Zdokumentovaná trasa Instagram API `/v1/user/by/username` přijímá povinný parametr `username`. V pozorovaném formátu odpovědi se profilové údaje nacházejí v objektu `ig`; mezi vrácená pole patřila `username`, `full_name`, `is_private`, `is_verified`, `media_count`, `follower_count`, `following_count` a `biography`. Dostupnost polí se může lišit, proto skript níže zapisuje chybějící hodnoty jako prázdné a nenahrazuje je nulou. Seznam tras a názvů parametrů najdete v [referenční příručce Instagram API](https://github.com/jsonscraper/instagram-api-python/blob/main/docs/endpoints.md).

 

Kontrola je zvlášť přehledná u podmínek, které lze výslovně definovat: profil musí být veřejný, počet sledujících musí spadat do stanoveného rozmezí a údaj o ověření musí odpovídat požadavku briefu. Životopis lze uložit k pozdější kontrole, ale automatické porovnání textu s marketingovým positioningem vyžaduje samostatné kritérium.

 

## Připravte vstupní soubor

 

Vytvořte soubor `profiles.csv` v kódování UTF-8. Minimální varianta obsahuje pouze uživatelská jména; další očekávaná pole ponechte prázdná, pokud brief žádné omezení nestanovuje:

 

```
username,min_followers,max_followers,verified
brand_example,5000,50000,false
creator_example,10000,,true
```

 

Hodnoty `min_followers` a `max_followers` určují meze kontroly. Pole `verified` přijímá hodnoty `true` nebo `false`. U každého profilu můžete uvést jen podmínky, které se na něj vztahují.

 

## Načtěte údaje a vytvořte přehled

 

Nainstalujte knihovnu `requests` a nastavte klíč v prostředí procesu, nikoli ve zdrojovém souboru. V systému macOS nebo Linux použijte tento příkaz:



![Článek: Ověření instagramových profilů před reklamní kampaní: přehled nesrovnalostí v Pythonu
Shrnutí: Pokud brief obsahuje nesprávná jména účtů, nadbytečné mezery nebo nevhodný profil, tým si toho může všimnout až po přípravě kampaně. Ukazujeme, jak ověřit uživatelská jména na Instagramu pomocí zdokumentovaného endpointu jsonscraper a exportovat zjištěné nesrovnalosti do CSV.
Role obrázku: doprovodná ilustrace 2 — jiný konkrétní aspekt
Sekce: Načtěte údaje a vytvořte přehled](https://jsonscraper.com/assets/uploads/journal/2026/11/146a636928d29c035050cacd0aa101b8.png.hero.webp)

Schéma znázorňuje cestu od CSV se seznamem účtů k přehledu, v němž zůstávají prázdná pole prázdná a shoda s pravidly se označuje samostatně.© jsonscraper · ilustrace vytvořená pomocí AI

 

```
python -m pip install requests
export JSONSCRAPER_INSTAGRAM_LICENSE_KEY='váš-klíč'
```

 

Uložte níže uvedený skript jako `check_profiles.py`. Používá Python 3.8+, kontroluje stav HTTP odpovědi, samostatně načítá datový objekt `ig` a vytváří soubor `profile_check.csv`. Klíč se předává jako parametr dotazu `license_key`, jak uvádí dokumentace služby.

 

```
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("Nastavte 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"Zpracované řádky: {len(output)}; přehled: profile_check.csv")
```

 

## Jak číst řádky s nesrovnalostmi

 

Spusťte `python check_profiles.py`. Hodnota `ok` ve sloupci `status` znamená, že skript získal očekávaný objekt profilu a mohl vytvořit záznam. Sloupec `issues` obsahuje pouze pravidla, která byla ověřena, například `private_profile` nebo `below_min_followers`. Prázdný sloupec znamená, že zadané podmínky neodhalily nesrovnalost; nepotvrzuje však kvalitu obsahu ani soulad s dalšími body smlouvy.

 

Porovnejte `returned_username` s původním uživatelským jménem a pole `biography` a `full_name` předejte odpovědné osobě k věcné kontrole. Přehled obsahuje také chyby požadavku, neočekávaný stav API a chybějící objekt `ig`: tyto řádky zůstávají ve výstupu a pomáhají odlišit technický problém od výsledku kontroly.

 

## Jak kontrolu spouštět pravidelně

 

Pro jednorázovou kontrolu stačí spustit skript ručně. V pravidelném procesu jej přidejte do plánovače nebo pracovního postupu CI: načtěte aktuální seznam, odešlete požadavky, uložte CSV jako artefakt a upozorněte tým, pokud se ve sloupci `issues` objeví nějaké hodnoty. Klíč nevypisujte do logů; uchovávejte jej jako tajný údaj prostředí běhu.

 

Pokud často kontrolujete stejné profily, lze předat parametr `cache_timeout` s počtem sekund, po které se má odpověď ukládat do mezipaměti. Dokumentace uvádí, že ukládání do mezipaměti je pro Instagram ve výchozím nastavení vypnuté; hodnota větší než nula je zapne na zadanou dobu. Tento parametr má smysl přidávat jen tehdy, pokud lze v daném intervalu znovu použít již získanou odpověď.

 

Kontrolujte pouze údaje a scénáře, k jejichž použití máte oprávnění. Výsledek berte jako snímek konkrétní odpovědi API, datum spuštění zaznamenejte do vlastního protokolu a prahové hodnoty průběžně ověřujte podle briefu. Podrobnosti o trase, dostupných polích a možnostech integrace najdete na stránce [Instagram Scraper API](https://jsonscraper.com/services/ig-scraper-api) a v [oficiální dokumentaci endpointu](https://github.com/jsonscraper/instagram-api-python/blob/main/docs/endpoints.md).
