Was ist eine API?

API steht für Application Programming Interface. Die Dokumentation von MDN beschreibt sie als Satz von Funktionen und Regeln in einem Programm, der es erlaubt, per Software statt über eine Benutzeroberfläche mit ihm zu arbeiten. Sie vergleicht die API außerdem mit einem Vertrag: Wer sie nutzt, weiß, was er anfragen kann, in welchem Format und was er zurückbekommt.

Im Web laufen die meisten APIs über HTTP. Ein Programm schickt eine Anfrage an eine bestimmte Adresse, den sogenannten Endpoint, mit den gewünschten Parametern und erhält eine Antwort, fast immer im Format JSON. Um zu wissen, wer fragt, verlangt die API meist einen Schlüssel oder eine Anmeldung über OAuth, und sie begrenzt, wie viele Anfragen in einem Zeitraum erlaubt sind.

Wichtig ist der Unterschied zwischen der API und dem Werkzeug, das sie nutzt. Die Search Console hat eine Weboberfläche für Menschen und zusätzlich eine API für Programme. Die Daten dahinter sind dieselben, Zugangsregeln, Grenzen und Automatisierungsmöglichkeiten unterscheiden sich aber.

Eine API-Anfrage hat immer drei Teile: was angefragt wird, mit welchen Parametern und wer fragt. In der API der Search Console etwa nimmt die Methode searchanalytics.query einen Datumsbereich entgegen, die Dimensionen, nach denen gruppiert wird (Suchanfrage, Seite, Land, Gerät), und zwei Parameter zum Blättern: rowLimit, das zwischen 1 und 25.000 Zeilen pro Antwort zulässt und standardmäßig bei 1.000 liegt, und startRow, das angibt, ab welcher Zeile die Antwort beginnt.

Passt das Ergebnis nicht in eine Antwort, wird geblättert. Googles Leitfaden zum Abruf der Leistungsdaten empfiehlt, dieselbe Anfrage zu wiederholen und startRow jeweils um 25.000 zu erhöhen, bis eine Antwort ohne Zeilen zurückkommt. Dieses Muster, stückweise abfragen, bis nichts mehr kommt, findet sich bei fast allen APIs, die lange Listen liefern.

APIs legen außerdem Kontingente fest: wie viele Anfragen pro Minute oder pro Tag möglich sind. Wer sie überschreitet, macht nichts kaputt, bekommt aber eine Fehlermeldung, bis das Kontingent wieder frei ist. Deshalb fragen Werkzeuge, die auf einer API beruhen, ihre Daten meist Tag für Tag ab und halten eine eigene Kopie vor.

Fast jede SEO-Arbeit in größerem Maßstab läuft über APIs. Dashboards, die Search Console, Google Analytics und Crawl-Daten zusammenführen, lesen diese Quellen über ihre APIs aus, nicht durch manuelles Kopieren von Tabellen. Dasselbe gilt für die Messung der Sichtbarkeit in KI-Antworten: Unser eigenes Tracking stellt die Fragen an ChatGPT, Claude oder Gemini über APIs, nicht durch Eintippen im Chatfenster.

Deshalb werden die Grenzen einer API zu Grenzen dessen, was man weiß. Wer die API der Search Console aufruft, ohne rowLimit zu ändern, bekommt 1.000 Zeilen, den Standardwert, auch wenn es viel mehr gibt. Und die Art der Frage verändert die Antwort: Mit mehr oder weniger Dimensionen schwanken die Zahl der Zeilen und der Anteil des Traffics, der einer Suchanfrage zugeordnet bleibt. Bevor man Zahlen aus zwei Werkzeugen vergleicht, sollte man wissen, wie jedes gefragt hat.

Diese Website zeigt, wie eine API die Architektur einer Seite verändert. Der Quelltext von zds.es gibt „Astro“ als Generator an, geprüft am 8. Oktober 2026. Dahinter steht unsere eigene Einrichtung: Die Inhalte werden in WordPress bearbeitet, und Astro liest sie über die REST-API von WordPress, um jede Seite zu bauen. Für Leserinnen und Leser ändert das nichts. Für SEO schon: Alles, was bei Google ankommt, stammt aus dem Frontend, und eine Angabe, die das Frontend nicht von der API abruft, existiert auf der veröffentlichten Seite nicht.

• Vor der Nutzung die offizielle Referenz jeder Methode lesen: Parameter, Standardwerte, Grenzen und Antwortformat.
• Blättern, bis eine leere Antwort kommt, und prüfen, ob die Gesamtzahl der Zeilen bei einer runden Zahl stehen bleibt.
• Dieselbe Kennzahl auf zwei Wegen abfragen, etwa mit mehr oder weniger Dimensionen, um Kappungen zu erkennen.
• Schlüssel und Zugangstoken außerhalb des Codes und mit den kleinstmöglichen Rechten aufbewahren.
• Kontingente beachten: Daten in täglichen Paketen abrufen und eine eigene Kopie speichern, statt Anfragen zu wiederholen.
• Festhalten, mit welchen Parametern jeder Datensatz abgerufen wurde, damit jemand anderes die Abfrage wiederholen kann.

• Den Standardwert von rowLimit, 1.000 Zeilen, verwenden und glauben, man habe alle Daten.
• Ein Ergebnis für vollständig halten, weil das Blättern beendet ist, ohne zu prüfen, wo es aufgehört hat.
• Zahlen aus zwei Werkzeugen vergleichen, die dieselbe API mit unterschiedlichen Parametern abfragen.
• API-Schlüssel in Repositories, Screenshots oder Browser-Code veröffentlichen.
• Die Weboberfläche mit der API gleichsetzen: Beide können unterschiedliche Grenzen und Zusammenfassungen anwenden.