Die IndexNow-API-Anforderungsreferenz ist ein technisches Protokoll, mit dem Website-Betreiber Suchmaschinen wie Yandex unmittelbar über neue, aktualisierte oder gelöschte Inhalte in Kenntnis setzen können. Durch das Senden einer einfachen HTTP-Anfrage mit der Seiten-URL und einem eindeutigen Schlüssel stellen Sie sicher, dass Crawler Ihre neuesten Änderungen priorisieren, ohne auf den regulären Crawl-Zyklus zu warten. Diese Methode senkt die Serverlast und beschleunigt die Bereitstellung neuer Informationen im Web.
Was ist die IndexNow API und warum ist sie wichtig?
Das traditionelle Crawling basiert darauf, dass Suchmaschinen Links entdecken oder Sitemaps in ihrem eigenen Tempo überprüfen. Dies führt oft zu einer Lücke zwischen Veröffentlichung und Indexierung. IndexNow ändert dies, indem es die Kontrolle an den Website-Betreiber zurückgibt. Sie teilen der Suchmaschine mit, dass eine Seite bereit ist, und diese reagiert mit der Planung eines Besuchs.
Das Protokoll ist besonders nützlich für Websites, die täglich viele Seiten veröffentlichen. Beispielsweise muss ein Nachrichtenportal oder eine große Retail-Site sicherstellen, dass ihre neuesten Daten so schnell wie möglich in den Suchergebnissen auftauchen. Ohne diese API muss ein neuer Artikel möglicherweise Stunden oder Tage warten, bis er von einem Standard-Crawler entdeckt wird.
Wie strukturiert man eine gültige IndexNow API-Anfrage?
Eine Standardanfrage erfordert drei Hauptelemente: den Host, die URL-Liste und den Schlüssel. Der Host ist der Domainname, auf dem die Änderungen stattgefunden haben. Die URL-Liste kann bis zu 10.000 Links pro Anfrage enthalten, wobei einzelne Updates üblich sind. Der Schlüssel ist eine Zeichenkette, die beweist, dass Ihnen die Domain gehört. Beachten Sie, dass der Schlüssel auf Ihrem Server gehostet werden muss, um verifiziert zu werden.
- Der API-Endpunkt, wie zum Beispiel yandex.com/indexnow.
- Der Content-Type-Header muss auf application/json gesetzt werden.
- Ein JSON-Body, der den Host, den Schlüssel und eine Liste von URLs enthält.
- Das keyLocation, welches den Pfad zu Ihrer Verifizierungsdatei angibt.
Die Anfrage kann als POST oder GET gesendet werden. Die POST-Methode wird für das Bashing mehrerer URLs bevorzugt. Bei der Verwendung von POST enthält der Body der Anfrage die Daten in einem strukturierten Format. Die GET-Methode ist einfacher, unterstützt jedoch nur eine URL nach der anderen. Die meisten Entwickler wählen POST wegen seiner Effizienz.
Wir stellen fest, dass viele Entwickler vergessen, den Schlüssel exakt zwischen dem API-Body und der Textdatei abzugleichen. Ein einziger Zeichenunterschied oder ein zusätzliches Leerzeichen führt dazu, dass die Verifizierung sofort fehlschlägt.
Alien Road SEO-Team
Was sind die Hauptkomponenten für die Validierung?
Die Sicherheit wird über eine Textdatei geregelt, die im Stammverzeichnis abgelegt ist. Diese Datei enthält dieselbe Schlüsselzeichenkette, die auch im API-Aufruf verwendet wird. Suchmaschinen verifizieren die Anfrage, indem sie diese Datei von Ihrem Server abrufen. Wenn der Schlüssel in der Anfrage mit dem Schlüssel in der Datei auf Ihrem Server übereinstimmt, wird die Anfrage authentifiziert.
Der Schlüssel selbst sollte mindestens 8 Zeichen lang sein, aber die Verwendung einer 32-stelligen alphanumerischen Zeichenkette ist ein zuverlässigerer Standard. Sie sollten die Textdatei nach dem Schlüssel benennen. Wenn Ihr Schlüssel beispielsweise ‘abc123’ lautet, sollte Ihre Datei ‘abc123.txt’ heißen. Dies ermöglicht es der Suchmaschine, sie ohne Rätselraten zu finden.
Wie behandelt man häufige API-Antwortfehler?
Ähnlich wie bei RSS-Feed-Fehlern, die in der technischen Dokumentation erwähnt werden, schlagen IndexNow-Anfragen fehl, wenn die Syntax falsch ist. Ein 400 Bad Request bedeutet normalerweise, dass das JSON-Format ungültig ist oder ein Pflichtfeld fehlt. Ein 403 Forbidden weist darauf hin, dass der Schlüssel falsch ist oder die Schlüsseldatei vom Crawler nicht erreicht werden kann. Beachten Sie, dass technische Hygiene für den Erfolg unerlässlich ist.
- 400: Ungültige Syntax. Überprüfen Sie das JSON auf fehlende Anführungszeichen oder Kommas.
- 403: Schlüsselverifizierung fehlgeschlagen. Stellen Sie sicher, dass sich die Datei im Stammverzeichnis befindet.
- 422: Die URL gehört nicht zu dem in der Anfrage angegebenen Host.
- 429: Zu viele Anfragen. Reduzieren Sie die Häufigkeit Ihrer API-Aufrufe.
Wenn Sie einen 403-Fehler sehen, überprüfen Sie, ob Ihr Server den User-Agent der Suchmaschine blockiert. Manchmal verhindern Firewalls, dass der Crawler die Schlüsseldatei abruft. Sie müssen den Zugriff auf die spezifische Verifizierungs-URL erlauben, um eine reibungslose Verbindung zwischen Ihrer Website und der Suchmaschine aufrechtzuerhalten.
Wie Alien Road die IndexNow API-Anfragereferenz anwendet
Bei Alien Road integrieren wir die IndexNow API für unsere Kunden in den CMS-Workflow. Für eine typische E-Commerce-Site mit tausenden von Produkten ist eine manuelle Indexierung unmöglich. Wir richten einen automatisierten Trigger ein, der jedes Mal ausgelöst wird, wenn sich ein Produktpreis ändert oder ein neuer Artikel hinzugefügt wird. Dies stellt sicher, dass die Suchmaschine ohne Verzögerung über die aktuellsten Daten verfügt.
Bei einer typischen Zusammenarbeit generieren wir zunächst einen eindeutigen Schlüssel und platzieren ihn im Stammverzeichnis des Kundenservers. Anschließend konfigurieren wir deren Backend so, dass URLs gebatcht und stündlich an den Yandex-Endpunkt gesendet werden. Dies verhindert eine Überlastung des Servers und stellt gleichzeitig sicher, dass Preissenkungen oder Lagerbestandsupdates innerhalb von Minuten in den Suchergebnissen erscheinen. Für einen Shopify-Store, der Haushaltswaren verkauft, hält dieser Prozess ihre Bestandsdaten für potenzielle Kunden genau.
Die Verwendung von IndexNow für groß angelegte Migrationen ist eine starke Strategie. Anstatt Wochen darauf zu warten, dass ein Website-Umzug erkannt wird, pushen wir die neuen URLs direkt, was hilft, die Traffic-Stabilität während des Übergangs aufrechtzuerhalten.
Alien Road SEO-Team
Technische Spezifikationen und Grenzen
Obwohl die API leistungsstark ist, hat sie Grenzen, die Sie respektieren müssen. Sie können nicht mehr als 10.000 URLs in einer einzigen POST-Anfrage übermitteln. Außerdem müssen alle URLs zum selben Host gehören. Wenn Sie mehrere Subdomains verwalten, erfordert jede ihren eigenen Schlüssel und ihren eigenen API-Aufruf, um korrekt verarbeitet zu werden.
Die Formatierung des JSON-Payloads ist streng. Ähnlich wie die Anforderungen für News-Feeds müssen URLs in IndexNow absolut und voll qualifiziert sein. Sie müssen das korrekte Protokoll verwenden, entweder HTTP oder HTTPS. Sonderzeichen müssen mittels UTF-8-Codierung ordnungsgemäß maskiert werden. Ein zusätzliches Anführungszeichen oder ein nicht ordnungsgemäß geschlossenes Attribut führt dazu, dass die gesamte Charge nicht indexiert wird.
Vergleich von IndexNow mit XML-Sitemaps
XML-Sitemaps sind passive Dateien, die Suchmaschinen gelegentlich überprüfen. IndexNow ist ein aktives Benachrichtigungssystem. Zwar sollten Sie weiterhin eine Sitemap für eine vollständige Sichtbarkeit der Website-Struktur pflegen, aber die API ist die bessere Wahl für zeitkritische Updates. Die gemeinsame Nutzung beider Methoden bietet eine vollständige Indexierungsstrategie.
Sitemaps können manchmal sehr groß werden, was zu langsamen Verarbeitungszeiten führt. IndexNow vermeidet dies, indem es sich nur auf das konzentriert, was sich kürzlich geändert hat. Dieser zielgerichtete Ansatz ist effizienter sowohl für Ihren Server als auch für die Ressourcen der Suchmaschine. Er reduziert die Notwendigkeit für den Crawler, unveränderte Seiten wiederholt zu besuchen.
Wo Sie diese Woche anfangen sollten
Beginnen Sie damit, zu überprüfen, ob Ihr CMS ein natives IndexNow-Plugin hat. Wenn nicht, generieren Sie einen 32-stelligen Schlüssel und laden Sie ihn als .txt-Datei in Ihr Server-Root hoch. Testen Sie eine einzelne URL mit einem einfachen Befehlszeilentool, um zu überprüfen, ob Sie eine 200 OK-Antwort erhalten. Sobald Sie die Verbindung verifiziert haben, automatisieren Sie den Prozess für alle neuen Inhaltsaktualisierungen, um Ihre Suchpräsenz frisch zu halten.
Überwachen Sie Ihre Server-Logs auf den Besuch der Suchmaschine, nachdem Sie eine Anfrage gesendet haben. Dies bestätigt, dass das System funktioniert. Wenn Sie Fehler bemerken, schlagen Sie in der Fehlercodeliste nach und überprüfen Sie Ihre JSON-Syntax auf häufige Fehler wie nicht maskierte Zeichen oder fehlende Klammern.