Michael JohnsonHTTP 200 garantiert nicht, dass die tägliche TikTok-Überwachung Videos erfasst hat. Suchergebnisse können in aweme_list oder in search_item_list[].aweme_info liegen; ein Skript, das nur das erste Array ausliest, kann ohne Fehler beendet werden und einen leeren Bericht schreiben. Eine zuverlässige Prüfung bestätigt getrennt den Transport- und Anwendungsstatus, extrahiert beide unterstützten Strukturvarianten und protokolliert, wie viele eindeutige Videos bei diesem Lauf erfasst wurden.
Was Sie diagnostizieren sollten
Stellen Sie sich folgende Aufgabe vor: Ein Team sammelt jeden Morgen öffentliche Videos zu mehreren Suchbegriffen, um neue Beiträge über ein Produkt zu erkennen. Ein wichtiges Ergebnis dieses Prozesses ist eine reproduzierbare Liste gefundener Einträge mit Beschreibung, Autor, Veröffentlichungsdatum und verfügbaren Kennzahlen. Wenn der Bericht plötzlich leer ist, kann die Ursache in der Verarbeitung des JSON, einer veränderten Ergebnismenge, der erneuten Ausgabe bereits bekannter Videos oder einem tatsächlichen Fehler der Anfrage liegen. Eine einzelne Zahl – etwa die Länge von aweme_list – hilft nicht dabei, diese Fälle auseinanderzuhalten.
Beim TikTok Scraper API von jsonscraper nimmt die Suchroute /searchVideo den Pflichtparameter keyword sowie die zusätzlichen Parameter count, cursor, date_posted, sort_by und region entgegen. Die Dokumentation der Route beschreibt die Paginierung über cursor; dieser Wert sollte unverändert aus der vorherigen Antwort übernommen werden. Der Parameter count legt die gewünschte Anzahl von Ergebnissen fest, garantiert aber keine vollständige Erfassung aller Beiträge.
Unterteilen Sie die Prüfung in vier Signale
Eine nützliche Diagnose besteht aus vier unabhängigen Prüfungen. Erstens: Die HTTP-Anfrage wurde erfolgreich abgeschlossen. Zweitens: Der äußere Antwortwert status ist gleich ok, und tiktok.status_code entspricht einer erfolgreichen Antwort. Drittens: Das Objekt tiktok ist vorhanden und Einträge werden aus beiden dokumentierten Antwortstellen extrahiert. Viertens: Nach der Deduplizierung sind Einträge mit für die Speicherung geeigneten IDs übrig. Protokollieren Sie die Anzahl der extrahierten Elemente vor und nach der Deduplizierung: Die Differenz zeigt, ob bei der Normalisierung Duplikate aufgetreten sind.
Ein fehlendes Feld sollte leer bleiben, statt durch einen erfundenen Wert ersetzt zu werden. Beispielsweise kann der Aufrufzähler bei einem bestimmten Eintrag fehlen. Wenn Sie das ursprüngliche JSON neben der normalisierten Zeile speichern, können Sie später prüfen, ob die Information beim Parsen verloren ging oder bereits in der ursprünglichen Antwort fehlte.
Minimale Anfrage und Normalisierung in Python
Die Spezifikation von jsonscraper legt die Basisadresse https://tiktok.evelode.com sowie die Übermittlung des Schlüssels über den Anfrageparameter license_key fest. Das folgende Beispiel verwendet die dokumentierten Parameter; der Schlüssel wird aus einer Umgebungsvariable gelesen und nicht protokolliert. Installieren Sie die Abhängigkeit mit python -m pip install requests und setzen Sie anschließend JSONSCRAPER_TIKTOK_LICENSE_KEY in der Umgebung.
import json
import os
from datetime import datetime, timezone
from pathlib import Path
import requests
BASE_URL = "https://tiktok.evelode.com/searchVideo"
KEY = os.environ["JSONSCRAPER_TIKTOK_LICENSE_KEY"]
def extract_videos(payload):
"""Videos aus beiden bekannten Strukturen einer Suchantwort sammeln."""
tiktok = payload.get("tiktok") or {}
videos = []
for item in tiktok.get("aweme_list") or []:
if isinstance(item, dict):
videos.append(item)
for item in tiktok.get("search_item_list") or []:
if isinstance(item, dict):
aweme = item.get("aweme_info")
if isinstance(aweme, dict):
videos.append(aweme)
return videos
def main():
params = {
"license_key": KEY,
"keyword": "Beispiel-Suchbegriff zu einem Produkt",
"count": 20,
"region": "US",
}
response = requests.get(BASE_URL, params=params, timeout=30)
response.raise_for_status()
payload = response.json()
if payload.get("status") != "ok":
raise RuntimeError("Die API hat einen äußeren Status ungleich ok zurückgegeben")
tiktok = payload.get("tiktok")
if not isinstance(tiktok, dict):
raise RuntimeError("Im Antwortobjekt fehlt das Objekt tiktok")
if tiktok.get("status_code") != 0:
raise RuntimeError("Der interne status_code entspricht nicht dem erfolgreichen Wert 0")
raw_videos = extract_videos(payload)
unique = {}
for video in raw_videos:
video_id = video.get("aweme_id")
if video_id:
unique.setdefault(str(video_id), video)
snapshot = {
"collected_at": datetime.now(timezone.utc).isoformat(),
"keyword": params["keyword"],
"status": payload.get("status"),
"status_code": tiktok.get("status_code"),
"raw_items": len(raw_videos),
"unique_items": len(unique),
"has_more": tiktok.get("has_more"),
"cursor": tiktok.get("cursor"),
"videos": list(unique.values()),
}
Path("snapshots").mkdir(exist_ok=True)
stamp = datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%SZ")
Path(f"snapshots/{stamp}.json").write_text(
json.dumps(snapshot, ensure_ascii=False, indent=2),
encoding="utf-8",
)
print({
"status": snapshot["status"],
"status_code": snapshot["status_code"],
"raw_items": snapshot["raw_items"],
"unique_items": snapshot["unique_items"],
"has_more": snapshot["has_more"],
})
if __name__ == "__main__":
main()Das Skript prüft die Transportschicht mit raise_for_status() und kontrolliert anschließend den äußeren Status, das Vorhandensein des Objekts tiktok sowie den internen status_code. Danach extrahiert es Einträge aus den beiden Suchstrukturen, dedupliziert sie anhand von aweme_id und speichert einen Snapshot mit dem Erfassungszeitpunkt. Sind keine passenden Einträge vorhanden, enthält die Datei trotzdem Angaben zum Lauf. So lässt sich ein gespeichertes leeres Ergebnis von einem fehlenden Bericht unterscheiden.
Snapshots in ein Signal für das Team umwandeln
Führen Sie das Skript planmäßig mit cron, CI oder einem Workflow-Scheduler aus. Speichern Sie für jede Suchanfrage separate Snapshots oder nehmen Sie das Schlüsselwort in den Dateinamen auf. In einer Statustabelle genügen der Ausführungszeitpunkt, der Status, die Anzahl der extrahierten und eindeutigen Einträge sowie das Flag has_more. Eine Benachrichtigung ist sinnvoll, wenn eine Anfrage eine Ausnahme auslöst, erforderliche Antwortbestandteile fehlen oder sich die Zahl der extrahierten Einträge im Vergleich zur eigenen Historie stark verändert.
Ein solcher Vergleich deckt eine Anomalie in der Pipeline auf, erklärt aber nicht von selbst deren Ursache. Eine geringere Zahl an Ergebnissen kann die aktuelle Zusammensetzung der Trefferliste widerspiegeln und muss nicht auf einen Defekt der API oder des Parsers hindeuten. Speichern Sie daher das ursprüngliche JSON, vergleichen Sie identische Parameter und prüfen Sie die gefundenen IDs. Legen Sie den Schwellenwert für Benachrichtigungen anhand Ihrer Beobachtungen zu genau dieser Suchanfrage fest, nicht anhand einer universellen Zahl.
Verwenden Sie für die Paginierung den cursor aus der Antwort und beenden Sie den Durchlauf, sobald die API meldet, dass keine weiteren Ergebnisse vorliegen. Speichern Sie die verwendeten Cursor und Anfrageparameter, damit sich ein Lauf reproduzieren lässt. Die Parameter date_posted und sort_by ermöglichen einen Zeitfilter und eine Sortierung; wenn die Aufgabe wiederholbare Vergleiche erfordert, sollten diese Parameter bei jedem Lauf gleich bleiben.
So lesen Sie das Ergebnis
Nach der Einführung hat das Team überprüfbare Antworten auf drei praktische Fragen: Wurde die Anfrage ausgeführt, wo liegen die Ergebnisse im JSON und wie viele eindeutige Videos sind im gespeicherten Snapshot enthalten? Das verkürzt den Weg von einer leeren Tabelle zur Diagnose: Zuerst werden Status und Struktur geprüft, anschließend Parameter, Duplikate und der Inhalt der ursprünglichen Antwort.
Das Antwortschema und die verfügbaren Felder können je nach Eintrag variieren. Bei einer Live-Prüfung von jsonscraper am 25. Oktober 2026 lieferte die Suche Felder für ID, Beschreibung, Autor und Statistiken; die Werte eines konkreten Eintrags sollten als optional betrachtet werden. Ein betrieblicher Bericht speichert die tatsächlich erhaltenen Daten und ersetzt fehlende Werte nicht durch Nullen.
Beginnen Sie auf der Seite zur TikTok Scraper API und gleichen Sie die genauen Routen und Parameter mit der offiziellen API-Dokumentation ab. Eine solche Prüfung ist vor dem Start der Überwachung hilfreich: Der Bericht wird zu einem beobachtbaren Ergebnis, dessen Qualität sich diagnostizieren lässt.
