YepAPI – API-Referenz
Basis-URL: https://api.yepapi.com
Auth: x-api-key-Header
Antwort: { ok: true, data: {...} } oder { ok: false, error: { code, message } }
Rate-Limit: 60 Anfragen/Minute
SEO – Keywords
| Methode | Pfad | Kosten | Erforderlich | Beschreibung |
|---|---|---|---|---|
| POST | /v1/seo/keywords | 0,15 $ | keywords[], location | Bulk-Metriken: Volumen, CPC, Schwierigkeit, Absicht, Trends (bis zu 100) |
| POST | /v1/seo/keywords/ideas | 0,03 $ | keyword, location | Keyword-Vorschläge basierend auf einem Seed-Keyword |
| POST | /v1/seo/keywords/related | 0,03 $ | keyword, location | Verwandte Keywords zum Seed-Keyword |
Rückgabe: volume, cpc, difficulty (0-100), intent (informational/commercial/navigational/transactional), trend (12-Monate-Array)
SERP
| Methode | Pfad | Kosten | Erforderlich | Beschreibung |
|---|---|---|---|---|
| POST | /v1/serp/google | 0,01 $ | query, location | Googles organische Ergebnisse |
| POST | /v1/serp/google/news | 0,01 $ | query, location | Google News-Ergebnisse |
| POST | /v1/serp/google/maps | 0,01 $ | query, location | Google Maps / lokale Ergebnisse |
Rückgabe: results[] mit title, url, snippet, position. Maps fügt rating, reviews, address, phone hinzu.
Domain-Analyse
| Methode | Pfad | Kosten | Erforderlich | Beschreibung |
|---|---|---|---|---|
| POST | /v1/seo/domain/overview | 0,01 $ | domain | Traffic, Keywords, Backlinks, Domain-Rank |
| POST | /v1/seo/domain/keywords | 0,04 $ | domain | Keywords, für die eine Domain rankt |
| POST | /v1/seo/domain/backlinks | 0,05 $ | domain | Backlink-Profil der Domain |
Rückgabe: overview liefert traffic, keywords_count, backlinks, domain_rank. Keywords liefert keyword, position, volume, url.
Konkurrenten
| Methode | Pfad | Kosten | Erforderlich | Beschreibung |
|---|---|---|---|---|
| POST | /v1/seo/competitors | 0,04 $ | domain | Konkurrenz-Domains basierend auf Keyword-Überschneidungen |
| POST | /v1/seo/keyword-gap | 0,04 $ | domain, competitor | Keyword-Lücke zwischen zwei Domains |
Rückgabe: competitors liefert domain, overlap, traffic. Gap liefert keyword, your_position, competitor_position, volume.
Backlinks
| Methode | Pfad | Kosten | Erforderlich | Beschreibung |
|---|---|---|---|---|
| POST | /v1/seo/backlinks | 0,05 $ | target | Einzelne Backlinks zu einer Domain/URL |
| POST | /v1/seo/backlinks/summary | 0,03 $ | target | Aggregierte Metriken + Dofollow-Ratio |
| POST | /v1/seo/referring-domains | 0,03 $ | target | Verweisende Domains mit Autorität |
Rückgabe: summary liefert total_backlinks, dofollow_ratio, domain_rank. Backlinks liefert source_url, anchor, type, domain_rank.
OnPage & Trends
| Methode | Pfad | Kosten | Erforderlich | Beschreibung |
|---|---|---|---|---|
| POST | /v1/seo/page-audit | 0,03 $ | url | Technisches SEO-Audit (Meta, Überschriften, Links, Bilder) |
| POST | /v1/seo/lighthouse | 0,05 $ | url | Lighthouse-Werte (Performance, Barrierefreiheit, SEO, Best Practices) |
| POST | /v1/seo/trends | 0,02 $ | keywords[] | Google Trends-Interesse im Zeitverlauf (bis zu 5 Keywords) |
Rückgabe: page-audit liefert issues[], meta, headings, links, images. Lighthouse liefert performance, accessibility, seo, best_practices (0-100). Trends liefert interest_over_time[].
KI-Sichtbarkeit
| Methode | Pfad | Kosten | Erforderlich | Beschreibung |
|---|---|---|---|---|
| POST | /v1/seo/ai/chatgpt | 0,05 $ | query | Was ChatGPT über eine Marke/Anfrage sagt |
| POST | /v1/seo/ai/gemini | 0,05 $ | query | Was Gemini über eine Marke/Anfrage sagt |
Rückgabe: response (Text), mentions[], sentiment.
Web Scraping
| Methode | Pfad | Kosten | Erforderlich | Beschreibung |
|---|---|---|---|---|
| POST | /v1/scrape | 0,01 $ | url | Scraping nach Markdown/HTML/Text |
| POST | /v1/scrape/js | 0,02 $ | url | JS-gerendertes Scraping (Headless-Browser) |
| POST | /v1/scrape/stealth | 0,03 $ | url | Anti-Bot-Bypass (Residential-Proxies) |
| POST | /v1/scrape/ai-extract | 0,03 $ | url, prompt | KI-gestützte strukturierte Extraktion |
Optional: format ("markdown"/"html"/"text"), waitFor (CSS-Selektor), timeout (ms).
Rückgabe: content (Zeichenkette), metadata (title, description, url).
YouTube
| Methode | Pfad | Kosten | Erforderlich | Beschreibung |
|---|---|---|---|---|
| POST | /v1/youtube/search | 0,01 $ | query | Suche nach Videos, Kanälen, Playlists |
| POST | /v1/youtube/video | 0,02 $ | videoId | Vollständige Video-Metadaten + Formate |
| POST | /v1/youtube/transcript | 0,01 $ | videoId | Transkript mit Zeitstempeln |
| POST | /v1/youtube/channel | 0,01 $ | channelId oder handle | Kanalübersicht |
| POST | /v1/youtube/comments | 0,01 $ | videoId | Kommentare und Antworten |
Rückgabe: search liefert results[] mit videoId, title, views, published. Transcript liefert segments[] mit text, start, duration.
KI-Chat
| Methode | Pfad | Kosten | Erforderlich | Beschreibung |
|---|---|---|---|---|
| POST | /v1/ai/chat | variabel | model, messages[] | Chat mit 69 KI-Modellen |
| GET | /v1/ai/models | kostenlos | — | Verfügbare Modelle + Preise auflisten |
Gemeinsame optionale Felder
SEO-Endpunkte: location (Standard "us"), language (Standard "en"), limit, offset.
Scraping-Endpunkte: format, waitFor, timeout.
Fehlercodes
| Code | HTTP | Bedeutung |
|---|---|---|
INVALID_API_KEY | 401 | Fehlender oder ungültiger Schlüssel |
REVOKED_API_KEY | 401 | Schlüssel widerrufen |
NO_CREDITS | 402 | Nicht ausreichendes Guthaben |
RATE_LIMITED | 429 | 60 Anfragen/Minute überschritten |
VALIDATION_ERROR | 400 | Fehlerhafter Anfragetext |
UPSTREAM_ERROR | 502 | Fehler beim Anbieter |
MODEL_NOT_FOUND | 400 | Ungültiges KI-Modell |
AI_UPSTREAM_ERROR | 502 | Fehler beim KI-Anbieter |
STREAM_ERROR | 502 | SSE unterbrochen |
NOT_FOUND | 404 | Endpunkt nicht gefunden |
INTERNAL_ERROR | 500 | Serverfehler |
Links
- Docs: https://docs.yepapi.com
- Dashboard: https://yepapi.com/dashboard
- API-Schlüssel: https://yepapi.com/dashboard/api-keys
- Vollständige Referenz: https://docs.yepapi.com/llms-full.txt
- MCP-Server:
npx -y @yepapi/mcp