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 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 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.