jsonscraper
Trhy
Zpět do magazínu

Ověření instagramových profilů před reklamní kampaní: přehled nesrovnalostí v Pythonu

Získejte veřejné údaje o účtech z briefu a před spuštěním kampaně vytvořte tabulku výjimek

Redakční zásady Nahlásit chybu

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

Článek: Ověření instagramových profilů před reklamní kampaní: přehled nesrovnalostí v Pythonu
Shrnutí: Pokud brief obsahuje nesprávná jména účtů, nadbytečné mezery nebo nevhodný profil, tým si toho může všimnout až po přípravě kampaně. Ukazujeme, jak ověřit uživatelská jména na IGu pomocí zdokumentovaného endpointu jsonscraper a exportovat zjištěné nesrovnalosti do CSV.
Role obrázku: úvodní — ústřední myšlenka
Sekce: Jaký bude výsledek
Vizuální námět: redakční fotografie
Přehled shrnuje ověřená profilová pole a poznámky k ruční kontrole před spuštěním kampaně.© jsonscraper · vytvořeno pomocí AI

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:

Článek: Ověření instagramových profilů před reklamní kampaní: přehled nesrovnalostí v Pythonu
Shrnutí: Pokud brief obsahuje nesprávná jména účtů, nadbytečné mezery nebo nevhodný profil, tým si toho může všimnout až po přípravě kampaně. Ukazujeme, jak ověřit uživatelská jména na IGu pomocí zdokumentovaného endpointu jsonscraper a exportovat zjištěné nesrovnalosti do CSV.
Role obrázku: doprovodná ilustrace 2 — jiný konkrétní aspekt
Sekce: Načtěte údaje a vytvořte přehled
Schéma znázorňuje cestu od CSV se seznamem účtů k přehledu, v němž zůstávají prázdná pole prázdná a shoda s pravidly se označuje samostatně.© jsonscraper · ilustrace vytvořená pomocí AI
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.

Lidé

Pro tento článek zatím nejsou uvedeni žádní lidé.

Pokračujte ve čteníJak ověřit leady z TikToku na IGu před předáním do CRM
Přečtěte si další článek

Proměňte přečtené ve funkční integraci

Prozkoumejte API sociálních dat jsonscraper, testujte požadavky a sestavte další workflow.

Prozkoumat API