Näin rakennat IG-sisällöntuottajien päivittäisen seurannan Pythonilla

Markkinointitiimin on tarkistettava kymmeniä tilejä käsin selvittääkseen, ketkä potentiaalisista sisällöntuottajista ovat aktiivisia, miten heidän yleisönsä muuttuu ja milloin profiilia on viimeksi päivitetty. Kertaluonteinen taulukko vanhenee nopeasti: seuraajamäärä ja profiilikuvaus muuttuvat, ja julkaisupäivät sekä yksittäisten julkaisujen mittarit on kerättävä uudelleen.

Käytännöllinen ratkaisu on pitää pientä havaintolokia: hae ennalta laaditun listan julkiset profiilit kerran päivässä, tallenna vastaus keruuajankohdan kanssa ja vertaa uusia arvoja aiempiin tilannekuviin. Näin voidaan valita tilejä tarkempaan manuaaliseen arviointiin, seurata aktiivisuutta ja valmistella säännöllisiä raportteja. Menetelmä ei korvaa tilinomistajan analytiikkaa: esimerkiksi profiilin julkiset tiedot eivät anna pääsyä sisäisiin tavoittavuusmittareihin.

Määritä ensin, mitä haluat seurata

Mahdollisten yhteistyökumppaneiden etsimiseen riittää yleensä lyhyt kenttäluettelo: käyttäjänimi, profiilin tunniste, vahvistustieto, seuraajamäärä, julkaisujen määrä, bio ja keruuajankohta. Näiden arvojen avulla huomaa profiilin muuttuneen ja voi vertailla tilejä valitun aiheen perusteella. Käytettävissä olevat kentät riippuvat API-vastauksesta; tarkista ajantasainen JSON dokumentaatiosta ennen käsittelyä äläkä oleta kenttiä, joita siinä ei ole.

Sisältöaktiivisuuden seuraamiseksi profiilitietoihin voi lisätä julkaisutietoja. IG Scraper APIn reittikartassa luetellaan erilliset reitit käyttäjien medialle ja videoleikkeille sekä mediaa ja kommentteja koskevat kyselyt. Ota ne käyttöön erillisenä vaiheena profiilin tarkistamisen jälkeen: varmista ensin tarvittavat parametrit ja vastausrakenne Postmanissa ja tallenna sitten vain raportin kannalta tarpeelliset kentät.

Hyvä seurantakäytäntö on säilyttää raakavastaukset erillään normalisoiduista riveistä. Raaka JSON auttaa tarkistamaan tulkinnan uudelleen, jos API-vastaus muuttuu; normalisoitu taulukko sopii kaavioihin ja suodatukseen. Tallenna kummassakin tapauksessa kyselyn ajankohta, jotta ajantasainen arvo erottuu historiatiedosta.

Ota IG Scraper API käyttöön

jsonscraperin IG APIn perusosoite on https://ig.jsonscraper.com. Virallisessa dokumentaatiossa näytetään käyttäjänimellä tehtävä profiilikysely: GET /v1/user/by/username, jonka parametrit ovat username, license_key ja cache_timeout. Esimerkiksi dokumentaatiossa näytetään testitilille URL-muoto: https://ig.jsonscraper.com/v1/user/by/username?username=apple&license_key=YOUR_LICENSE_KEY&cache_timeout=60. Käytä välimuistiparametria vain kyseisen reitin ehtojen ja oman käyttötarkoituksen mukaisesti: kyselytiheyden tulee vastata sitä, kuinka nopeasti tarvitset päivityksiä.

Tarkista vastausrakenne avaamalla IG Scraper API -sivu ja siirtymällä siihen liittyvään Postman-kokoelmaan. Esimerkin onnistunut vastaus sisältää tilan, ig-objektin profiilitunnisteineen, käyttäjänimineen ja vahvistustietoineen sekä aikaleiman. Dokumentaatiossa luetellaan erikseen käyttäjien, median, haun, aihetunnisteiden ja sijaintien reittiryhmät, joten keruuta voi laajentaa analyysitarpeen tarkentuessa.

Säilytä API-avain ympäristömuuttujassa, älä lähdekoodissa tai asiakassovelluksessa. jsonscraperin dokumentaatio suosittelee avaimen säilyttämistä ympäristössä ja sen jättämistä pois asiakasohjelmien koontiversioista. Rajoita avaimen käyttöoikeudet tuotantotyönkulussa: esimerkiksi vain taustalla toimivalla keräystehtävällä tulisi olla pääsy siihen.

Yksinkertainen toimiva Python-esimerkki

Alla oleva komentosarja lukee käyttäjänimet ympäristömuuttujasta, hakee kunkin profiilin ja kirjoittaa JSONL-tiedoston. JSONL sopii alkuvaiheen prototyyppiin: yksi rivi vastaa yhtä tilannekuvaa. Koodi tallentaa tarkoituksella koko vastausobjektin sen sijaan, että olettaisi kaikkien profiilikenttien olevan aina mukana. Tutki todellinen vastaus ensimmäisen ajon jälkeen ja luo vasta sen jälkeen vakaa taulukkorakenne.

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)

Aseta ympäristömuuttujat ennen käynnistystä:

