SE Ranking API FAQ

Q Ich erhalte einen 402-Fehler „Insufficient Funds“, obwohl mein Dashboard verfügbare Credits anzeigt. Was ist der Grund?

A Dieser Fehler wird mit der Meldung Insufficient funds, API key is temporarily disabled zurückgegeben. Das ist das häufigste Problem bei neuen Kunden. In der Regel bedeutet es, dass dein API-Schlüssel noch nicht vollständig mit deinen Credits verknüpft wurde. Das kann direkt nach dem Kauf oder nach einem Planwechsel passieren. Warte einige Minuten und versuche es erneut. Wenn der Fehler länger als 10 Minuten anhält, kontaktiere uns und unser Support-Team hilft dir, das Problem zu lösen.

Q Ich erhalte den Fehler 401 Unauthenticated. Was bedeutet das?

A 401 ist ein Authentifizierungsfehler und kein Problem mit den Credits. Die Anfrage enthielt keinen gültigen API-Schlüssel, deshalb spielt das Guthaben des Kontos dabei keine Rolle. Ein 401 kann also auch bei vollständig aufgeladenem API Wallet auftreten.

Das solltest du prüfen:

• der Schlüssel wird in der Anfrage genau so gesendet, wie er im API-Dashboard angezeigt wird, ohne Abschneiden und ohne zusätzliche Leerzeichen;
• der Schlüssel existiert noch. Ein gelöschter oder neu generierter Schlüssel authentifiziert sofort nicht mehr;
• du verwendest den Schlüsseltyp, den der Endpunkt erwartet (siehe Kann ich denselben API-Schlüssel für Data- und Project-Endpunkte verwenden?).

Wenn der Schlüssel korrekt und aktuell ist und du weiterhin 401 erhältst, kontaktiere uns und nenne den Namen des Schlüssels sowie den Zeitstempel einer fehlgeschlagenen Anfrage.

Q Ich erhalte einen 403-Fehler, obwohl mein API Wallet verfügbare Credits anzeigt. Was bedeutet das?

A 403 bedeutet, dass das Konto derzeit keinen Data-API-Zugang hat. Das ist unabhängig davon, wie viel Guthaben im Wallet liegt. Die Berechtigung für die Data API ergibt sich aus einem aktiven Abonnement oder Add-on. Ein Wallet-Guthaben allein zählt dafür nicht. Ein Konto kann also Credits haben und trotzdem abgewiesen werden.

Das solltest du prüfen:

• ob der Plan oder das Add-on, das den Data-API-Zugang gewährt, noch aktiv ist und nicht abgelaufen oder herabgestuft wurde;
• ob du die Aufrufe aus einem Unterkonto oder einem Kundenkonto einer Agentur sendest und nicht aus dem Hauptkonto, das die Berechtigung hält;
• das API-Dashboard, das den Data-API-Zugang und das Wallet-Guthaben als zwei getrennte Angaben ausweist.

Wenn das Add-on aktiv erscheint und du weiterhin 403 erhältst, kontaktiere uns und wir prüfen die Berechtigung des Kontos.

Q Kann ich denselben API-Schlüssel für Data- und Project-Endpunkte verwenden?

A Ja. Ein API-Schlüssel authentifiziert Anfragen an Data- und Project-Endpunkte. Beide Endpunkttypen werden über api.seranking.com über das Data-API-Gateway bereitgestellt, sodass du keinen separaten Project-API-Schlüssel benötigst.

Q Beim Testen habe ich ein Rate-Limit erreicht. Wo finde ich die für meinen Plan geltenden Limits?

A Rate-Limits variieren je nach Plan und können beim Testen größerer Abfragemengen schnell erreicht werden. Die Limits deines Plans sind in der Dokumentation aufgeführt. Wir empfehlen, sie vor umfangreichen Abfragen zu prüfen, damit du deine Anfragen entsprechend steuern kannst.

Q Wie erfahre ich, wie viele Credits ein API-Aufruf kostet?

