Bauen Sie auf Ihren Searvia-Daten auf
Lesen Sie Rankings, KI-Sichtbarkeit, Website-Zustand, Bewertungen, Store-Einträge und Marktschätzungen aus Ihren eigenen Skripten, Dashboards und Apps. Die API nutzt dieselben Tools wie der Searvia MCP-Server, daher gelten dieselben Tarifgrenzen, Credits und Kontobereiche.
curl https://searvia.com/api/v1/projects \
-H "Authorization: Bearer $SEARVIA_API_KEY"Authentifizierung
Erstellen Sie unter Einstellungen › API & MCP einen Schlüssel und senden Sie ihn als Bearer-Token. Ein Schlüssel gehört zu einem Konto und sieht nur dessen Daten. Derselbe Schlüssel funktioniert für den MCP-Server; per OAuth verbundene Apps können die API ebenfalls nutzen, und schreibgeschützte Verbindungen können nichts ändern.
Limits und Credits
Pro Schlüssel, pro Minute
60 Lesezugriffe, 30 Änderungen und 10 Aufrufe, die Credits verbrauchen oder löschen.
Pro Monat
API- und MCP-Aufrufe teilen sich ein Monatslimit: 100 im Free-Tarif, 1.000 im Indie-Tarif, unbegrenzt ab Starter.
Credits
Aufrufe mit „Verbraucht Credits“ ziehen diese sofort und ohne Vorschau vom Kontostand ab. Bei zu wenigen Credits gibt der Aufruf 402 zurück und es wird nichts ausgeführt.
Jede Antwort enthält X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset. Bei Erreichen eines Limits erhalten Sie 429 mit Retry-After.
Antworten, Fehler und Seiten
{
"data": [ ... ],
"meta": { "page": 1, "per_page": 50, "total": 120, "last_page": 3 }
}{
"error": {
"status": 422,
"code": "validation_failed",
"message": "Missing required field: keywords.",
"errors": { "keywords": ["The keywords field is required."] }
}
}Listen akzeptieren page und per_page (bis zu 200) und senden einen Link-Header mit der nächsten und vorherigen Seite. Fehlercodes: unauthenticated, payment_required, forbidden, not_found, validation_failed, rate_limited, unavailable und server_error.
Endpunkte
Account
| GET | /account/usage | Plan, credits, quotas and this month's API and MCP calls. | Lesen |
| GET | /audit-logs | Audit log of the account (owners and admins). | Lesen |
Projects
| GET | /projects | Projects (websites and apps) of the account. | Lesen |
| GET | /projects/{project_id} | Overview of one project: rankings, visibility, reviews and open growth actions. | Lesen |
| GET | /projects/{project_id}/competitors | Tracked competitors of a project. | Lesen |
Rankings
| GET | /projects/{project_id}/keywords | Tracked keywords with current rank, 1 and 7 day change, popularity, difficulty and daily history. | Lesen |
| POST | /projects/{project_id}/keywords | Track keywords (within the plan quota; the first check runs right away). | Ändern |
| DELETE | /projects/{project_id}/keywords | Stop tracking keywords (by text or id). | Löscht |
| POST | /projects/{project_id}/rankings/refresh | Check rankings now. | Ändern |
| GET | /keywords/{keyword_id}/history | Daily rank history of one keyword with competitor ranks. | Lesen |
Domains
| GET | /domain-analyses | Domain analyses of the account. | Lesen |
| POST | /domain-analyses | Analyze a domain (uses credits): traffic, keywords, top pages, page types, competitors and backlinks. | Verbraucht Credits |
| GET | /domain-analyses/{analysis_id} | One domain analysis. | Lesen |
Site health
| GET | /projects/{project_id}/site-health | Latest site audit, AI discoverability, security scan and page speed of a website project. | Lesen |
| POST | /projects/{project_id}/site-audits | Start a site audit (at most once an hour). | Ändern |
| GET | /site-audits/{audit_id} | Issues and pages of one site audit. | Lesen |
| GET | /projects/{project_id}/backlinks | Backlink summary with new and lost links. | Lesen |
AI visibility
| GET | /projects/{project_id}/ai-visibility | AI visibility summary, questions and latest answers of a project. | Lesen |
| POST | /projects/{project_id}/ai-visibility/questions | Track AI questions (one per line in `prompts`). | Ändern |
| GET | /ai-visibility/questions/{prompt_id} | Timeline and answers of one AI question. | Lesen |
Apps
| GET | /projects/{project_id}/reviews | Store reviews of an app project. | Lesen |
| GET | /projects/{project_id}/metadata | Store listing of an app project per language (including the App Store keyword field when connected). | Lesen |
Market
| GET | /market/apps/{app_id} | Estimated revenue, downloads and chart history of any App Store app. | Lesen |
| GET | /market/top-earning | Top earning or fastest growing apps by country and category. | Lesen |
| GET | /market/new-winners | Recently released apps that already earn. | Lesen |
Reports
| GET | /projects/{project_id}/reports/rankings | One row per keyword and day: rank, checked depth and competitor ranks. | Lesen |
| GET | /projects/{project_id}/reports/ai-visibility | One row per AI answer: question, platform, mentioned, cited, source position and sentiment. | Lesen |
| GET | /projects/{project_id}/reports/site-health | One row per site audit: health score, AI discoverability score, errors, warnings and pages. | Lesen |
Pfad-, Query- und Body-Felder aller Endpunkte stehen in der OpenAPI-Datei; importieren Sie sie in Postman, Insomnia oder einen Code-Generator.
Dashboards und Datensätze
Looker-Studio-Connector
Tägliche Rankings, KI-Sichtbarkeitsantworten und Website-Zustandswerte als Looker-Studio-Datenquellen, basierend auf den Report-Endpunkten. Jede Zeile ist ein Keyword und Tag, eine KI-Antwort oder ein Audit.
Connector einrichtenAudit-Log
Jede Änderung und jeder Credit-Verbrauch mit einem Schlüssel wird mit Schlüsselname, Ziel, IP und Ergebnis protokolliert, neben Änderungen aus der Oberfläche und über MCP. Inhaber und Admins sehen das Protokoll unter Einstellungen › Sicherheit oder unter /audit-logs.
Über das Audit-Log