REST-API · v1 · Live-Doku

SEO-API für Ihren eigenen Stack

Ihre SEO- und KI-Sichtbarkeitsdaten über einen sauberen REST-Endpunkt.

Holen Sie Google-Search-Console-, Ranking- und AI-Tracker-Daten direkt in Ihr Produkt, Dashboard oder Data Warehouse. Authentifizieren Sie sich mit einem Bearer-Schlüssel aus Ihrem Dashboard, rufen Sie die REST `/v1` auf und erhalten Sie typisiertes JSON zurück — dieselbe kanonische Datenschicht, die auch das MCP von SEOcrawl AI antreibt. GA4, vollständiger Site-Audit-Export und Multi-Tenant-Partner-OAuth folgen als Nächstes.

API-Schlüssel holenDas MCP erkunden

Bearer-Auth · 60 Req/Min · Dieselbe Datenschicht wie das MCP · Kein Scraping

seocrawl — REST /v1

$ curl "https://api.seocrawl.ai/v1/properties/$ID/gsc/summary?range=last_28_days" \

-H "Authorization: Bearer sca_live_…"

{ "data": {

"period": { "from": "2026-06-09", "to": "2026-07-06" },

"metrics": {

"clicks": 2388, "impressions": 811019,

"ctr": 0.00294, "position": 22.87

},

"metrics_diff": { "clicks": 584, … }

} }

Einmal authentifizieren. REST aufrufen.

Erstellen Sie ein Bearer-Token in Ihrem Dashboard und übergeben Sie es im Authorization-Header. Derselbe Schlüssel funktioniert sowohl bei der REST-API als auch beim MCP-Server.

Basis-URL

https://api.seocrawl.ai/v1

Authorization-Header

Authorization: Bearer sca_live_your_token_here
API-Schlüssel holenRead the API docs
cURLJavaScriptPython
# cURL — resolve a property id, then query it
curl https://api.seocrawl.ai/v1/properties \
  -H "Authorization: Bearer sca_live_…"

curl "https://api.seocrawl.ai/v1/properties/$ID/gsc/summary?range=last_28_days" \
  -H "Authorization: Bearer sca_live_…"

// JavaScript
const res = await fetch(
  "https://api.seocrawl.ai/v1/properties/" + id + "/gsc/summary?range=last_28_days",
  { headers: { Authorization: "Bearer sca_live_…" } }
);
const data = await res.json();

# Python
import requests
r = requests.get(
  f"https://api.seocrawl.ai/v1/properties/{id}/gsc/summary",
  params={"range": "last_28_days"},
  headers={"Authorization": "Bearer sca_live_…"},
)
print(r.json())
Endpunkte

Eine Datenschicht, zwei Oberflächen

Jeder REST-Endpunkt liest aus derselben kanonischen Schicht wie die MCP-Tools — sodass Ihr Dashboard und Ihre KI-Agenten stets identische Zahlen sehen. Diese Gruppen sind in v1 live; weitere Abdeckung kommt laufend hinzu.

Properties

Listen Sie die Search-Console-Properties auf, auf die Sie zugreifen können. Verwenden Sie die `id` jeder Property im Pfad jedes Datenendpunkts.

  • GET/v1/propertiesLive

Google Search Console

Klicks, Impressionen, CTR und durchschnittliche Position — nach Suchanfrage, Seite, Zeitraum und Periode zu Periode.

  • GET/v1/properties/{id}/gsc/summaryLive
  • GET/v1/properties/{id}/gsc/compareLive
  • GET/v1/properties/{id}/gsc/top-keywordsLive
  • GET/v1/properties/{id}/gsc/top-pagesLive
  • GET/v1/properties/{id}/gsc/keywords/detailLive
  • GET/v1/properties/{id}/gsc/pages/detailLive

AI Tracker

Lesen Sie die Prompts aus, die Sie auf Markennennungen in ChatGPT, Claude, Gemini und Perplexity überwachen.

  • GET/v1/properties/{id}/ai-tracker/promptsLive

Aufgaben

