CRM’ye Aktarmadan Önce TikTok Potansiyel Müşterilerini IG’da Nasıl Kontrol Edersiniz?

Bir pazarlamacı, içerik üreticisinin belirli bir ürünü tartıştığı bir TikTok videosu bulabilir; ancak bu sinyalden doğrulanabilir bir kişiye ulaşmak daha zordur: TikTok ve IG’daki kullanıcı adları farklı olabilir, profil gizli olabilir ya da kişiyle doğrulanmış bir bağlantısı hiç olmayabilir. Pratik sonuç, otomatik olarak oluşturulmuş “hazır potansiyel müşteri” listesi değil; kaynak video, TikTok içerik üreticisi, olası IG kullanıcı adı, API yanıtı ve sonraki inceleme durumu gibi bilgileri içeren bir kontrol tablosudur.

Aşağıda bu iş için temel bir Python süreci yer alıyor. Süreç, herkese açık videoları bir anahtar kelimeyle arar, içerik üreticisine ait erişilebilir alanları çıkarır ve yalnızca doğrulanması için önceden makul bir kullanıcı adınız varsa IG profillerini kontrol eder. API, kullanıcı adına göre profil verilerini alabilir; iki hesabın aynı kişiye ait olduğunu kendiliğinden belirleyemez.

Otomatikleştirmeye değer sonuç

Evde kahve hazırlama ekipmanı satan ve içecek yapımıyla ilgili herkese açık videolar paylaşan içerik üreticilerini bulmak isteyen bir ekibiniz olduğunu düşünün. İçeriği ilk kez keşfetmek için elle arama yapmak yararlıdır; ancak bu işlem tekrarlandığında, hangi videonun bir kişiye ulaşılmasını sağladığını, profil adının nereden geldiğini ve tam olarak neyin kontrol edildiğini takip etmek zorlaşır.

İş akışı üç eylemi birbirinden ayırır: TikTok’ta video aramak, gözlemlenebilir verileri kaydetmek ve olası IG profilini kontrol etmek. Böylece analist tek bir CSV dosyasını açıp her adayın izlediği yolu görebilir. IG alanları yalnızca kullanıcı adı herkese açık bir açıklamada ya da içerik üreticisinin bağlantısında bulunmuşsa veya başka erişilebilir materyaller üzerinden bir kişi tarafından doğrulanmışsa doldurulmalıdır.

Bu yöntem; manuel olarak değerlendirilmek üzere küçük, tekrarlanabilir bir listeye ihtiyaç duyan ajanslar, araştırma ekipleri veya şirket içi pazarlamacılar için yararlıdır. Bulgunun bağlamını korur ve benzer kullanıcı adlarını aynı kişi olduklarına dair bir iddiaya dönüştürmez.

Hangi alanlar alınabilir?

Belgelenmiş TikTok /searchVideo rotası, zorunlu keyword parametresini kabul eder; ayrıca count, date_posted, sort_by, region ve cursor parametreleri de kullanılabilir. Gözlemlenen yanıtlarda video kimliği, açıklama, yayın tarihi, bağlantı, içerik üreticisi bilgileri ve herkese açık etkileşim sayaçları bulunur. Gerçek alan kümesi değişebileceğinden aşağıdaki kod, güvenli okuma yaparak eksik değerleri boş bırakır.

Bu senaryoda IG için username parametresini kullanan, belgelenmiş GET rotası /v1/user/by/username uygulanır. Yanıtta kullanıcı adı, görünen ad, gizlilik ve doğrulama durumu, gönderi, takipçi ve takip edilen sayıları ile biyografi bulunabilir. Bunlar, uzman tarafından incelenip karar verilmek üzere sunulan bilgilerdir; içerik üreticisi puanı değildir.

TikTok API belgeleri arama parametrelerini, IG API belgeleri ise IG yöntemlerini ve parametrelerini açıklar. jsonscraper API’sinin yerleşik tanımları da rotaları, parametre adlarını ve gözlemlenen yanıt biçimlerini kaydeder; belirtilen kontrollerin tarihi 25 Ekim 2026’dır.

Anahtarları ve aday listesini ayarlayın

API anahtarlarını ortam değişkenlerinde saklayın: JSONSCRAPER_TIKTOK_LICENSE_KEY ve JSONSCRAPER_INSTAGRAM_LICENSE_KEY. Bunları kaynak koda, CSV’ye veya iş günlüklerine koymayın. İstekler kitaplığını yüklemek için python -m pip install requests komutunu kullanın. Aşağıdaki örnek Python 3.8 ve sonrası için hazırlanmıştır.

import csv
import os
import sys
from urllib.parse import urlencode

import requests

