Die SeoMap-REST-API für Agenturen und Entwickler
Was tatsächlich automatisiert wird
Scan-Ergebnisse von Hand aus einem Dashboard abzulesen, funktioniert für eine Handvoll Kunden. Es funktioniert nicht mehr in dem Moment, in dem jemand diese Daten woanders braucht — ein kundenseitiges Dashboard, eine Tabelle, die sich selbst aktualisiert, ein Zapier- oder n8n-Workflow, der eine Slack-Nachricht postet, wenn der SoLV eines Keywords einbricht. Jeder dieser Fälle braucht dasselbe: einen Weg, SeoMaps eigene Daten programmatisch herauszuholen, statt sie von Hand zu kopieren. Genau dafür ist die REST-API da, nicht mehr — sie ist ein Lesepfad, kein Weg, das Produkt aus der Ferne zu steuern.
Was tatsächlich drinsteckt
Vier Endpunkte, alle GET, alle JSON: eine Liste der Projekte eines Kontos, die Scans zu einem Projekt, das Detail eines einzelnen Scans und die einzelnen Rasterpunkte hinter einem Scan — Rang, Status und Koordinaten für jeden gemessenen Punkt. Letzteres zählt mehr, als es klingt: Es sind dieselben Punktdaten, die die Heatmap selbst rendert, jetzt als reine Zeilen statt als Pixel verfügbar — genau das macht eine eigene Visualisierung oder ein kundenspezifisches Berichtsformat möglich, ohne einen Scan neu nachzubauen.
Die Authentifizierung läuft über ein Bearer-Token — ein Key, in den Einstellungen erzeugt und widerrufbar, bei der Erstellung genau einmal im Klartext gezeigt, wie bei jeder vernünftigen API-Key-Oberfläche. Jede Antwort ist auf den Owner des Keys begrenzt; wer nach einem fremden Projekt fragt, bekommt ein schlichtes „nicht gefunden“ — keine Fehlermeldung, die die Existenz der ID bestätigt, den Zugriff aber verweigert. Interne Zahlen — Kosten, belastete Credits, BYOK-Status — kommen bewusst nicht über die API zurück, dieselbe Grenze zu Abrechnungsdaten, die schon die öffentlichen Share-Links ziehen.
Für wen das wirklich gedacht ist
Zwei Gruppen ziehen unmittelbaren Nutzen daraus. Agenturen, die SeoMap für einen ganzen Kundenstamm nutzen, können ARP/ATRP/SoLV direkt in das Reporting-System einspeisen, das für Kunden ohnehin schon läuft — statt Kunden zu bitten, ein weiteres Tool zu prüfen, eine Datenquelle, dort, wo das eigentliche Reporting der Agentur ohnehin lebt. Entwickler und technisch versierte Freelancer bekommen den direkteren Vorteil: SeoMap in Zapier, n8n oder Make über deren generisches HTTP-Modul einzubinden, braucht einen API-Key und ein paar Minuten, keine native Integration, die es erst geben müsste. Ein eingebrochener Rang an einem bestimmten Punkt, ein abgeschlossener wiederkehrender Scan — beides kann einen Webhook-Workflow auslösen, sobald die Daten da sind, ohne ein Dashboard auf Änderungen abklappern zu müssen.
Was bewusst fehlt
Diese Grenze verdient Klarheit, weil „API“ mehr Annahmen weckt, als das Feature verspricht. Es ist nur lesend — es gibt keinen Endpunkt, um einen Scan zu starten, ein Projekt anzulegen oder einen Zeitplan zu ändern; das passt natürlich zu wiederkehrenden Scans, die das eigentliche Auslösen nach eigenem Zeitplan übernehmen, während die API nur dazu dient, das Ergebnis abzuholen. Es gibt auch keinen Bulk-Export-Endpunkt über die vier Ressourcen hinaus — für ein einmaliges vollständiges CSV der Punkte eines Scans ist der eingebaute Export-Button direkt am Scan weiterhin der schnellere Weg als ein selbst geschriebenes Abfrage-Skript.
Fazit
Die API ist kein neues Feature, das erst gelernt werden muss — es sind dieselben Daten, die jeder SeoMap-Nutzer ohnehin in der App sieht, nur als reines HTTP statt an das Dashboard gebunden. Für eine Agentur, die Zahlen ins eigene Reporting einspeist, oder einen Entwickler, der Rang-Änderungen in einen bestehenden Automatisierungs-Stack einbindet, ist das der ganze Punkt: SeoMaps Zahlen dorthin bringen, wo sie tatsächlich gebraucht werden, ohne noch einen weiteren Tab prüfen zu müssen.