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
| Parameter | Pflicht | Bedeutung |
|---|---|---|
key | ja | Dein API Key, alternativ im Header X-API-Key |
url | ja | Eine Seite oder XML-Sitemap |
Antwort
| Feld | Bedeutung |
|---|---|
found, source | Ob Angaben gefunden wurden und woher: html, http_header oder sitemap |
alternates | Bis zu 30 Alternativen mit lang, url, http_status, canonical_matches, links_back |
errors | Gefundene Fehler mit code: invalid_lang_code, relative_url, bad_status, canonical_mismatch, no_return_link, no_self_reference, sitemap_conflict |
truncated | true, wenn nicht alle Alternativen geprüft wurden |
{
"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.