A Die Credit-Kosten variieren je nach Endpunkt. Bevor du größere Abfragen ausführst, prüfe die Preise pro Endpunkt in der Dokumentation, um deinen Verbrauch vorab zu schätzen. Deinen aktuellen Credit-Stand kannst du jederzeit im API-Dashboard einsehen.

Q Ich sehe die Meldung „Dein Plan enthält keine API-Credits. Upgrade deinen Plan oder lade dein Guthaben auf, um zu starten.“ Was bedeutet das?

A Das bedeutet, dass dein aktuelles Abonnement oder Guthaben noch keine Data-API-Credits enthält. Um mit API-Aufrufen zu beginnen, führe ein Upgrade auf einen Plan mit Data-API-Credits durch oder lade dein Kontoguthaben auf und erstelle bzw. behalte anschließend deinen API-Schlüssel. Wenn du glaubst, dass bereits Credits verfügbar sein sollten, kontaktiere uns.

Q Wie kann ich meinen API-Credit-Verbrauch verfolgen und die Kosten für jede Anfrage sehen?

A Deinen aktuellen Credit-Stand kannst du jederzeit im API-Dashboard einsehen, und die Credit-Kosten pro Endpunkt sind in der Dokumentation aufgeführt, sodass du den Verbrauch vor umfangreichen Abfragen abschätzen kannst.

Q Ich habe Guthaben gekauft, aber die Data API zeigt weiterhin „No API access“ an. Warum?

A Ein SE Ranking Kontoguthaben finanziert die nutzungsbasierten Tools von SE Ranking (etwa den Keyword-Grouper und den Suchvolumen-Checker). Es reaktiviert keinen Data-API-Zugang auf einem Konto, dessen Testphase abgelaufen ist. Die Data API erfordert einen aktiven kostenpflichtigen Plan mit API-Credits oder dedizierte nutzungsbasierte API-Credits. Wenn deine Testphase beendet ist, stellt das Aufladen von Guthaben allein den Data-API-Zugang nicht wieder her. Führe ein Upgrade auf einen Plan mit Data-API-Credits durch oder kaufe dedizierte nutzungsbasierte API-Credits. Wenn du glaubst, dass der API-Zugang bereits aktiv sein sollte, kontaktiere uns.

Q Wie funktionieren die Credits im API Wallet (nutzungsbasiert) und in welcher Reihenfolge werden meine Credits verbraucht?

A Das API Wallet enthält dedizierte nutzungsbasierte Data-API-Credits und ist von deinem allgemeinen SE Ranking Kontoguthaben getrennt (das die nutzungsbasierten Tools wie den Keyword-Grouper und den Suchvolumen-Checker finanziert). Anders als dieses allgemeine Guthaben gewähren die Credits im API Wallet tatsächlich Data-API-Zugang. Bereits die erste Aufladung des API Wallet kann die Data API aktivieren, selbst wenn dein Plan oder deine Testphase abgelaufen ist.

Wo du es findest: Dein API-Wallet-Guthaben erscheint auf der Hauptkarte des API-Dashboards sowie in einem eigenen Bereich Wallet, in dem du aufladen, eine automatische Aufladung einrichten, Benachrichtigungen bei niedrigem Guthaben aktivieren und deinen Transaktionsverlauf einsehen kannst. Die automatische Aufladung und die Benachrichtigungen bei niedrigem Guthaben werden auf der Wallet-Seite als „Coming soon“ angezeigt und lassen sich noch nicht einrichten.

Reihenfolge des Verbrauchs: Zuerst werden die in deinem Plan und in etwaigen Add-on-Paketen enthaltenen API-Credits verbraucht. Dein API-Wallet-Guthaben wird erst dann herangezogen, wenn diese enthaltenen Credits aufgebraucht sind.

