Jak sestavit každodenní monitoring tvůrců na IGu v Pythonu

Marketingový tým musí ručně kontrolovat desítky účtů, aby zjistil, kteří vhodní tvůrci jsou aktivní, jak se mění jejich publikum a kdy byl profil naposledy aktualizován. Jednorázová tabulka rychle zastará: počet sledujících i popis profilu se mění a data zveřejnění i ukazatele jednotlivých příspěvků je třeba znovu shromažďovat.

Praktickým řešením je vést stručný deník pozorování: jednou denně načíst veřejné profily z předem sestaveného seznamu, uložit odpověď spolu s časem sběru a porovnat nové hodnoty s předchozími snímky. Tento přístup pomáhá vybírat účty k následné ruční kontrole, vyhodnocovat aktivitu a připravovat pravidelné přehledy. Nenahrazuje analytiku, kterou má k dispozici vlastník účtu: veřejné informace o profilu například nezpřístupní interní údaje o dosahu.

Nejprve určete, co přesně chcete sledovat

K vyhledávání potenciálních partnerů obvykle stačí krátký seznam polí: uživatelské jméno, identifikátor profilu, příznak ověření, počet sledujících, počet příspěvků, životopis a čas sběru. Tyto hodnoty pomohou rozpoznat změny profilu a porovnávat účty podle zvoleného zaměření. Konkrétní pole závisí na odpovědi API; před zpracováním se podívejte na aktuální JSON v dokumentaci a nespoléhejte na pole, která v něm nejsou.

Chcete-li sledovat aktivitu v oblasti obsahu, můžete profily doplnit údaji o příspěvcích. Přehled IG Scraper API uvádí samostatné cesty pro média a videoklipy uživatelů i požadavky na média a komentáře. Připojte je jako samostatnou fázi po ověření profilu: nejprve potvrďte potřebné parametry a podobu odpovědi v Postmanu, potom zaznamenávejte jen pole, která skutečně potřebujete pro svůj přehled.

Užitečným pravidlem monitoringu je ukládat nezpracované odpovědi odděleně od normalizovaných řádků. Nezpracovaný JSON umožní znovu ověřit interpretaci, pokud se odpověď API změní; normalizovaná tabulka se hodí pro grafy a filtry. V obou případech ukládejte čas požadavku, abyste odlišili aktuální hodnotu od historické.

Připojte IG Scraper API

Základní adresa IG API služby jsonscraper je https://ig.jsonscraper.com. Oficiální dokumentace uvádí požadavek na profil podle uživatelského jména: GET /v1/user/by/username s parametry username, license_key a cache_timeout. Například pro testovací účet dokumentace ukazuje adresu ve tvaru https://ig.jsonscraper.com/v1/user/by/username?username=apple&license_key=YOUR_LICENSE_KEY&cache_timeout=60. Parametr ukládání do mezipaměti používejte pouze v souladu s podmínkami konkrétní cesty a svým účelem: frekvence dotazů by měla odpovídat tomu, jak rychle potřebujete aktualizace.

Chcete-li ověřit strukturu odpovědi, otevřete stránku IG Scraper API a přejděte do související kolekce Postman. V příkladu úspěšná odpověď obsahuje stav, objekt ig s identifikátorem profilu, uživatelským jménem a příznakem ověření a také časové razítko. Dokumentace samostatně uvádí skupiny cest pro uživatele, média, vyhledávání, hashtagy a lokality; sběr tak můžete rozšiřovat podle toho, jak se vyjasní analytický úkol.

Klíč API ukládejte do proměnné prostředí, nikoli do zdrojového kódu nebo klientské aplikace. Dokumentace jsonscraper doporučuje ukládat klíč v prostředí a nevkládat ho do klientských sestavení. Přístup ke klíči v pracovním procesu omezte: například ho ponechte pouze úloze běžící na pozadí, která provádí sběr.

Minimální funkční příklad v Pythonu

Následující skript načítá uživatelská jména z proměnné prostředí, vyžádá každý profil a zapisuje soubor JSONL. JSONL je vhodný pro počáteční prototyp: jeden řádek představuje jeden snímek. Kód záměrně ukládá celý objekt odpovědi, místo aby předpokládal, že jsou vždy dostupná všechna pole profilu. Po prvním spuštění si prohlédněte skutečnou odpověď a teprve poté vytvořte stabilní schéma tabulky.

import json
import os
import time
from datetime import datetime, timezone
from pathlib import Path
from urllib.parse import urlencode
from urllib.request import Request, urlopen

API_KEY = os.environ["JSONSCRAPER_LICENSE_KEY"]
USERNAMES = [name.strip() for name in os.environ["IG_USERNAMES"].split(",") if name.strip()]
BASE_URL = "https://ig.jsonscraper.com/v1/user/by/username"
OUTPUT = Path("instagram_profiles.jsonl")


def fetch_profile(username: str) -> dict:
    query = urlencode({
        "username": username,
        "license_key": API_KEY,
        "cache_timeout": 60,
    })
    request = Request(f"{BASE_URL}?{query}", headers={"Accept": "application/json"})
    with urlopen(request, timeout=30) as response:
        return json.load(response)


