Searvia
Hilfe-Center · KI, API und MCP

Die Searvia REST-API nutzen

Lies Rankings, KI-Sichtbarkeit, Website-Gesundheit, Bewertungen und Marktdaten aus deinen eigenen Skripten und Dashboards – mit denselben Schlüsseln und Limits wie bei MCP.

Etwa 4 Minuten

Das brauchst du

  • Ein API-Schlüssel unter Einstellungen › API & MCP
  • Jeder Tarif: Free enthält 100 API- und MCP-Aufrufe pro Monat, Indie 1.000, Starter und höher unbegrenzt
  1. 1

    Schlüssel erstellen

    Konto › API & MCP

    Erstelle einen Schlüssel für das Skript oder den Server, der die API aufruft. Er funktioniert nur in dem Account, in dem du ihn erstellst.

  2. 2

    Als Bearer-Token senden

    Rufe https://searvia.com/api/v1 mit dem Header Authorization: Bearer gefolgt von deinem Schlüssel auf. Starte mit GET /projects, um deine Projekt-IDs zu sehen.

  3. 3

    Endpunkte aus der Referenz auswählen

    Die Entwicklerseite listet alle Endpunkte auf; die OpenAPI-Datei unter /api/v1/openapi.json enthält alle Felder und funktioniert mit Postman, Insomnia und Codegeneratoren.

  4. 4

    Seiten, Limits und Fehler behandeln

    Listen unterstützen page und per_page. Beachte X-RateLimit-Remaining; bei 429 warte auf Retry-After. Fehler kommen immer als error.status, error.code und error.message.

Das bekommst du

Deine Daten fließen in deine eigenen Tools, ohne Kopieren aus dem Panel.

  • Aufrufe, die Credits verbrauchen, laufen ohne Vorschau und liefern 402, wenn das Guthaben zu niedrig ist. Jede mit einem Schlüssel vorgenommene Änderung erscheint mit dem Schlüsselnamen im Audit-Log.
  • Für flache Tageszeilen (ein Keyword pro Tag, eine KI-Antwort, ein Audit) nutze die Report-Endpunkte unter /projects/{id}/reports.

Fehlerbehebung und Fragen

Ist das dasselbe wie MCP?
Ja. Jeder Endpunkt führt dasselbe Tool aus wie der MCP-Server, daher stimmen Ergebnisse, Tariflimits und Credits überein. MCP ist für KI-Assistenten; die REST-API ist für Code.
Kann eine schreibgeschützte Verbindung Daten ändern?
Nein. Apps mit schreibgeschütztem Zugriff erhalten 403 bei Endpunkten, die etwas ändern oder Credits verbrauchen.

Auch per MCP:list_projectsget_keyword_rankings

API-Referenz öffnen