Lesen und schreiben Sie SEO-Aufgaben — verbinden Sie Ihr Aufgabenboard mit Ihrem eigenen Projektmanagement-Stack.

  • GET/v1/properties/{id}/tasksLive
  • POST/v1/properties/{id}/tasksLive
  • GET/v1/properties/{id}/tasks/{ticketId}Live
  • PATCH/v1/properties/{id}/tasks/{ticketId}Live
  • POST/v1/properties/{id}/tasks/{ticketId}/commentsLive

GA4 & Indexierung

Traffic, KI-Referrer und Indexierungsstatus. Die Schnittstelle ist bereit; die REST-Endpunkte kommen nach und nach.

  • GET/v1/properties/{id}/ga4/summaryBald
  • GET/v1/properties/{id}/indexation/summaryBald

Site Audit

Crawl-Gesundheit, OnPage, Technik und Problemlisten — der vollständige Audit-Datensatz, per REST bereitgestellt.

  • GET/v1/properties/{id}/audit/summaryBald
  • GET/v1/properties/{id}/audit/issuesBald
Warum diese API

Für Produkte gebaut, nicht für Scraper

Eine echte REST-API mit Bearer-Auth, Scopes und Rate-Limits — die eine kanonische Datenschicht mit dem MCP teilt, sodass die Zahlen nie voneinander abweichen.

Saubere REST, typisiertes JSON

Vorhersehbare Ressourcen, Standard-Verben, typisierte JSON-Antworten und RFC-konforme Fehler (401 nicht authentifiziert, 403 scope_required, 429 mit Retry-After). Kein HTML-Scraping, keine brüchigen Exporte.

Eine kanonische Datenschicht

REST-Endpunkte und MCP-Tools sind Geschwister über denselben Providern, mit in CI getesteter Parität. Ihr Dashboard und Ihre KI-Agenten sehen stets identische Klicks, Impressionen und Positionen.

Self-Service-Schlüssel

Erstellen und widerrufen Sie Bearer-Token in Sekunden aus Ihrem Dashboard. Derselbe sca_live_-Schlüssel authentifiziert sowohl die REST-API als auch den MCP-Server — eine Anmeldung, zwei Oberflächen.

Dokumentierte Rate-Limits

60 Anfragen pro Minute und 1.000 pro Stunde je Token, mit klaren 429- + Retry-After-Antworten. REST-Limits sind ein separater Pool getrennt von der MCP-Nutzung — eines hungert das andere nie aus.

Zugriff nach Scopes

Grobe Lese- und Schreib-Scopes schützen jeden Endpunkt, durchgesetzt an der Firewall mit Standard-Step-up-Antworten. Geben Sie einem Schlüssel nur, was er braucht.

Multi-Tenant, in Kürze

Ein Google-OAuth-Flow pro Tenant, damit Partner jede der GSC-Properties ihrer Kunden unter einem Konto verbinden können — mit strikter Datentrennung. In aktiver Entwicklung; fragen Sie uns nach frühem Zugang.

In 3 Schritten starten

Von null bis zu Ihrem ersten authentifizierten Aufruf in wenigen Minuten.

1

Schlüssel erstellen

Öffnen Sie die API-Tokens in Ihrem Dashboard und generieren Sie ein Bearer-Token. Kopieren Sie es einmalig — es beginnt mit `sca_live_`.

2

Header senden

Übergeben Sie `Authorization: Bearer sca_live_…` bei jeder Anfrage an `https://api.seocrawl.ai/v1`. Derselbe Schlüssel funktioniert auch mit dem MCP-Server.

3

Daten abrufen

Rufen Sie `GET /v1/properties` auf, um eine Property-`id` zu erhalten, und greifen Sie dann über `/v1/properties/{id}/…` auf GSC-Performance, AI-Tracker-Prompts oder Aufgaben zu — und leiten Sie das JSON direkt in Ihr Produkt, Dashboard oder Warehouse.

Drei Wege zu Ihren Daten

Dieselben Zahlen, andere Oberfläche — wählen Sie die, die zu Ihrer Arbeitsweise passt.

REST-API

Für Produkte, Dashboards und Datenpipelines. Bearer-Auth, typisiertes JSON, Rate-Limits. Sie befinden sich auf dieser Seite.

MCP-Server

Für KI-Agenten — Claude, ChatGPT und jeder MCP-Client fragen Ihre Daten in natürlicher Sprache ab.