Gerade aufgeladen, aber noch kein Zugang? Credits werden nach einem Kauf im Hintergrund verarbeitet, und dein Guthaben aktualisiert sich nach kurzer Zeit. Der Zugang erscheint daher möglicherweise nicht sofort. Warte einen Moment und aktualisiere das API-Dashboard. Wenn ein gekauftes Guthaben weiterhin nicht angezeigt wird, kontaktiere uns.

Q Verfallen die Credits im API Wallet oder werden sie monatlich zurückgesetzt?

A Nein. Credits im API Wallet werden als einmalige nutzungsbasierte Aufladung gekauft. Sie verfallen nicht und werden zu Beginn eines Abrechnungszeitraums nicht zurückgesetzt. Ein nicht genutztes Wallet-Guthaben bleibt erhalten, bis du es ausgibst.

Bei den in einem Plan oder Add-on-Paket enthaltenen API-Credits ist es umgekehrt: Sie werden mit deinem Abrechnungszyklus erneuert und nicht übertragen. Da Plan- und Add-on-Credits zuerst verbraucht werden, wird dein Wallet-Guthaben in der Regel erst dann angetastet, wenn das erneuerbare Kontingent des Zeitraums aufgebraucht ist.

Q Welche Pläne und Kontotypen können das API Wallet aufladen?

A Für den Kauf von API-Wallet-Credits gibt es keine Einschränkung auf Planebene. Konten mit Core und Growth können das API Wallet aufladen, ebenso andere kostenpflichtige Pläne. Geprüft wird das Konto, nicht der Planname.

Das Aufladen ist in diesen Fällen nicht möglich:

• du bist in einem Unterkonto angemeldet, denn der Kauf muss über das Hauptkonto erfolgen;
• das Konto ist ein Kundenkonto, das in einem Agentur-Workspace erstellt wurde;
• dem Konto ist kein Abonnement zugeordnet;
• die Credits könnten nirgendwo gutgeschrieben werden, zum Beispiel bei einem aktiven Plan, der überhaupt kein Data-API-Kontingent enthält.

Wenn du davon ausgehst, dass du aufladen kannst, die Option aber nicht verfügbar ist, kontaktiere uns und wir prüfen dein Konto.

Q Warum erscheinen meine API-Wallet-Credits nicht in der Antwort von /account/subscription?

A Das ist so vorgesehen. Der Endpunkt /account/subscription gibt ausschließlich den Status deines Abonnements zurück: Guthaben, Typ und ob es abgelaufen ist. API-Wallet-Credits sind darin nicht enthalten, eine Aufladung des API Wallet ändert also nichts an der Antwort dieses Endpunkts. Prüfe dein API-Wallet-Guthaben stattdessen im API-Dashboard. Wenn du Wallet-Credits gekauft hast und sie auch dort nicht sichtbar sind, kontaktiere uns.

Q Kann ich einen API-Schlüssel löschen, neu generieren oder einschränken?

A Deine Schlüssel verwaltest du im API-Dashboard in der Tabelle der API-Schlüssel.

• Löschen: Einen Data-API-Schlüssel kannst du in der Schlüsseltabelle löschen. Deinen letzten verbliebenen Data-API-Schlüssel kannst du nicht löschen. Erstelle zuerst einen Ersatzschlüssel und entferne danach den alten.
• Neu generieren: Den Project-API-Schlüssel kannst du neu generieren. Dabei wird ein neuer Wert ausgegeben und der alte ungültig. Aktualisiere direkt danach alle Integrationen, die ihn verwenden.
• Einschränken: API-Schlüssel lassen sich derzeit nicht eingrenzen oder einschränken. Es gibt keine Einstellung für IP-Freigabelisten, Endpunkt-Bereiche oder Berechtigungen pro Schlüssel. Ein Schlüssel wird nur mit einem Typ und einem Namen erstellt. Wenn ein Schlüssel möglicherweise offengelegt wurde, lösche ihn oder generiere ihn neu, statt zu versuchen, ihn einzuschränken.

Wenn ein Schlüssel dringend widerrufen werden muss, kontaktiere uns.