API-Schnittstelle

Es gibt grundlegend drei Funktionen mit der API-Schnittstelle, die Sie als Premium-Mitglied nutzen können: 1. Sie können sämtliche Diagramme und Grafiken in Ihre Website oder Ihr Intranet via Hotlinking integrieren. Wie wär’s mit dem Tracking Ihres Mediums oder der direkte Vergleich zur Konkurrenz als Diagramm? 2. Sie können auf das Medientracking in den Formaten CSV, JSON und XML in Echtzeit zugreifen. Über diese Funktion können Sie eigene Excel-Statistiken erstellen oder sie in eigene Skripte für die Website einbauen. 3. Sie haben Zugriff auf die komplette Datenbank (CSV, JSON, PDF und XML) mit allen Medien und Channels. Die Inhalte sind umfangreicher und aktueller als für normale Besucher dieser Website!

API-Schnittstelle

1. Einbindung der Diagramme → Sie können sämtliche Grafiken auch auf Ihrer Website oder in Ihrem Intranet veröffentlichen. Die Daten werden live generiert.

2. Tracking einzelner Medien → Sie können alle Facebook-, Twitter-, Google+, Klout- und PeerIndex-Werte eines Mediums im Form eines Trackings abrufen. Die Datei-Formate sind CSV, JSON und XML.

3. Die komplette Datenbank → Die Werte aller Medien können Sie direkt über Ihre Website oder Ihr (nicht öffentliches) Intranet abrufen oder als Excel-Tabelle speichern. Die Formate sind CSV, JSON, PDF und XML.

1. Einbindung der Diagramme

Sie können jedes beliebige Diagramm und jede Grafik auf www.TRAXY.de auch in Ihre Website oder in Ihr Intranet einbinden. Dabei bleiben die Inhalte nicht statisch, sondern werden “on-the-fly” bei jedem Aufruf neu generiert und bleiben so auf dem aktuellsten Stand. Beispielgrafiken:

Die Handhabung ist denkbar einfach: Kopieren Sie einfach die gewünschte Grafik-URL eines Diagrammes (z.B. rechte Maustaste » Grafikadresse kopieren) und fügen Sie diese in Ihre Website als HTML-img-Tag ein. Sie können auch die praktischen Link-Builder (weiter unten) verwenden. Der Dateityp ist immer PNG, der Hintergrund immer transparent. Beachten Sie, dass Sie nur als Premium-Kunde die Grafiken via Hotlinking einbinden dürfen.

Welche Diagramme gibt es?

Es gibt zahlreiche Diagrammtypen auf www.TRAXY.de, die Sie alle einbetten können. So finden Sie in den jeweiligen Medienprofilen das Medientracking, in den Länderseiten werden die Medien einer bestimmten Region gegenübergestellt, beim Medienvergleich werden zwei Medien direkt miteinander verglichen und bei den Gewinnern&Verlierer finden Sie die tagesaktuellen Charts.

Link-Builder

Medientracking (als Grafik-Datei)

https://ssl.webpack.de/grafiken.traxy.de/medienprofil_1_000000_1_1.png

Medienvergleich (als Grafik-Datei)

https://ssl.webpack.de/grafiken.traxy.de/medienvergleich_1_999999_999999_2_1.png

Authentifizierung

Damit das so genannte Hotlinking funktioniert, muss Ihre Domain freigeschaltet werden. Nur als Premium-Kunde haben Sie Zugriff auf die exklusiven Funktionen der API-Schnittstelle. Wenn Sie bereits Premium-Mitglied sind, dann haben Sie bei der Registrierung eine Domain angegeben. Über diese Domain dürfen Sie grafische Inhalte dieser Website bei sich inkludieren.

SSL-Verbindung

Sie können die Diagramme und alle anderen Grafiken auch über eine gesicherte SSL-Verbindung abrufen. Aus Sicherheitsgründen wird dieser Verbindungstyp empfohlen! Setzen Sie dazu vor den Link einfach “https://ssl.webpack.de/”. Möchten Sie z.B. die TOP-10 Radiosender bei Facebook per SSL abrufen, wäre dies die gesicherte Verbindung: https://ssl.webpack.de/grafiken.traxy.de/grafik_topten_1_1_0_1_0_1.png Der normale Link wäre http://grafiken.traxy.de/grafik_topten_1_1_0_1_0_1.png

↑

2. Tracking einzelner Medien [CSV|JSON|XML]

Wenn Sie die Tracking-Werte von Facebook, Twitter, Google+, Klout und vom PeerIndex eines einzelnen Mediums in den Formaten CSV, JSON oder XML abrufen wollen, benötigen Sie lediglich den praktischen Link-Builder. Er gibt Ihnen den passenden Link aus:

Link-Builder → Medientracking (als Text-Datei)

https://ssl.webpack.de/api.traxy.de/tracking_000000.csv

CSV

Sie können die CSV-Datei z.B. in ein Script für Ihre Website einbinden, um on-the-fly gewünschte Diagramme oder Tabellen zu erstellen. Sie können die Datei aber auch manuell herunterladen und in Ihr Tabellenkalkulationsprogramm (z.B. Microsoft Excel oder LibreOffice Calc) importieren. Der verwendete Zeichensatz ist UTF-8, der Feldtrenner ein Semikolon und der Texttrenner das Anführungszeichen.

