TikTok’ta bir sorunla ilgili tartışmaları incelemek için önce uygun videoları bulun, ardından seçilen her video için yorumları isteyin. Ürün ekibi açısından sonuç, istek ve video bağlantısıyla ilişkilendirilmiş ham JSON yanıtlarından oluşan bir küme olabilir. Konu kuyruğu oluşturmadan önce yorumların gerçek yapısını kontrol edin: belgeler uç noktayı ve parametrelerini doğruluyor, ancak yanıttaki kayıt alanlarını açıklamıyor.
Bu, analitik işlem hattı için önemli bir aşamadır. Arama sonuçları ürünle ilgili bağlamı toplamaya yardımcı olur; yorumlarda ise hata bildirimleri, sorular veya geçici çözüm yolları bulunabilir. Sınıflandırmanın gerçek verilere dayanması için önce API yanıtını dönüştürmeden saklayın, ardından alanları alınan gerçek şemayla eşleştirin.
Video araması neden yeterli değil?
Uygulamanın veya cihazın adı videoları bulmaya yardımcı olur, ancak video açıklaması öncelikle içerik üreticisinin anlatımını yansıtır. İzleyiciler yorumlarda belirli arızaları ve kullanım biçimlerini tartışabilir. Bu nedenle yorumları toplamak, arama sonuçlarına kaynak video ile ilişkili ikinci bir veri katmanı ekler.
Önceki yazılarda TikTok aramasını izleme, açıklamalardan sorular çıkarma ve arama yanıtlarını işleme konuları ele alınmıştı. Buradaki amaç daha sınırlı: yorum uç noktasından gelen yanıtları toplamak ve sınıflandırma geliştirmeden önce yapılarını kontrol etmek. Bu yaklaşım analitik entegrasyon geliştiricileri, kullanıcı deneyimi araştırmacıları ve destek ekipleri için yararlıdır.
Arama ifadesinden doğrulanabilir veri kümesine
Ürün adını özellik veya model adıyla birleştirmek gibi birkaç somut arama terimi belirleyin. Arama yanıtını ve seçilen videoların URL’lerini saklayın. Ardından URL’leri kullanarak yorumları isteyin ve her ham yanıtı ayrı kaydedin. Şemayı doğruladıktan sonra gerekli alanları normalleştirebilir, yinelenenleri kaldırabilir ve metinleri konulara göre gruplayabilirsiniz.

- Arama: anahtar kelimeyle videoları isteyin ve desteklenen iki sonuç yapısını da kontrol edin.
- Seçim: ilgili videoları belirleyip kimliklerini ve URL’lerini saklayın.
- Yorumları toplama: URL’yi yorum uç noktasına iletin; sayfalamayı sürdürmek için döndürülen imleci kullanın.
- Kontrol: ham JSON’u saklayın ve alanların gerçek adlarını yanıttan belirleyin.
- Analiz: şemayı doğruladıktan sonra metinleri gruplayın ve örnekleri inceleme için bir kişiye iletin.
Hangi uç noktalar kullanılmalı?
TikTok Scraper API belgeleri, zorunlu keyword parametresini alan GET /searchVideo uç noktasını açıklıyor. Ek parametreler arasında count, cursor, date_posted, sort_by ve region bulunuyor. Yorumlar için zorunlu video_url parametresini alan GET /getCommentsByUrl uç noktası sunuluyor; ek parametreler arasında cursor, count ve region yer alıyor. Anahtar, license_key parametresiyle iletiliyor.
Arama yanıtındaki videolar tiktok.aweme_list veya tiktok.search_item_list[].aweme_info içinde bulunabilir. Örnek, her iki biçimi de işler, üst düzey durumu kontrol eder ve bulunan nesneleri saklar. Yorum yanıtı için dizi adı ya da alan adları varsaymaz: incelenebilmesi için alınan JSON’u olduğu gibi kaydedip görüntüler.
Python ile basit bir toplayıcı
Kod Python 3.8 ve sonraki sürümlerle uyumludur. requests paketini yükleyin ve anahtarı JSONSCRAPER_TIKTOK_LICENSE_KEY ortam değişkeninde tanımlayın. Betik, arama ve yorum yanıtlarını ayrı JSON dosyalarına yazar; her yorum yanıtını arama terimi ve video URL’siyle ilişkilendirir. Yanıtın gerçek yapısını kontrol edene kadar yorum alanları bilerek çıkarılmaz.

