Alle Tools

  1. SEORCH
  2. SEO API
  3. Hreflang API

Hreflang API

Aufruf

Prüft die Hreflang-Angaben einer Seite oder XML-Sitemap: Sprachcodes, Status und Canonical aller Alternativen und ob sie zurückverweisen.

https://seorch.de/api/hreflang/?key=DEIN_KEY&url=https://www.apple.com/de/

Parameter

ParameterPflichtBedeutung
keyjaDein API Key, alternativ im Header X-API-Key
urljaEine Seite oder XML-Sitemap

Antwort

FeldBedeutung
found, sourceOb Angaben gefunden wurden und woher: html, http_header oder sitemap
alternatesBis zu 30 Alternativen mit lang, url, http_status, canonical_matches, links_back
errorsGefundene Fehler mit code: invalid_lang_code, relative_url, bad_status, canonical_mismatch, no_return_link, no_self_reference, sitemap_conflict
truncatedtrue, wenn nicht alle Alternativen geprüft wurden
Beispielantwort, gekürzt
{
  "api_version": 1,
  "url": "https://www.apple.com/de/",
  "url_effective": "https://www.apple.com/de/",
  "used_headless": false,
  "type": "page",
  "source": "html",
  "robots_txt": {
    "url": "https://www.apple.com/robots.txt",
    "found": true,
    "sitemaps": [
      "https://www.apple.com/shop/sitemap.xml"
    ]
  },
  "canonical": "https://www.apple.com/de/",
  "found": true,
  "alternates": [
    {
      "lang": "en-us",
      "url": "https://www.apple.com/",
      "valid_code": true,
      "absolute_url": true,
      "http_status": 200,
      "canonical": "https://www.apple.com/",
      "canonical_matches": true,
      "hreflang_count": 137,
      "links_back": true
    }
  ],
  "truncated": true,
  "errors": []
}

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, url_unreachable, bad_status.

Limits

Pro Key gelten 10 Anfragen pro Minute und 500 pro Tag. Höhere Limits sind auf Anfrage möglich.