JSON

Auch mit dem etablierten JSON-Format wird die Datenabfrage (z.B. über cURL) ermöglicht. Der verwendete Zeichensatz ist UTF-8, das Dokument ist JSON valide und enthält das gesamte Tracking eines einzelnen Mediums.

XML

Die dritte Möglichkeit ist das Parsen über das XML-Format. Der verwendete Zeichensatz ist auch hier das UTF-8.

Weitere Hinweise

Ein Tracking aller Medien in einer einzigen Datei ist aufgrund der Größe nicht vorgesehen. Sie können nur gezielt von einzelnen Medien die Werte abrufen. Das Tracking reicht logischerweise nicht unbegrenzt in die Vergangenheit, sondern beginnt, sobald das Soziale Netzwerk eines Mediums in die TRAXY.de-Datenbank eingetragen wurde. Sie können das Tracking von bis zu 90 Tagen, also 3 Monaten abrufen! Die nachfolgenden Felder werden über die Dateien ausgegeben:

Name → Der Name des Senders, der Zeitschrift oder Zeitung
Medien-ID → Jedes Medium besitzt eine einmalige ID
Datum → Stand dieser Zeile bzw. dieses Eintrags
Twitter (Followerzahl) → Die Anzahl der Follower bei Twitter (absolut)
Facebook (Fanzahl) → Die Anzahl der Fans bei Facebook (absolut)
Facebook (sprechen darüber) → Die neue Facebook-Metric (absolut)
Google+ Follower → Die Anzahl der Follower bei Google+ (absolut)
Klout (Score) → Der Score-Wert von Klout (0 bis 100)
Klout (Network) → Ihr Einfluss in Ihrem Netzwerk (0 bis 100)
Klout (Amplification) → Die Intensität Ihres Netzwerkes (0 bis 100)
Klout (True Reach) → Tatsächliche Reichweite Ihres Netzwerkes (absolut)
PeerIndex (Score) → Der PeerIndex (0 bis 100)
PeerIndex (Activity) → Ihr Aktivitäts-Score-Wert (0 bis 100)
PeerIndex (Audience) → Tatsächliche Reichweite (0 bis 100)
PeerIndex (Authority) → Autorität und Vertrauen (0 bis 100)

SSL-Verbindung

Sie können die Dateien auch über eine gesicherte SSL-Verbindung abrufen. Aus Sicherheitsgründen wird dieser Verbindungstyp empfohlen! Setzen Sie dazu vor den Link einfach “https://ssl.webpack.de/”. Möchten Sie z.B. das Tracking von radioeins im Format XML per SSL abrufen, wäre dies die gesicherte Verbindung: https://ssl.webpack.de/api.traxy.de/tracking_000173.xml Der normale Link wäre http://api.traxy.de/tracking_000173.xml

HTTP-Authentifizierung

Nur als Premium-Kunde haben Sie exklusiven Zugriff auf die API. Für den Abruf der Schnittstelle sind ein Benutzername und ein Passwort erforderlich, das Ihnen nach Freischaltung des Premium-Accounts postalisch zugesandt wird. Bewahren Sie die Zugangsdaten – auch in Ihrem Interesse – sicher auf und schützen Sie Ihr Skript, das die Zugangsdaten enthält. Aus Performancegründen wird ebenfalls dazu geraten, die Werte als Cache zwischenzuspeichern (z.B. Refresh alle 60 Minuten). Wenn Sie den Datei-Link manuell aufrufen möchten, müssen Sie die HTTP-Authentifizierung per Hand eingeben (Benutzername + Passwort). Achten Sie auch beim manuellen Abruf darauf, die Zugangsdaten nur dann im Webbrowser dauerhaft zu speichern, wenn kein Unbefugter an Ihrem Computer Zugriff hat. Sie können die Datei direkt in Ihr PHP-Script z.B. mit include, require oder file_get_contents einbinden. Hierbei gibt es mehrere Möglichkeiten.

PHP-Beispiel:

