IG-tilien tarkistaminen ennen kampanjan käynnistämistä auttaa löytämään sijoituslistan virheet silloin, kun ne on vielä helppo korjata. Briefissä voi esimerkiksi olla kirjoitusvirhe käyttäjänimessä, sama tili kahteen kertaan tai profiili, jonka seuraajamäärä poikkeaa odotetusta. Alla oleva pieni Python-skripti hakee kunkin käyttäjänimen julkiset tiedot, vertaa vastausta määrittämiisi ehtoihin ja tallentaa tarkistettavat rivit CSV-tiedostoon.
Millaiseen tulokseen pääset
Syötteenä on CSV-tiedosto, jossa on tililuettelo ja haluttaessa odotetut arvot. Tuloksena saat jokaisesta käsitellystä käyttäjänimestä oman rivin, jossa näkyvät pyynnön tila, profiilin nimi, vahvistusmerkintä, seuraajien, julkaisujen ja seurattavien määrä sekä lyhyt luettelo havaituista poikkeamista.

Tällainen raportti on hyödyllinen markkinoijalle, joka vertaa yhteistyökumppaneita briefiin, sekä kehittäjälle, joka rakentaa sisäistä tarkistusta säännölliseksi tehtäväksi. Tarkistus koskee tiettyjä julkisen profiilin kenttiä pyynnön hetkellä; tiimi päättää edelleen itse, sopiiko profiili kampanjaan.
Mitä kenttiä voi tarkistaa
Dokumentoitu IG API -reitti /v1/user/by/username vaatii username-parametrin. Vastausmuodossa, jota tarkastelimme, profiilin tiedot ovat ig-objektissa. Palautettuihin kenttiin kuuluivat username, full_name, is_private, is_verified, media_count, follower_count, following_count ja biography. Kenttien saatavuus voi vaihdella, joten alla oleva skripti jättää puuttuvat arvot tyhjiksi eikä muuta niitä nolliksi. Reittien ja parametrien nimet löytyvät IG API:n dokumentaatiosta.
Tarkistus on erityisen selkeä ehtojen kohdalla, kun ne voidaan ilmaista täsmällisesti: profiilin on oltava julkinen, seuraajamäärän on osuttava määritetylle vaihteluvälille ja vahvistusmerkinnän on vastattava briefin vaatimusta. Biografian voi tallentaa myöhempää tarkastelua varten, mutta tekstin vertaaminen markkinointiviestiin vaatii erillisen arviointikriteerin.
Valmistele syötetiedosto
Luo UTF-8-koodattu profiles.csv. Yksinkertaisimmillaan tiedostossa on vain käyttäjänimi; jätä odotetut lisäkentät tyhjiksi, jos briefissä ei ole niitä koskevaa rajoitusta:
username,min_followers,max_followers,verified
brand_example,5000,50000,false
creator_example,10000,,true
min_followers- ja max_followers-arvot määrittävät tarkistettavan vaihteluvälin. verified-kenttään hyväksytään true tai false. Kullekin profiilille voi määrittää vain soveltuvat ehdot.
Hae tiedot ja muodosta raportti
Asenna requests ja aseta avain prosessin ympäristömuuttujaan, älä lähdekooditiedostoon. macOS- tai Linux-järjestelmässä komennot ovat seuraavat:

python -m pip install requests
export JSONSCRAPER_INSTAGRAM_LICENSE_KEY='avaimesi'
Tallenna alla oleva skripti nimellä check_profiles.py. Se käyttää Python 3.8:aa tai uudempaa, tarkistaa HTTP-vastauksen tilan, lukee erikseen ig-hyötykuorman ja luo tiedoston profile_check.csv. Avain välitetään license_key-kyselyparametrina palvelun dokumentaation mukaisesti.
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("Aseta 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"Käsiteltyjä rivejä: {len(output)}; raportti: profile_check.csv")
Miten poikkeamarivejä luetaan
Käynnistä skripti komennolla python check_profiles.py. status-sarakkeen arvo ok tarkoittaa, että skripti sai odotetun profiiliobjektin ja pystyi muodostamaan tietuerivin. issues-sarake sisältää vain tarkistettujen sääntöjen mukaiset havainnot, kuten private_profile tai below_min_followers. Tyhjä sarake tarkoittaa, etteivät asetetut ehdot paljastaneet poikkeamaa; se ei vahvista sisällön laatua tai sopimuksen muiden kohtien täyttymistä.
Vertaa returned_username-arvoa alkuperäiseen käyttäjänimeen ja anna biography sekä full_name vastuuhenkilön sisällöllisesti tarkistettaviksi. Raporttiin sisältyvät myös pyyntövirheet, odottamaton API-tila ja puuttuva ig-objekti. Näin aineistosta voi erottaa teknisen virheen tarkistuksen tuloksesta.
Tarkistuksen säännöllinen suorittaminen
Kertatarkistusta varten riittää, että käynnistät skriptin käsin. Säännöllisessä prosessissa lisää se ajastimeen tai CI-työnkulkuun: lataa ajantasainen lista, tee pyynnöt, tallenna CSV artefaktiksi ja ilmoita tiimille, jos issues-sarakkeeseen ilmestyy arvoja. Älä tulosta avainta lokeihin, vaan säilytä se suoritusympäristön salaisuutena.
Jos tarkistat samoja profiileja usein, voit antaa cache_timeout-parametrille välimuistin keston sekunteina. Dokumentaation mukaan IGin välimuisti on oletusarvoisesti pois käytöstä; nollaa suurempi arvo ottaa sen käyttöön määritetyksi ajaksi. Parametria kannattaa käyttää vain, jos vastauksen uudelleenkäyttö valitun aikavälin sisällä on hyväksyttävää.
Tarkista vain sellaisia tietoja ja tilanteita, joihin sinulla on oikeus. Käytä tulosta tilannekuvana tietystä API-vastauksesta, kirjaa suorituspäivä omaan lokiisi ja tarkista kynnysarvot yhdessä briefin kanssa. Reitin, saatavilla olevien kenttien ja integraatiovaihtoehtojen lisätiedot löytyvät IG Scraper API -sivulta ja endpointin virallisesta dokumentaatiosta.