Das MCP erkunden

Terminal & CLI

Für Skripte und CI/CD — steuern Sie Ihre Daten von jedem MCP-fähigen Terminal-Agenten aus.

Die CLI ansehen
Alle Integrationen vergleichen

Wer auf der API baut

Teams, die SEO- und KI-Sichtbarkeitsdaten in ihren eigenen Systemen wollen.

SaaS & Partner

Betten Sie Live-SEO-Metriken in die Oberfläche Ihres eigenen Produkts ein. Geben Sie Ihren Nutzern Search-Console- und KI-Sichtbarkeitsdaten, ohne die Pipelines selbst zu bauen.

Agenturen

Leiten Sie die Daten jedes Kunden in ein eigenes Portal, Looker Studio oder Ihre Reporting-Schicht — ein Schlüssel, jede Property, keine manuellen Exporte.

Datenteams

Bringen Sie GSC-, Ranking- und AI-Tracker-Daten planmäßig in Ihr Warehouse. Verknüpfen Sie sie mit Umsätzen und bauen Sie die Modelle, die Ihre Dashboards brauchen.

Entwickler

Automatisieren Sie Prüfungen und Warnungen, synchronisieren Sie Aufgaben mit Ihrem PM-Tool und integrieren Sie KI-Sichtbarkeitsüberwachung in die Apps, die Sie bereits ausliefern.

Häufig gestellte Fragen

Gibt es wirklich eine öffentliche SEO-API?

Ja — eine Bearer-authentifizierte REST-`/v1`-API ist live und deckt Search-Console-Performance, Properties, AI-Tracker-Prompts und Aufgaben ab, mit der vollständigen öffentlichen Referenz unter api.seocrawl.ai/docs. Breitere Abdeckung (GA4, vollständiger Site-Audit-Export) und Multi-Tenant-Partner-OAuth folgen als Nächstes. Sie brauchen etwas, das noch nicht live ist? Fragen Sie uns nach frühem Zugang.

Wie authentifiziere ich mich?

Mit einem Bearer-Token. Erstellen Sie einen `sca_live_`-Schlüssel in Ihrem Dashboard und senden Sie ihn als `Authorization: Bearer <key>` bei jeder Anfrage. Für Ihr eigenes Konto gibt es keinen OAuth-Ablauf — nur den Header.

Ist es derselbe Schlüssel wie beim MCP?

Ja. Dasselbe Token authentifiziert sowohl die REST-API als auch den MCP-Server, weil beide aus einer kanonischen Datenschicht lesen. Eine Anmeldung, zwei Oberflächen — und identische Zahlen über beide hinweg.

Wie lauten die Rate-Limits?

60 Anfragen pro Minute und 1.000 pro Stunde je Token. Überschreiten Sie sie, erhalten Sie einen `429` mit einem `Retry-After`-Header. REST-Limits werden getrennt von der MCP-Nutzung erfasst, sodass die beiden nie um dasselbe Budget konkurrieren.

Kann ich die Search-Console-Properties meiner Kunden verbinden?

Dieser Multi-Tenant-Partner-Flow — ein Google-OAuth pro Tenant, damit Sie jede der GSC-Properties Ihrer Kunden unter Ihrem eigenen Konto verbinden können, mit strikter Datentrennung — befindet sich in aktiver Entwicklung. Wenn Sie eine Partnerintegration bauen, melden Sie sich für frühen Zugang.

Welche Daten kann ich heute abrufen?

Search-Console-Zusammenfassung und Periodenvergleiche, Top-Keywords und -Seiten, Detail zu einem einzelnen Keyword/einer Seite, Ihre Liste der Properties, AI-Tracker-Prompts und vollen Lese-/Schreibzugriff auf Aufgaben. Es spiegelt, was das MCP bereitstellt, per REST.

Bereit, auf Ihren SEO-Daten aufzubauen?

Erstellen Sie einen Bearer-Schlüssel in Ihrem Dashboard und machen Sie in Minuten Ihren ersten REST-Aufruf — oder sprechen Sie mit uns über Partner- und Multi-Tenant-Zugang.

API-Schlüssel holenDemo buchen