import json
import os
from pathlib import Path
import requests
BASE = "https://tiktok.evelode.com"
KEY = os.environ["JSONSCRAPER_TIKTOK_LICENSE_KEY"]
OUT = Path("tiktok_raw")
OUT.mkdir(exist_ok=True)
def get_json(path, params):
response = requests.get(
BASE + path,
params={**params, "license_key": KEY},
timeout=30,
)
response.raise_for_status()
data = response.json()
if data.get("status") != "ok":
raise RuntimeError("API returned non-ok status")
return data
def videos_from_search(data):
tiktok = data.get("tiktok") or {}
found = list(tiktok.get("aweme_list") or [])
for item in tiktok.get("search_item_list") or []:
aweme = (item or {}).get("aweme_info") or {}
if aweme:
found.append(aweme)
unique = {}
for video in found:
video_id = video.get("aweme_id")
video_url = video.get("share_url")
if video_id and video_url:
unique[video_id] = video
return list(unique.values())
for index, keyword in enumerate(("APP_NAME hata", "APP_NAME çalışmıyor")):
search = get_json("/searchVideo", {"keyword": keyword, "count": 10})
(OUT / f"search_{index}.json").write_text(
json.dumps(search, ensure_ascii=False, indent=2), encoding="utf-8"
)
for video in videos_from_search(search):
video_id = video["aweme_id"]
video_url = video["share_url"]
comments = get_json(
"/getCommentsByUrl",
{"video_url": video_url, "count": 30},
)
filename = f"comments_{video_id}.json"
record = {
"keyword": keyword,
"video_id": video_id,
"video_url": video_url,
"response": comments,
}
(OUT / filename).write_text(
json.dumps(record, ensure_ascii=False, indent=2), encoding="utf-8"
)
print(json.dumps(record, ensure_ascii=False, indent=2))
Betik yanıtın üst düzey durumunu kontrol eder, ardından JSON nesnesinin tamamını yazar. Böylece yorum tablosu oluşturmadan önce gerçek anahtarları, değer türlerini ve iç içe yapıyı inceleyebilirsiniz. API bir hata döndürürse kod durur ve bozuk bir sonucu sessizce kaydetmek yerine hatayı bildirir.
Ham JSON’dan konu kuyruğuna geçiş
Bir veya daha fazla yanıtı kontrol ettikten sonra, gerçekten gözlemlenen şemaya uygun bir normalleştirici oluşturun. Dönüşümü doğrulayabilmek ve kod değiştiğinde verileri yeniden işleyebilmek için ham JSON’u normalleştirilmiş satırların yanında saklayın. Bir kayıtta video bağlantısına, yorumun kaynak kaydına, toplama zamanına ve kullanılan etiketleme kuralının sürümüne yer vermek yararlıdır.
Konu etiketlemesine «hata», «kullanımla ilgili soru», «özellik isteği», «geri bildirim» ve «ürünle ilgili değil» gibi etiketlerle başlayabilirsiniz. Anahtar kelime kuralları veya bir sınıflandırıcı örnekleri sıralamaya yardımcı olabilir; atanan etiketi kaynak metinden ayrı saklayın. Görev oluşturmadan önce bir uzman yorumun bağlamını ve özgün videoyu kontrol etmelidir.
Yinelenenleri kaldırırken kimlik alanını yalnızca yanıtta bulunduğunu doğruladıktan sonra kullanın. Veride bir kimlik yoksa geçici anahtar olarak video URL’siyle normalleştirilmiş metnin birleşimi kullanılabilir. Bu yöntem aynı video içindeki eşleşen ifadeleri birleştirir, ancak kayıtların aynı yazara ait olduğunu göstermez.
Otomasyon ve veri kaynağının izlenebilirliği
Toplama işlemini cron, GitHub Actions veya n8n ile zamanlayın. Anahtarı çalışma ortamının gizli bilgilerinde saklayın; depoya, sonuç dosyalarına veya kayıtlara eklemeyin. Ham JSON yanıtlarını inceleme için erişilebilir tutun; saklama süresini ve erişim izinlerini ekibinizin gereksinimlerine ve geçerli platform kurallarına göre belirleyin.
İşlem hattının çalışmasını izlemek için başarılı arama isteklerinin, bulunan benzersiz videoların, saklanan yorum yanıtlarının ve API hatalarının sayısını kaydedin. Bu teknik ölçümler, sonucun hangi aşamada değiştiğini gösterir. Boş yanıt, istek hatası ve konu sınıflandırmasından sonra eşleşme bulunmaması farklı durumlardır; bu nedenle bunları ayrı ayrı saklayın.
Veritabanında toplama kayıtlarını, videoları, ham yorum yanıtlarını ve konu etiketleme kararlarını ayrı varlıklar olarak tutmak kullanışlıdır. Arama terimi ve video bağlantısı, elle kontrol için kaynağı açmayı sağlar. Şemayı doğruladıktan sonra imleçli sayfalamayı ekleyebilirsiniz: uç nokta cursor parametresini kabul eder ve sonraki istek, API’nin döndürdüğü değeri yorumlamaya çalışmadan iletmelidir.
Bu yaklaşım ne sağlar?
Ekip, konu kuyruğu oluşturmak için kullanabileceği tekrarlanabilir bir toplama süreci ve doğrulanabilir bir kaynak kümesi elde eder. Analist, videoya hangi arama teriminin ulaştırdığını ve hangi yorum yanıtının saklandığını izleyebilir. Yapı doğrulandıktan sonra geliştirici, bilinmeyen bir şemayı varsayımlarla değiştirmeden normalleştirme ve konusal gruplama ekleyebilir.
Raporunuzda arama terimlerini, çalıştırma tarihini, seçim ölçütlerini ve işlenen yanıtların sayısını belirtin. Sonuçlar belirli sorgular ve döndürülen veriler için geçerlidir; kaynaklarını ve bağlamlarını koruyarak tespit edilen tartışmaları incelemeye ve doğrulama planlamaya yardımcı olurlar.
Tek bir ürün ve birkaç tanı amaçlı aramayla başlayın: yanıtları saklayın, yorumların yapısını kontrol edin ve ardından normalleştiriciye yalnızca doğrulanmış alanları ekleyin. Uç nokta parametreleri API belgelerinde, ürün bilgileri ise TikTok Scraper API sayfasında yer alıyor.