Alle Tools

  1. SEORCH
  2. SEO API
  3. Content Briefing API

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

ParameterPflichtBedeutung
keyjaDein API Key, alternativ im Header X-API-Key
keywordjaDas Keyword
countryneinde, at, ch, uk, us oder es
sitesneinBis zu 10 eigene Vergleichsseiten statt der Google-Ergebnisse
stopwordsneinWörter, die in der Auswertung fehlen sollen
urlneinDeine Seite, ihre Werte stehen in your_page

Antwort

FeldBedeutung
competitorsDie verglichenen Seiten mit Wörtern, Sätzen, Keyword-Anzahl, Lesbarkeit und Überschriften
summaryDurchschnittswerte als Zielwerte
keywordsmust_have, should_have und more nach Häufigkeit über die Seiten
phrases, keyword_occurrencesWichtige Phrasen sowie Häufigkeit und Dichte des Keywords
Beispielantwort, gekürzt
{
  "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.