Was ist die Yelp-API?
Die Yelp Fusion API ermöglicht es Nutzern, lokale Inhalte und Bewertungen von Millionen von Unternehmen aus Gastronomie und Dienstleistungen in 32 Ländern abzurufen. Die Yelp-Inhalte können für die Entwicklung von Apps und Websites genutzt werden.
Perfekt, wenn Sie die Schaltfläche ‘Nach oben’ in einem bestimmten Seitenabschnitt platzieren möchten.
Ihr Fusion-API-Schlüssel ist schnell und einfach zu bekommen. Befolgen Sie dazu einfach diese Yelp-API-Richtlinien.
- Schritt 1 – Konto erstellen
Zuerst meldest du dich im das Entwicklerportal mit deinem bestehenden Yelp-Konto an oder erstelle ein neues Konto.
Sie können Yelp weiterhin über Facebook-, Google- oder Apple-Konto nutzen. Eine weitere Option ist die Anmeldung mit Ihrer E-Mail-Adresse. In diesem Fall erhalten Sie eine Bestätigungs-E-Mail – folgen Sie dem Link darin, um Ihr Konto zu verifizieren.
- Schritt 2 – Mit Fusion API starten
Nachdem Sie sich beim Yelp-Entwicklerdienst angemeldet haben, scrollen Sie auf der ersten Seite ganz nach unten und klicken Sie auf die Schaltfläche Yelp Fusion entdecken.
Fusion API-Bereich des Portals. Klicken Sie auf Jetzt starten.
- Schritt 3 – Eine App erstellen
Erstellen Sie Ihre erste Yelp-App, um Ihren persönlichen Fusion-API-Schlüssel zu erhalten. Füllen Sie die erforderlichen Felder im Formular aus, stimmen Sie den Yelp-API-Nutzungsbedingungen und den Anzeigeanforderungen zu. Bestätigen Sie anschließend, dass Sie ein Mensch sind, und klicken Sie auf Neue App erstellen.
Anschließend erhalten Sie Ihre App-ID und Ihren API-Schlüssel. Speichern Sie sie, damit Sie mit Ihrer App loslegen können.
Wie verwendet man die Yelp-API?
Es gibt verschiedene Arten von APIs, die sich grob in Lösungen für Kleinunternehmen oder Unternehmen sowie für mittelgroße oder große Unternehmen und potenzielle Yelp-Partner unterteilen lassen. Die ersten sind in die Yelp Fusion API integriert und kostenfrei für jedermann verfügbar. Die letzteren erfordern einen speziellen Zugang, den Sie beantragen müssen und auf die Entscheidung des Unternehmens warten.
Die Yelp Fusion API ermöglicht Nutzern den Zugriff auf lokale Inhalte und Bewertungen von Millionen von Unternehmen aus der Gastronomie und Dienstleistungsbranche in 32 Ländern.
Die Yelp-Inhalte können für App- und Webentwicklungszwecke genutzt werden, um Ihren Nutzern zu helfen, die besten Orte und Dienstleister in einer bestimmten Region zu finden und sie nach Bewertungen und Kundenrezensionen zu vergleichen. Die Yelp Fusion API verwendet Authentifizierung mittels privatem Schlüssel, um alle Endpunkte zu authentifizieren.
Preisgestaltung und Grenzen
Alle Lösungen stehen im Standardzugang offen und kostenfrei zur Verfügung. Es gibt jedoch Yelp-API-Beschränkungen; Für zusätzliches Ratenvolumen wird dies fallweise bereitgestellt. Das bedeutet, Sie müssen sich dafür bewerben und Ihr Projekt in vollem Potenzial schildern. Danach warten Sie auf deren Entscheidung.
Die Yelp-API kennt mehrere Grenzwerte. Der wichtigste ist die QPS-Rate-Limiting (Anfragen pro Sekunde). Senden Sie Anfragen an die Yelp-API zu schnell, erhalten Sie möglicherweise HTTP-429-Fehler. Wenn der Fehler Ihnen regelmäßig begegnet, reduzieren Sie das Tempo Ihrer API-Aufrufe.
Neben dem QPS gibt es auch eine Beschränkung der API-Anfragen pro Tag.
| RateLimit-DailyLimit | Maximale Anzahl von Aufrufen pro Tag |
| RateLimit-Remaining | Verbleibende Anrufe heute |
| RateLimit-ResetTime | Der Zeitpunkt, zu dem das aktuelle Rate-Limit-Fenster abläuft |
Yelp-API-Beispiele
- Yelp-Bewertungen-API
Diese Abfrage ist ein Yelp Fusion API-Beispiel, das demonstriert, wie man bis zu drei Bewertungs-Auszüge für ein Unternehmen anzeigt. Es gibt auch eine Private Yelp Review API-Lösung, die autorisierten Yelp-Partnern den Abruf von Bewertungen ermöglicht, die öffentlich auf der Plattform sichtbar sind.
Um unbegrenzte Bewertungen Ihres Unternehmens auf Ihrer Website zu präsentieren, verwenden Sie das kostenlose Elfsight Yelp-Reviews-Widget!
- Yelp Business-API
Die Fusion API bietet eine komplette Reihe von Business-Endpunkten, die detaillierte Unternehmensdaten liefern.
Dies sind die wichtigsten Endpunkte, die verwendet werden:
Name Pfad Beschreibung Unternehmenssuche /businesses/search Suche nach Stichwort, Kategorie, Standort, Preisklasse usw. Telefon-Suche /businesses/search/phone Nach Telefonnummer suchen. Transaktionssuche /transactions/{transaction_type}/search Nach Diensten suchen, die Essenslieferungen unterstützen. Unternehmensdaten /businesses/{id} Erhalten Sie vollständige Firmendaten, z. B. Name, Adresse, Telefonnummer, Fotos, Yelp-Bewertung, Preisniveaus und Öffnungszeiten. Business Match /businesses/matches Finden Sie das Yelp-Unternehmen, das exakt zu Ihrem Standort passt. - Yelp Search API
Yelp-API-Änderungen
Die derzeit verwendete Yelp-API-Version ist v3, die Yelp-API v2 im Jahr 2018 ablöste.
Die v2-Version verwendete OAuth 2.0 zur Authentifizierung von API-Anfragen. Um diesen Prozess zu vereinfachen, läuft die API seit dem 1. März 2018 ausschließlich mit API-Schlüsseln und verwendet OAuth 2.0 für Abfragen nicht mehr.
Folgen Sie diesen einfachen Schritten, um es umzusetzen:
- Ihre Client-ID erhalten Sie in der Manage App.
- Stellen Sie eine Anfrage an den Token-Endpunkt, um ein Zugriffstoken zu erhalten.
- Platziere den Zugriffstoken im Anforderungs-Header und starte API-Anfragen.
Mit nur API-Schlüsseln ist dieser Prozess:
- API-Schlüssel erhalten Sie auf der Seite Apps verwalten.
- Fügen Sie den API-Schlüssel in den Anfrage-Header ein.
Es ist nicht mehr nötig, den Endpunkt aufzurufen, um ein Zugriffstoken zu erhalten. Ihr API-Schlüssel läuft nicht ab, daher müssen Sie sich keine Sorgen machen, neue Schlüssel zu generieren.
Yelp-Entwickler-API-Dokumentation
Die Yelp-Entwickler-Website enthält alle Arten von Yelp-API-Tutorials, die deren Funktionsprinzipien und praktische Nutzung erklären. Sie finden es hier. Dort können Sie auch Ihre Anwendungen erstellen und mit der Fusion-API und Yelp GraphQL – einer Abfragesprache für APIs – arbeiten. Die umfassende Sammlung von Entwicklerdokumentationen zu speziellen Partner-APIs ist im Yelp-Entwicklerportal zu finden. Der Zugriff auf diese Werbe-APIs, Reservierungs-APIs und weitere APIs ist nur nach Beantragung möglich.
Häufige Fragen
Viele Geschäftsdaten und weitere Attribute befinden sich auf der Yelp-Plattform, sind jedoch nicht in der Yelp-Developer-API-Dokumentation aufgeführt. Wie lässt sich darauf zugreifen?
Yelp geht äußerst sorgfältig mit den Datenfeldern um, die über die API offengelegt werden. Wenn Sie eine App entwickeln, die zusätzlich Yelp-Daten nutzen könnte, können Sie sich für das Fusion VIP-Programm bewerben und Ihren Fall dem Yelp-Team vorlegen.
Wie filtere ich Yelp-Daten nach Land?
Die Yelp-API holt Ergebnisse aus allen Regionen, in denen der Dienst verfügbar ist. Wenn Sie die Ergebnisse Ihrer Abfragen auf eine bestimmte Stadt filtern möchten, verwenden Sie bitte den Standort-Parameter bei der Nutzung der Such-API.
Warum liefert die Yelp-API nicht alle Unternehmen zurück, die bei Yelp gelistet sind?
Die Yelp-API liefert nur Informationen zu Unternehmen zurück, zu denen von Nutzern erzeugte Inhalte hinzugefügt wurden. Genauer gesagt müssen sie mindestens eine Kundenbewertung haben.
Kann ich auswählen, welche Bewertungen in einer API-Anfrage angezeigt werden sollen?
Sortierung und Reihenfolge der Bewertungen richten sich nach Aktualität, Nutzerabstimmung und weiteren Qualitätsfaktoren, damit Verbraucher fundierte Entscheidungen treffen. Die Yelp API lässt sich nicht so konfigurieren, dass alternative oder handverlesene Bewertungsauszüge abgerufen werden.
Wie bekomme ich mehr API-Aufrufe?
Zusätzliche API-Aufrufe werden basierend auf dem tatsächlichen Traffic der Website oder App gewährt, typischerweise nachdem ein Produkt gestartet wurde. Versuchen Sie, API-Aufrufe während der Entwicklungsphase zu minimieren, indem Sie Yelp-Daten bis zu 24 Stunden cachen und Unternehmens-IDs speichern. Sie können api@yelp.com per E-Mail kontaktieren mit Ihrer Yelp API Client ID und dem Unternehmen über Ihr Produkt oder Ihre Integration informieren und die genaue Anzahl der täglichen Anfragen mitteilen, die Sie nutzen möchten.