with OUTPUT.open("a", encoding="utf-8") as output:
    for username in USERNAMES:
        collected_at = datetime.now(timezone.utc).isoformat()
        try:
            payload = fetch_profile(username)
            row = {
                "collected_at": collected_at,
                "requested_username": username,
                "ok": True,
                "payload": payload,
            }
        except Exception as exc:
            row = {
                "collected_at": collected_at,
                "requested_username": username,
                "ok": False,
                "error": str(exc),
            }

        output.write(json.dumps(row, ensure_ascii=False) + "\n")
        output.flush()
        time.sleep(1)

Před spuštěním nastavte konfiguraci v prostředí:

export JSONSCRAPER_LICENSE_KEY="váš_klíč"
export IG_USERNAMES="creator_one,creator_two,creator_three"
python monitor.py

Pauza v příkladu umožňuje klidnější postupné zpracování seznamu; nejde o deklarovaný limit API. Pro plánované spouštění nastavte frekvenci a zpracování chyb s ohledem na svůj plán, dokumentaci a požadavky na aktuálnost. Pokud požadavek skončí chybou, uložený záznam vám pomůže problém odhalit, místo aby byl účet bez upozornění přeskočen.

Po ověření odpovědi data normalizujte

Jakmile si prohlédnete odpověď používané cesty, vyberte stabilní sadu sloupců. Tabulka pozorování může například obsahovat čas sběru, username, identifikátor profilu, ověřený stav odpovědi a potřebné počítané hodnoty — pokud jsou v JSON přítomné. U každého pole výslovně určete, jak naložit s chybějící hodnotou: ponechat prázdnou, označit záznam jako neúplný nebo ho zařadit k opětovné kontrole.

Včerejší řádek nepřepisujte dnešní hodnotou. Historie snímků je potřebná k výpočtu rozdílů mezi daty a k rozpoznání změn. U počtu sledujících vypočítejte rozdíl mezi sousedními úspěšnými pozorováními téhož profilu; porovnávání podle stabilního identifikátoru je vhodnější než porovnávání pouze podle uživatelského jména, které se může změnit.

Pokud nezpracovaná odpověď obsahuje více dat, než potřebujete pro přehled, vyplatí se uchovávat ji po omezenou dobu. Normalizovaná tabulka by měla obsahovat pouze pole odůvodněná konkrétním úkolem. Při veřejném průzkumu tvůrců to obvykle zmenšuje objem dat a usnadňuje vysvětlení, proč se informace shromažďují.

Přidejte každodenní spouštění a upozornění

Na serveru lze skript spouštět plánovačem úloh, například cronem, a v automatizačním nástroji podle plánu a prostřednictvím požadavku HTTP. Základní řetězec tvoří spouštěč, načtení seznamu profilů, postupné volání cesty, kontrola úspěšné odpovědi, zápis řádku do úložiště a příprava souhrnu. V n8n nebo Make lze stejné kroky přehledně rozdělit do samostatných uzlů, aby chyba u jednoho profilu nezastavila celý seznam.

Pro přehled počítejte jednoduché ukazatele: kolik profilů se podařilo zpracovat, u kterých se změnil počet sledujících oproti předchozímu úspěšnému snímku a kdy byl záznam naposledy aktualizován. Samostatný seznam chyb pomáhá rychle odhalit nesprávná jména, nedostupné profily a dočasné potíže s požadavkem. Pokud přidáváte příspěvky, nejprve si ujasněte potřebnou hloubku historie a sadu polí a potom připojte odpovídající cestu z dokumentace.

Také ukládání do mezipaměti je vhodné nastavit promyšleně. Dokumentace popisuje cache_timeout jako parametr podporovaných cest, který umožňuje opakovaně využívat nedávné výsledky. Pro každodenní srovnávací přehled nastavte režim odpovídající požadované aktuálnosti dat; nemíchejte odpověď z mezipaměti s novým kontrolním bodem, aniž byste to zaznamenali do deníku.

Co takový monitoring ukáže

Po nasbírání snímků bude mít tým ověřitelnou historii pozorování vybraných veřejných profilů. Můžete porovnávat změny počítaných hodnot, hledat dlouho neaktualizované záznamy a sestavit stručný seznam účtů k ručnímu posouzení. Pokud je sběr médií pro zvolenou cestu a úkol dostupný, můžete k profilům přidat příspěvky a analyzovat tempo zveřejňování nebo formáty obsahu — za předpokladu, že konkrétní pole potvrzuje dokumentace.

Metriky používejte jako filtr pro výzkumnou práci, nikoli jako automatické rozhodnutí o spolupráci. Samotný počet sledujících nevypovídá o tom, nakolik publikum odpovídá značce, jaká je kvalita obsahu ani zda je autor vhodný pro obchodní spolupráci. Přidejte lidskou kontrolu profilu a kritéria výběru uchovávejte odděleně od technického sběru.

Pro zkušební spuštění otevřete kolekci IG API v Postmanu, nastavte klíč a proveďte požadavek na profil. Poté přeneste ověřené parametry do skriptu nebo automatizace. Získáte tak opakovatelný každodenní sběr, historii změn a základ pro analytický přehled, aniž byste museli začínat vlastním parserem webových stránek.