jsonscraper
Markkinat
Takaisin lehteen

IG-profiilien tarkistus ennen mainoskampanjaa: Python-raportti poikkeamista

Hae briefissä mainittujen tilien julkiset tiedot ja kokoa poikkeamat taulukkoon ennen kampanjan käynnistämistä

Toimituksellinen linjaus Ilmoita virheestä

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.

Artikkeli: IG-profiilien tarkistus ennen mainoskampanjaa: Python-raportti poikkeamista
Yhteenveto: Jos briefissä on väärä käyttäjänimi, ylimääräisiä välilyöntejä tai sopimaton profiili, tiimi saattaa huomata asian vasta kampanjan valmistelun jälkeen. Näytämme, miten IG-käyttäjänimet voi tarkistaa dokumentoidun jsonscraper-endpointin avulla ja viedä havaitut poikkeamat CSV-tiedostoon.
Kuvan tehtävä: kansikuva – keskeinen ajatus
Osio: Millaiseen tulokseen pääset
Visuaalinen aihe: Editorial photo
Raportti kokoaa tarkistetut profiilikentät ja manuaalista tarkistusta vaativat huomiot ennen kampanjan käynnistämistä.© jsonscraper · luotu tekoälyllä

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:

Artikkeli: IG-profiilien tarkistus ennen mainoskampanjaa: Python-raportti poikkeamista
Yhteenveto: Jos briefissä on väärä käyttäjänimi, ylimääräisiä välilyöntejä tai sopimaton profiili, tiimi saattaa huomata asian vasta kampanjan valmistelun jälkeen. Näytämme, miten IG-käyttäjänimet voi tarkistaa dokumentoidun jsonscraper-endpointin avulla ja viedä havaitut poikkeamat CSV-tiedostoon.
Kuvan tehtävä: havainnollistava kuva 2 – toinen, tarkempi näkökulma
Osio: Hae tiedot ja muodosta rap
Kaavio kuvaa etenemisen tililuettelon sisältävästä CSV-tiedostosta raporttiin: puuttuvat kentät pysyvät tyhjinä, ja sääntöjen mukaiset osumat merkitään erikseen.© jsonscraper · tekoälyllä luotu kuvitus
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.

Ihmiset

Tämän artikkelin luettelossa ei ole vielä ihmisiä.

Jatka lukemistaNäin tarkistat TikTok-liidit IGissa ennen CRM:ään siirtoa
Lue seuraava artikkeli

Muuta lukemasi toimivaksi integraatioksi

Tutustu jsonscraperin sosiaalisen datan rajapintoihin, testaa pyyntöjä ja rakenna seuraava työnkulkusi.

Tutki API:t