export JSONSCRAPER_LICENSE_KEY="oma_avaimesi"
export IG_USERNAMES="creator_one,creator_two,creator_three"
python monitor.py

Esimerkin viive auttaa käsittelemään listaa rauhallisesti yksi profiili kerrallaan; se ei ole ilmoitettu APIn käyttöraja. Määritä tuotantokäytön ajoitus ja virheenkäsittely oman palvelupakettisi, dokumentaation ja ajantasaisuustarpeiden mukaan. Jos kysely epäonnistuu, tallennettu tietue auttaa havaitsemaan ongelman sen sijaan, että tili jäisi huomaamatta.

Normalisoi tiedot vasta vastauksen tarkistamisen jälkeen

Kun olet tutkinut käyttämäsi reitin vastauksen, poimi siitä vakaa joukko sarakkeita. Havaintotaulukossa voi olla esimerkiksi keruuaika, käyttäjänimi, profiilitunniste, tarkistettu vastaustila ja tarvittavat laskurit, jos ne löytyvät JSONista. Määritä jokaiselle kentälle selkeä toimintatapa puuttuvan arvon varalta: tallenna tyhjä arvo, merkitse tietue puutteelliseksi tai lähetä se uudelleen tarkistettavaksi.

Älä korvaa eilistä riviä tämän päivän arvolla. Tilannekuvien historiaa tarvitaan päivämäärien välisten erojen laskemiseen ja muutosten havaitsemiseen. Laske seuraajamäärän erotus saman profiilin peräkkäisten onnistuneiden havaintojen välillä; vakaa tunniste on vertailuun parempi kuin pelkkä käyttäjänimi, joka voi muuttua.

Raakavastausta kannattaa säilyttää rajallisen ajan, jos se sisältää raportin tarpeisiin nähden ylimääräisiä tietoja. Normalisoituun taulukkoon tulisi ottaa vain tehtävän kannalta perustellut kentät. Julkisten sisällöntuottajien tutkimuksessa tämä yleensä vähentää tietomäärää ja helpottaa keruun tarkoituksen perustelemista.

Lisää päivittäinen ajo ja ilmoitus

Palvelimella komentosarjan voi ajaa tehtävien ajoittimella, kuten cronilla, ja automaatioalustalla ajastetun käynnistyksen ja HTTP-pyynnön avulla. Perusketju sisältää käynnistimen, profiililistan lukemisen, reitin kutsumisen profiili kerrallaan, onnistuneen vastauksen tarkistamisen, rivin tallennuksen tietovarastoon ja yhteenvedon muodostamisen. n8n:ssä tai Makessa samat vaiheet on kätevä jakaa erillisiksi solmuiksi, jotta yhden profiilin virhe ei pysäytä koko listaa.

Laske raporttia varten yksinkertaisia mittareita: kuinka monen profiilin käsittely onnistui, mitkä muuttivat seuraajamääräänsä edellisestä onnistuneesta tilannekuvasta ja milloin tietue päivitettiin viimeksi. Erillinen virheluettelo auttaa löytämään nopeasti virheelliset käyttäjänimet, tavoittamattomat profiilit ja tilapäiset kyselyongelmat. Jos lisäät julkaisudataa, sovi ensin tarvittavasta historiapituudesta ja kenttäjoukosta ja ota sitten käyttöön dokumentaation mukainen reitti.

Myös välimuisti kannattaa määrittää harkiten. Dokumentaatiossa cache_timeout kuvataan tuettujen reittien parametriksi, jolla voidaan käyttää uudelleen tuoreita tuloksia. Määritä päivittäiseen vertailuraporttiin tila, joka vastaa tietojen tuoreustarvetta; älä sekoita välimuistista saatua vastausta uuteen vertailupisteeseen merkitsemättä asiaa lokiin.

Mitä tällainen seuranta kertoo

Kun tilannekuvia on kertynyt, tiimillä on valituista julkisista profiileista tarkistettavissa oleva havaintohistoria. Mittarien muutoksia voi vertailla, pitkään päivittämättä olleita tietueita löytää ja laatia lyhyen listan manuaalisesti arvioitavista tileistä. Jos käytetty reitti ja tehtävä mahdollistavat mediatietojen keruun, profiileihin voi lisätä julkaisuja ja analysoida julkaisutahtia tai sisältömuotoja sillä edellytyksellä, että dokumentaatio vahvistaa kyseiset kentät.

Käytä mittareita tutkimustyön suodattamiseen, älä automaattisena yhteistyöpäätöksenä. Seuraajamäärä ei yksin kerro yleisön sopivuudesta brändille, sisällön laadusta tai sisällöntuottajan kaupallisesta soveltuvuudesta. Tarkista profiili myös ihmisen voimin ja pidä valintakriteerit erillään teknisestä tiedonkeruusta.

Avaa kokeilua varten IG API -kokoelma Postmanissa, määritä avain ja suorita profiilikysely. Siirrä sitten tarkistetut parametrit komentosarjaan tai automaatioon. Näin saat toistettavan päivittäisen keruun, muutosten historian ja pohjan analyysiraportille ilman, että sinun tarvitsee aloittaa itse kirjoitetun sivukaapimen rakentamisesta.