TIKTOK_KEY = os.environ.get("JSONSCRAPER_TIKTOK_LICENSE_KEY")
INSTAGRAM_KEY = os.environ.get("JSONSCRAPER_INSTAGRAM_LICENSE_KEY")

if not TIKTOK_KEY or not INSTAGRAM_KEY:
    sys.exit("Set JSONSCRAPER_TIKTOK_LICENSE_KEY and JSONSCRAPER_INSTAGRAM_LICENSE_KEY")


def get_json(base_url, path, params):
    response = requests.get(
        f"{base_url}{path}",
        params=params,
        timeout=30,
    )
    response.raise_for_status()
    return response.json()


def extract_videos(payload):
    """Handle both observed TikTok search result locations."""
    if payload.get("status") != "ok":
        raise RuntimeError(f"TikTok API status: {payload.get('status')}")

    tiktok = payload.get("tiktok") or {}
    videos = list(tiktok.get("aweme_list") or [])
    for item in tiktok.get("search_item_list") or []:
        video = item.get("aweme_info")
        if video:
            videos.append(video)

    unique = {}
    for video in videos:
        video_id = video.get("aweme_id")
        if video_id:
            unique[video_id] = video
    return list(unique.values())


keyword = "домашний кофе"
tiktok_payload = get_json(
    "https://tiktok.evelode.com",
    "/searchVideo",
    {
        "license_key": TIKTOK_KEY,
        "keyword": keyword,
        "count": 20,
        "date_posted": "this-month",
        "sort_by": "relevance",
    },
)

rows = []
for video in extract_videos(tiktok_payload):
    author = video.get("author") or {}
    stats = video.get("statistics") or {}
    rows.append({
        "tiktok_video_id": video.get("aweme_id", ""),
        "tiktok_url": video.get("share_url", ""),
        "video_description": video.get("desc", ""),
        "created_at": video.get("create_time", ""),
        "tiktok_username": author.get("unique_id", ""),
        "tiktok_author_name": author.get("nickname", ""),
        "tiktok_followers": author.get("follower_count", ""),
        "views": stats.get("play_count", ""),
        "likes": stats.get("digg_count", ""),
        "instagram_username": "",
        "instagram_status": "not checked",
        "instagram_followers": "",
        "instagram_is_private": "",
        "manual_match_review": "required",
    })

# Заполняйте этот словарь только username, найденными отдельно
# и внесёнными после ручной проверки источника.
verified_instagram_usernames = {
    # "tiktok_video_id": "instagram_username"
}

for row in rows:
    username = verified_instagram_usernames.get(row["tiktok_video_id"])
    if not username:
        continue

    ig_payload = get_json(
        "https://ig.jsonscraper.com",
        "/v1/user/by/username",
        {
            "license_key": INSTAGRAM_KEY,
            "username": username,
        },
    )
    if ig_payload.get("status") != "ok":
        row["instagram_status"] = "api status: " + str(ig_payload.get("status"))
        continue

    profile = ig_payload.get("ig") or {}
    row["instagram_username"] = profile.get("username", username)
    row["instagram_status"] = "profile returned"
    row["instagram_followers"] = profile.get("follower_count", "")
    row["instagram_is_private"] = profile.get("is_private", "")
    row["manual_match_review"] = "check relationship manually"

if rows:
    with open("social_lead_checks.csv", "w", newline="", encoding="utf-8") as f:
        writer = csv.DictWriter(f, fieldnames=rows[0].keys())
        writer.writeheader()
        writer.writerows(rows)
else:
    print("No video rows returned for this query.")

İşleyici neden iki yanıt yapısını dikkate alıyor?

TikTok arama sonuçlarında videolar iki yerde bulunabilir: tiktok.aweme_list ve tiktok.search_item_list[].aweme_info. Gözlemlenen bir arama yanıtında ilk liste boş olabilirken öğeler ikincisinde yer alabiliyordu. Bu nedenle örnek iki kaynağı birleştirir ve aweme_id üzerinden tekrarları ayıklar. Önce dıştaki status değerini kontrol eder, ardından tiktok nesnesini okur.

Kod yalnızca yanıtta gerçekten bulunan alanları kaydeder. Boş bir değer, alanın alınan nesnede bulunmadığı anlamına gelir; sıfır olarak yorumlanmamalıdır. Video bağlantılarını ve açıklamalarını metriklerle birlikte saklamak yararlıdır; aksi takdirde tablo daha sonra incelenirken ilk bağlamını kaybeder.

Sayfalamayı yalnızca gerektiğinde ekleyin

