Content Briefing API
Aufruf
Analysiert die besten Seiten zu einem Keyword und liefert Zielwerte für deinen Text: Länge, Struktur, wichtige Keywords und Phrasen.
https://seorch.de/api/content-briefing/?key=DEIN_KEY&keyword=seo%20tool&country=de
Parameter
| Parameter | Pflicht | Bedeutung |
|---|---|---|
key | ja | Dein API Key, alternativ im Header X-API-Key |
keyword | ja | Das Keyword |
country | nein | de, at, ch, uk, us oder es |
sites | nein | Bis zu 10 eigene Vergleichsseiten statt der Google-Ergebnisse |
stopwords | nein | Wörter, die in der Auswertung fehlen sollen |
url | nein | Deine Seite, ihre Werte stehen in your_page |
Antwort
| Feld | Bedeutung |
|---|---|
competitors | Die verglichenen Seiten mit Wörtern, Sätzen, Keyword-Anzahl, Lesbarkeit und Überschriften |
summary | Durchschnittswerte als Zielwerte |
keywords | must_have, should_have und more nach Häufigkeit über die Seiten |
phrases, keyword_occurrences | Wichtige Phrasen sowie Häufigkeit und Dichte des Keywords |
{
"api_version": 1,
"keyword": "seo tool",
"country": "de",
"your_page": {
"url": "https://www.getmad.de/",
"words": 2721,
"keyword_count": 0,
"flesch": 69,
"questions": 8,
"h1": 0,
"h2": 49
},
"competitors": [
{
"rank": 1,
"url": "https://www.eology.de/magazine/praktische-seo-tool-tipps",
"analysed": true,
"words": 2779,
"words_in_sentences": 1931,
"keyword_count": 0,
"flesch": 54,
"questions": 12,
"h1": 1,
"h2": 7,
"sentences": 105
}
],
"summary": {
"sites_analysed": 9,
"sites_compared": 9,
"words": 3568,
"sentences": 170,
"flesch": 51
},
"keyword_occurrences": [
{
"keyword": "seo tool",
"average_count": 6,
"density_percent": 0.17
}
],
"keywords": {
"must_have": [
"seo",
"tools",
"daten"
],
"should_have": [
"erstellen",
"optimieren",
"kleine"
],
"more": [
"sitemap",
"neilpatel",
"test"
]
},
"phrases": [
"mit seo tools",
"seo tools seo"
],
"wikipedia": {
"entities": [],
"internal_links": []
}
}
Fehler
Fehler kommen als JSON mit festem Code. Für alle APIs gelten missing_key und invalid_key (401), rate_limited (429) und fehlende oder ungültige Parameter (400). Außerdem bei dieser API: url_not_allowed, no_sites_analysed, upstream_error.
Limits
Pro Key gelten 10 Anfragen pro Minute und 500 pro Tag. Höhere Limits sind auf Anfrage möglich.