API Reference - rankion.ai

Authentifizierung

Alle API-Anfragen benötigen einen Bearer Token. Erstelle deinen Token unter Einstellungen → API Tokens im Dashboard.

# Jeden Request mit Bearer Token authentifizieren curl -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ https://rankion.ai/api/v1/team

Hinweis: Sende bei allen Requests Accept: application/json und bei POST/PUT-Requests zusätzlich Content-Type: application/json.

Fehler & Statuscodes

Code	Bedeutung
`200`	Erfolg
`201`	Ressource erstellt
`202`	Akzeptiert – Hintergrundverarbeitung gestartet
`204`	Gelöscht (kein Content)
`401`	Nicht authentifiziert – ungültiger Token
`402`	Nicht genügend Credits
`403`	Keine Berechtigung für diese Ressource
`404`	Ressource nicht gefunden
`422`	Validierungsfehler – prüfe die Parameter
`429`	Rate Limit erreicht
`500`	Serverfehler

Credit-System

Einige Endpoints verbrauchen Credits. Der Verbrauch wird vor der Ausführung geprüft. Bei unzureichendem Guthaben erhältst du einen 402-Fehler.

Endpoint	Credits
AI Scanner – Erkennung	2 Credits
AI Scanner – Humanisierung	5 Credits
Keyword-Recherche	5 Credits
Bild-Generierung	5 Credits
Content Audit	10 Credits
Artikel-Generierung	15 Credits
Bulk Generation	15 Credits
Wettbewerber-Analyse	20 Credits

Team

Informationen über dein aktuelles Team abrufen.

GET /v1/team

Gibt Team-Info mit Plan, Credits und Statistiken zurück.

// Response 200 { "id": 1, "name": "Mein Team", "plan": "professional", "credit_balance": 5000, "members_count": 3, "projects_count": 5, "articles_count": 120 }

Projects

Projekte verwalten. Jedes Projekt hat eine eigene Domain, Sprache und Brand Voice.

GET /v1/projects

Alle Projekte des Teams mit Brand Voice auflisten.

GET /v1/projects/{project}

Einzelnes Projekt mit Brand Voice und den letzten 10 Artikeln.

POST /v1/projects

Neues Projekt erstellen.

Parameter	Typ	Info
`name`	string	Pflicht Projektname
`domain`	string	Optional URL der Website
`language`	string	Optional de, en, es, fr (Standard: de)
`description`	string	Optional Projektbeschreibung

# Beispiel curl -X POST https://rankion.ai/api/v1/projects \ -H "Authorization: Bearer TOKEN" \ -H "Content-Type: application/json" \ -d '{"name":"Mein Blog","domain":"https://blog.example.com","language":"de"}'

PUT /v1/projects/{project}

Projekt aktualisieren. Gleiche Parameter wie POST (alle optional).

DEL /v1/projects/{project}

Projekt und alle zugehörigen Daten löschen. Nicht umkehrbar.

Articles

Artikel verwalten, bewerten, optimieren und auf Freshness prüfen.

GET /v1/projects/{project}/articles

Paginierte Artikelliste eines Projekts (20 pro Seite).

GET /v1/articles/{article}

Einzelnen Artikel mit allen Details abrufen (Content, Scores, Metadaten).

POST /v1/projects/{project}/articles

Neuen Artikel manuell erstellen (nicht generiert).

Parameter	Typ	Info
`title`	string	Pflicht
`content`	string	Pflicht HTML-Content
`target_keyword`	string	Optional
`language`	string	Optional de, en, es, fr
`status`	string	Optional draft, published

PUT /v1/articles/{article}

Artikel aktualisieren (title, content, status, meta_title, meta_description, target_keyword).

DEL /v1/articles/{article}

Artikel löschen.

POST /v1/articles/{article}/score

SEO-Scoring als Hintergrundprozess starten. Gibt 202 Accepted zurück.

POST /v1/articles/{article}/optimize

Content-Optimierung anhand einer URL starten.

Parameter	Typ	Info
`url`	string	Pflicht URL des bestehenden Artikels

GET /v1/articles/{article}/freshness

Content-Freshness prüfen: Alter, Score, Status (fresh/aging/stale/critical).

GET /v1/articles/{article}/link-suggestions

Interne Verlinkungsvorschläge für einen Artikel abrufen.

Keywords

Keywords verwalten und KI-basierte Keyword-Recherche durchführen.

GET /v1/projects/{project}/keywords

Paginierte Keyword-Liste eines Projekts.

POST /v1/projects/{project}/keywords

Keyword hinzufügen.

Parameter	Typ	Info
`keyword`	string	Pflicht min. 2 Zeichen
`search_volume`	integer	Optional
`difficulty`	integer	Optional 0-100
`language`	string	Optional de, en, es, fr

DEL /v1/keywords/{keyword}

Keyword löschen.

POST /v1/keywords/research 5 Credits

KI-basierte Keyword-Recherche mit Suchvolumen und Schwierigkeit.