Örnek tek bir sayfa ister ve yalnızca dönen öğeleri işler. Aramayı sürdürmek gerekiyorsa belgelerde video araması için cursor parametresi tanımlanmıştır; değeri önceki yanıttan alınır. Cursor değerini opak bir değer olarak saklayın ve kendiniz hesaplamadan iletin. Yanıt devam edecek sonuç kalmadığını bildirdiğinde ya da ekipçe belirlenen sınıra ulaşıldığında döngüyü durdurun. Sayfalama dönen sonuç kümesini genişletir, ancak konu hakkındaki tüm gönderilerin eksiksiz biçimde tarandığını iddia etmek için dayanak oluşturmaz.

Otomatik dışa aktarma eklemeden önce kendi anahtarınızla gerçek yanıtı kontrol edin ve makul sayıda sayfa seçin. Ham JSON’u normalleştirilmiş satırla birlikte ya da çalıştırma tarihine göre ayrı olarak saklayın. Böylece bir yanıt alanının değişip değişmediğini anlayabilir ve şema değiştiğinde veriyi yeniden işleyebilirsiniz.

CSV’yi değerlendirme sürecinde kullanma

Tablodaki satırları video bağlantısı, açıklama, içerik üreticisi ve doldurulmuş IG profili bulunmasına göre filtreleyebilirsiniz. İlk inceleme sırası için basit durumlar kullanışlıdır: “video bulundu”, “IG kullanıcı adı bulundu”, “profil döndürüldü”, “hesap bağlantısı bir kişi tarafından doğrulandı” ve “hariç tutuldu”. Durumlar kontrol sürecini açıklar; içerik üreticisinin niteliğini veya niyetini değil.

Tekrarlanabilir bir rapor gerekiyorsa betiği zamanlanmış olarak çalıştırın ve verilerin alındığı tarihi ayrı bir sütuna ekleyin. Böylece anlık görüntüleri karşılaştırmak, örneğin profilin takipçi sayısı gibi erişilebilir alanlarda çalıştırmalar arasında nelerin değiştiğini gösterir. TikTok ve IG metrikleri platform ve gözlem zamanı belirtilerek ayrı saklanmalıdır: bunlar farklı bağlamlar ve farklı API yanıtlarıdır.

Daha büyük hacimli bir akış için CSV’yi platform ve video kimliğini temel alan birincil anahtarlı veritabanıyla değiştirin. İlk metin sorgusunu, toplama zamanını ve ham yanıtı saklayın. Slack bildirimi göndermek veya satırı CRM’ye aktarmak, profil eşleşmesi olduğunda hemen değil, profiller arasındaki bağlantı manuel olarak doğrulandıktan sonra yapılmalıdır.

Yorumlama sınırları ve güvenli kullanım

Anahtar kelime araması, bulunan API sonuçlarını döndürür; tüm gönderilerin eksiksiz listesini değil. Görüntülenme, beğeni ve takipçi sayıları, istek anındaki yanıtın anlık görüntüsüdür. Bunlar çalışma listesini sıralamak ve daha sonra incelemek için uygundur; tek başlarına ticari niyeti, hedef kitleyi veya iletişim kurma iznini doğrulamazlar.

Profiller arasındaki bağlantıyı açık, herkese açık işaretlerle doğrulayın ve kontrolü kimin, ne zaman yaptığını kaydedin. IG kullanıcı adı, doğrulanabilir bir kaynağı olmayan üçüncü taraf bir tablodan alınmışsa durumu “kontrol edilmeli” olarak bırakın. Gizli profiller veya eksik veriler, boşlukları varsayımla doldurmaya çalışmadan, ayrı kontrol sonuçları olarak gösterilmelidir.

Anahtarları çalışma ortamının gizli bilgi deposunda kullanın, dışa aktarımlara erişimi sınırlayın ve araştırmanın amacına uygun bir saklama süresi belirleyin. CRM’ye yalnızca sonraki manuel çalışma için gerekli alanları aktarın; ilgili platform kurallarına ve veri işleme gerekliliklerine uyun.

Sonuç

Çalıştırma tamamlandığında, bulunan videoları, içerik üreticilerini ve erişilebilir metrikleri içeren bir CSV ile IG kontrolüne ayrılmış alanlar oluşturulur. Betik elle, CI içinde zamanlanmış olarak veya bir otomasyon platformundaki HTTP isteği düğümü aracılığıyla çalıştırılabilir. Temel pratik ilke, veri toplama ve yapılandırma adımlarını otomatikleştirirken hesaplar arasındaki bağlantıyı doğrulamayı bir kişinin kontrol edebileceği aşama olarak bırakmaktır.

Rotaları ve kullanılabilir parametreleri kontrol etmek için TikTok Scraper API ve IG Scraper API sayfalarından başlayın. Ürün sayfalarında istek örnekleri ve belgelere bağlantılar bulunur; veri toplamayı kalıcı bir sürece eklemeden önce küçük bir istekle başlayın.