<?php
header(‘Content-Type: text/xml; charset=UTF-8′);
$bn = “Benutzername”;
$pw = “Passwort”;
$datei = file_get_contents(“https://”.$bn.”:”.$pw.”@ssl.webpack.de/api.traxy.de/tracking_000173.xml”);
echo $datei;
?>

↑

3. Die komplette Datenbank [CSV|JSON|PDF|XML]

Sie können die komplette Datenbank mit allen erfassten Medien aus dem gesamten deutschsprachigen Raum aufrufen, kommerziell weiterverwerten, in Ihre Website oder in Ihr Intranet integrieren oder sie einfach als Datei für Ihr Tabellenkalkulationsprogramm speichern. Nur als Premium-Kunde haben Sie direkten Zugriff auf diese Dateien. Darüber hinaus ist der Datenbestand aktueller und umfangreicher: Die nachfolgenden Dateien werden stündlich (!) aktualisiert und als normaler Besucher können Sie die Werte (z.B. in den interaktiven Tabellen bei den Länderseiten) nur anschauen, nicht aber als Datei exportieren, bearbeiten und weiterverwerten. Mit der API und den Formaten CSV, JSON, PDF und XML haben Sie exklusiv als Premium-Kunde den perfekten Zugang! Die Datenbanken enthalten diese Felder bzw. Spalten:

Name → Der Name des Senders, der Zeitschrift oder Zeitung
Medien-ID → Jedes Medium besitzt eine einmalige ID
Medium → Fernsehsender, Radiosender, Zeitschrift, Zeitung
Mediengruppe / Verlag / Firma → zu welcher Gruppe gehört das Medium?
Typ → ein Privater Sender? Eine Tages- oder eine Wochenzeitung?
Medienprofil-Link → Das ausführliche Medienprofil bei TRAXY.de
Twitter (Followerzahl) → Die Anzahl der Follower bei Twitter (absolut)
Facebook (Fanzahl) → Die Anzahl der Fans bei Facebook (absolut)
Facebook (sprechen darüber) → Die neue Facebook-Metric (absolut)
Google+ Follower → Die Anzahl der Follower bei Google+ (absolut)
Klout (Score) → Der Score-Wert von Klout (0 bis 100)
Klout (Network) → Ihr Einfluss in Ihrem Netzwerk (0 bis 100)
Klout (Amplification) → Die Intensität Ihres Netzwerkes (0 bis 100)
Klout (True Reach) → Tatsächliche Reichweite Ihres Netzwerkes (absolut)
PeerIndex (Score) → Der PeerIndex (0 bis 100)
PeerIndex (Activity) → Ihr Aktivitäts-Score-Wert (0 bis 100)
PeerIndex (Audience) → Tatsächliche Reichweite (0 bis 100)
PeerIndex (Authority) → Autorität und Vertrauen (0 bis 100)
Verknüpfte Orte → Länder, Bundesländer, Städte

Ihnen stehen die populären Dateiformate CSV, JSON, PDF und XML zur Verfügung:

CSV

Sie können die Hauptmedien und die Channels als CSV-Datei herunterladen. Sie können sie z.B. in ein Script für Ihre Website einbinden, um on-the-fly gewünschte Diagramme oder Tabellen zu erstellen. Sie können die Datei aber auch manuell herunterladen und in Ihr Tabellenkalkulationsprogramm (z.B. Microsoft Excel oder LibreOffice Calc) importieren. Der verwendete Zeichensatz ist UTF-8, der Feldtrenner ein Semikolon und der Texttrenner das Anführungszeichen.

http://api.traxy.de/datenbank.csv http://api.traxy.de/channels.csv

JSON

Auch mit dem etablierten JSON-Format wird die Datenabfrage (z.B. über cURL) ermöglicht. Der verwendete Zeichensatz ist UTF-8, das Dokument ist JSON valide und enthält die gesamte Datenbank bzw. die Channels der Hauptmedien.

http://api.traxy.de/datenbank.json http://api.traxy.de/channels.json

PDF

Mit dem plattformunabhängigen und weitverbreiteten PDF-Format benötigen Sie weder Programmier- noch sonstige Office-Kenntnisse. Das Dokument öffnen Sie einfach mit dem Adobe Reader, der auf den allermeisten Computern installiert ist. Die Ausgabe ist alphabetisch nach dem Mediennamen sortiert.

http://api.traxy.de/datenbank.pdf http://api.traxy.de/channels.pdf

XML

Die vierte Möglichkeit ist die Abfrage über das XML-Format. Der verwendete Zeichensatz ist auch hier das UTF-8. Für das Parsen der kompletten Datenbank in XML verwenden Sie folgenden Link.

http://api.traxy.de/datenbank.xml http://api.traxy.de/channels.xml

SSL-Verbindung

Sie können die Dateien auch über eine gesicherte SSL-Verbindung abrufen. Aus Sicherheitsgründen wird dieser Verbindungstyp empfohlen! Setzen Sie dazu vor den Link einfach “https://ssl.webpack.de/”. Möchten Sie z.B. die datenbank.json per SSL abrufen, wäre dies die gesicherte Verbindung: https://ssl.webpack.de/api.traxy.de/datenbank.json Der normale Link wäre http://api.traxy.de/datenbank.json

HTTP-Authentifizierung

PHP-Beispiel:

<?php
header(‘Content-Type: text/csv; charset=UTF-8′);
$bn = “Benutzername”;
$pw = “Passwort”;
$datei = file_get_contents(“https://”.$bn.”:”.$pw.”@ssl.webpack.de/api.traxy.de/datenbank.csv”);
echo $datei;
?>

↑

Fragen?

Haben Sie technische Fragen oder Verbesserungsvorschläge? Ich bin immer bemüht, diese Website und meinen Service zu verbessern. Ich freue mich über Ihre Rückmeldung!

Sebastian Pertsch
Amsterdamer Straße 2
13347 Berlin-Mitte
Deutschland

Telefon: +49 (0)1578 7232577
Telefax: +49 (0)3212 7232577