Parameter	Typ	Info
`keyword`	string	Pflicht min. 2 Zeichen
`language`	string	Optional de, en, es, fr
`country`	string	Optional Ländercode (Standard: de)

# Beispiel curl -X POST https://rankion.ai/api/v1/keywords/research \ -H "Authorization: Bearer TOKEN" \ -H "Content-Type: application/json" \ -d '{"keyword":"seo optimierung","language":"de"}'

Images

Generierte Bilder verwalten.

GET /v1/projects/{project}/images

Alle Bilder eines Projekts auflisten.

GET /v1/images/{image}

Einzelnes Bild mit Metadaten abrufen.

DEL /v1/images/{image}

Bild löschen.

Style Profiles

Schreibstil-Profile für konsistenten Content erstellen und verwalten.

GET /v1/projects/{project}/style-profiles

Alle Style Profiles eines Projekts.

POST /v1/projects/{project}/style-profiles

Style Profile erstellen.

Parameter	Typ	Info
`name`	string	Pflicht
`tone`	string	Optional z.B. professionell, locker, akademisch
`writing_style`	string	Optional
`vocabulary_level`	string	Optional
`sentence_structure`	string	Optional
`rules`	object	Optional Benutzerdefinierte Regeln

PUT /v1/style-profiles/{styleProfile}

Style Profile aktualisieren.

DEL /v1/style-profiles/{styleProfile}

Style Profile löschen.

Knowledge Base

Wissensdokumente hochladen, die bei der Content-Generierung als Kontext verwendet werden.

GET /v1/projects/{project}/knowledge-base

Alle Dokumente der Knowledge Base auflisten.

POST /v1/projects/{project}/knowledge-base

Neues Wissensdokument erstellen.

Parameter	Typ	Info
`title`	string	Pflicht
`content`	string	Pflicht Textinhalt
`type`	string	Optional text, url, pdf

DEL /v1/knowledge-base/{knowledgeDocument}

Wissensdokument löschen.

Link Lists

Link-Listen für interne und externe Verlinkung in generierten Artikeln.

GET /v1/projects/{project}/link-lists

Alle Link-Listen eines Projekts.

POST /v1/projects/{project}/link-lists

Link-Liste erstellen.

Parameter	Typ	Info
`name`	string	Pflicht
`links`	array	Pflicht Array mit {url, anchor_text, description}

DEL /v1/link-lists/{linkList}

Link-Liste löschen.

Goals

Content-Ziele definieren, die bei der Generierung berücksichtigt werden.

GET /v1/goals

Alle Goals (System + eigene) auflisten.

POST /v1/goals

Eigenes Goal erstellen.

Parameter	Typ	Info
`name`	string	Pflicht
`description`	string	Optional
`prompt_instructions`	string	Optional KI-Anweisungen
`metrics`	object	Optional Metriken

DEL /v1/goals/{goal}

Eigenes Goal löschen (System-Goals sind geschützt).

Redaktionskalender

Redaktionskalender für Content-Planung verwalten.

GET /v1/projects/{project}/calendar

Kalendereinträge auflisten. Optional mit ?from=2026-01-01&to=2026-03-31 filtern.

POST /v1/projects/{project}/calendar

Kalendereintrag erstellen.

Parameter	Typ	Info
`title`	string	Pflicht
`planned_date`	date	Pflicht YYYY-MM-DD
`status`	string	Optional planned, in_progress, published
`notes`	string	Optional

PUT /v1/calendar/{entry}

Kalendereintrag aktualisieren.

DEL /v1/calendar/{entry}

Kalendereintrag löschen.

AI Scanner

KI-generierte Texte erkennen und humanisieren.

POST /v1/ai-scanner/detect 2 Credits

Text auf KI-Generierung analysieren.

Parameter	Typ	Info
`text`	string	Pflicht min. 50 Zeichen
`scan_type`	string	Optional quick, deep (Standard: quick)

// Response 200 { "score": 85, "scan_type": "quick", "word_count": 250, "details": { ... } }

POST /v1/ai-scanner/humanize 5 Credits

Artikel humanisieren (Hintergrundprozess, 202 Accepted).

Parameter	Typ	Info
`article_id`	integer	Pflicht
`level`	string	Optional light, medium, aggressive

Content Audit

Website-Content automatisch analysieren und bewerten.

GET /v1/content-audits

Alle Content Audits des Teams auflisten.

POST /v1/content-audits 10 Credits

Neuen Content Audit starten (Hintergrundprozess).

Parameter	Typ	Info
`source_url`	string	Pflicht URL der zu analysierenden Website
`type`	string	Optional full, quick

GET /v1/content-audits/{audit}

Einzelnen Audit mit allen analysierten Seiten abrufen.

Wettbewerber-Analyse

Wettbewerber analysieren und Content-Gaps identifizieren.

GET /v1/competitor-analyses

Alle Wettbewerber-Analysen auflisten.

POST /v1/competitor-analyses 20 Credits

Neue Wettbewerber-Analyse starten.

Parameter	Typ	Info
`project_id`	integer	Pflicht
`domain`	string	Pflicht Domain ohne Protokoll
`language`	string	Optional de, en, es, fr
`competitor_limit`	integer	Optional max. Anzahl Wettbewerber

