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í.

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 IG 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 IG API.
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:

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 IG 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 IG Scraper API a v oficiální dokumentaci endpointu.