GET /v1/competitor-analyses/{analysis}

Analyse-Ergebnis mit Wettbewerbern und Content-Gaps abrufen.

AI Visibility Tracking

Sichtbarkeit deiner Domain in AI-Suchmaschinen (ChatGPT, Perplexity, Gemini) überwachen.

GET /v1/tracking-projects

Alle Tracking-Projekte mit Scores auflisten.

GET /v1/tracking-projects/{trackingProject}

Einzelnes Tracking-Projekt mit Visibility-Verlauf und Keyword-Details.

POST /v1/tracking-projects/{trackingProject}/run

Manuellen Tracking-Lauf starten (Hintergrundprozess).

Content-Generierung

Artikel und Bilder per KI generieren.

POST /v1/generate/article 15 Credits

KI-Artikel generieren (Hintergrundprozess, 202 Accepted).

Parameter	Typ	Info
`project_id`	integer	Pflicht
`keyword`	string	Pflicht Haupt-Keyword
`type`	string	Optional blog-post, guide, listicle, review, comparison, pillar
`length`	integer	Optional 300-5000 Wörter (Standard: 1500)
`tone`	string	Optional z.B. professional, casual
`language`	string	Optional de, en, es, fr

# Beispiel: Blog-Artikel generieren curl -X POST https://rankion.ai/api/v1/generate/article \ -H "Authorization: Bearer TOKEN" \ -H "Content-Type: application/json" \ -d '{ "project_id": 1, "keyword": "seo optimierung 2026", "type": "guide", "length": 2000, "language": "de" }' // Response 202 { "message": "Article generation queued", "article_id": 42 }

POST /v1/generate/image 5 Credits

KI-Bild generieren (Hintergrundprozess, 202 Accepted).

Parameter	Typ	Info
`project_id`	integer	Pflicht
`prompt`	string	Pflicht Bildbeschreibung
`style`	string	Optional photo, illustration, 3d, watercolor

Bulk Generation

Mehrere Artikel auf einmal generieren.

GET /v1/bulk-generations

Alle Bulk-Generierungen mit Status auflisten.

POST /v1/bulk-generations 15 Credits

Bulk-Generierung starten.

Parameter	Typ	Info
`project_id`	integer	Pflicht
`keywords`	array	Pflicht Array von Keywords
`settings`	object	Optional {type, length, tone, language}

GET /v1/bulk-generations/{bulk}

Status einer Bulk-Generierung mit einzelnen Items abrufen.

Autopilot

Automatische Content-Generierung nach Zeitplan konfigurieren.

GET /v1/autopilot

Alle Autopilot-Zeitpläne auflisten.

POST /v1/autopilot

Autopilot-Zeitplan erstellen.

Parameter	Typ	Info
`project_id`	integer	Pflicht
`name`	string	Pflicht
`frequency`	string	Pflicht daily, weekly, biweekly, monthly
`keyword_source`	string	Optional manual, keyword_list, ai_suggest
`keywords`	array	Optional Bei manual: Keyword-Array
`settings`	object	Optional {type, length, tone}

PUT /v1/autopilot/{schedule}

Zeitplan aktualisieren. Zusätzlich: is_active (boolean) zum Aktivieren/Deaktivieren.

DEL /v1/autopilot/{schedule}

Zeitplan löschen.

Credits

Credit-Guthaben und -Verlauf abfragen.

GET /v1/credits

Aktuelles Guthaben und Plan abrufen.

// Response 200 { "balance": 5000, "plan": "professional" }

GET /v1/credits/history

Paginierter Credit-Verlauf (20 Einträge pro Seite).

Blog (Admin)

Blog-Kategorien und -Posts verwalten.

Kategorien

GET /v1/blog/categories

Alle Blog-Kategorien auflisten.

POST /v1/blog/categories

Kategorie erstellen.

Parameter	Typ	Info
`name`	string	Pflicht
`slug`	string	Optional (wird auto-generiert)
`description`	string	Optional

PUT /v1/blog/categories/{category}

Kategorie aktualisieren.

DEL /v1/blog/categories/{category}

Kategorie löschen.

Posts

GET /v1/blog/posts

Alle Blog-Posts auflisten (paginiert).

GET /v1/blog/posts/{post}

Einzelnen Blog-Post abrufen.

POST /v1/blog/posts

Blog-Post erstellen.

Parameter	Typ	Info
`title`	string	Pflicht
`content`	string	Pflicht
`category_id`	integer	Optional
`status`	string	Optional draft, published
`locale`	string	Optional de, en, es, fr

PUT /v1/blog/posts/{post}

Blog-Post aktualisieren.

DEL /v1/blog/posts/{post}

Blog-Post löschen.

Health Check

Öffentlicher Endpoint (kein Token nötig) zur Überwachung.

GET /api/health

Gibt den Serverstatus zurück. Kein Authentifizierung nötig.

// Response 200 { "status": "ok", "timestamp": "2026-02-24T12:00:00Z" }