Yelp API nedir?
Yelp Fusion API, kullanıcılarına 32 ülkedeki milyonlarca konaklama ve hizmet sektörüne ait işletmeden yerel içerik ve kullanıcı yorumlarına erişim sağlar. Yelp içeriği, uygulama ve web sitesi geliştirme amaçları için kullanılabilir.
Yelp API Anahtarını nasıl alırım?
Fusion API anahtarınızı almak hızlı ve kolaydır. Bunu yapmak için aşağıdaki basit Yelp API yönergelerini izlemeniz gerekir.
- Adım 1 – Hesap Oluştur
İlk olarak mevcut Yelp hesabınızla geliştirici portalına giriş yapın veya yeni bir hesap oluşturun
Facebook, Google veya Apple hesabı ile Yelp hizmetiyle çalışmaya devam edebilirsiniz. Diğer seçenek ise e-posta adresinizle kaydolmaktır. Bu durumda onay e-postası alacaksınız – hesabınızı doğrulamak için içindeki bağlantıyı takip etmeyi unutmayın.
- Adım 2 – Fusion API ile Başlayın
Yelp geliştirici hizmetine giriş yaptıktan sonra, ilk sayfanın en altına kaydırın ve Explore Yelp Fusion düğmesini tıklayın.
Portalın Fusion API bölümüne yönlendirileceksiniz. Başlat düğmesine basın.
- Adım 3 – Uygulama Oluştur
Kişisel Fusion API anahtarınızı almak için ilk Yelp Uygulamanızı oluşturun. Formdaki gerekli alanları doldurun, Yelp API Kullanım Şartları ve Görünüm Gereksinimleri’ni kabul edin. Ardından kendinizi insan olduğunuzu kanıtlayın ve Yeni Uygulama Oluştur’a basın.
Bundan sonra App ID’inizi ve API Anahtarınızı alacaksınız. Uygulamanızla çalışmaya başlamak için bunları kaydedin.
Yelp API nasıl kullanılır?
Birkaç farklı API türü vardır; bunlar temel olarak küçük işletmelere veya kurumsal çözümlere ve orta/büyük ölçekli işletmelere ile potansiyel Yelp iş ortakları için ayrılmıştır. İlk grup Yelp Fusion API’ye dahil olup herkes için ücretsizdir. İkinci grup ise özel erişim gerektirir; başvurarak şirketin kararını beklemeniz gerekir.
Yelp Fusion API, kullanıcılarına 32 ülkedeki milyonlarca konaklama ve hizmet sektörüne ait işletmeden yerel içerik ve kullanıcı yorumlarına ulaşma imkanı sunar.
Yelp içeriği, kullanıcılarınızın belirli bir bölgede en iyi mekanları ve hizmet sağlayıcılarını bulmasına yardımcı olmak için uygulama ve web sitesi geliştirme amaçlarıyla kullanılabilir; ayrıca bunları puan ve müşteri yorumlarına göre karşılaştırabilirsiniz. Yelp Fusion API, tüm uç noktaları doğrulamak için özel anahtar kimlik doğrulaması kullanır.
Fiyatlandırma ve Sınırlar
Standart erişim için tüm çözümler açık ve ücretsizdir. Ancak Yelp API çağrıları için ek hız sınırları bulunabilir ve bu sınırlar durum bazında belirlenir. Bu, projenizi tam potansiyeliyle anlatan bir başvuru yapmanızı gerektirir. Bundan sonra onların kararını bekleyeceksiniz.
Yelp API’nin birkaç sınır türü vardır. İlki, saniyedeki sorgu sayısını ifade eden QPS (Queries Per Second) Sınırı’dır. Yelp API’ye çok hızlı sorgu yaparsanız HTTP 429 hatası alabilirsiniz. Hata düzenli olarak görünüyorsa, API çağrı hızını yavaşlatmayı deneyin.
QPS’nin yanı sıra günlük API istek sayısında da bir sınır vardır.
| RateLimit – Günlük Limit | Bir kullanıcının günde yapabileceği en fazla çağrı sayısı |
| Kalan istek limiti | Gün içindeki kalan çağrı sayısı |
| RateLimit-Sıfırlanma Zamanı | Geçerli hız sınırı penceresinin biteceği an |
Yelp API Örnekleri
- Yelp Yorumlar API’si
Bu tür bir sorgu, bir işletme için üçe kadar inceleme özeti göstermek için kullanılan bir Yelp Fusion API örneğidir. Ayrıca, onaylı Yelp ortaklarının platform üzerinde kamuya açık incelemeleri almak için kullanılan Private Yelp Review API çözümü de bulunmaktadır.
Elfsight Yelp Reviews widget available for free!”>Web sitenizde sınırsız sayıda işletme incelemesini sergilemek için ücretsiz olan Elfsight Yelp Reviews widget’ını kullanın!
- Yelp İşletme API’si
Fusion API, ayrıntılı işletme içeriğini döndüren uç noktalarının tamamını sağlar.
Kullanılan temel uç noktalar bunlar:
Ad Yol Açıklama İş Arama /businesses/search Anahtar kelime, kategori, konum, fiyat düzeyi vb. ile ara. Telefon Araması /businesses/search/phone Telefon numarasıyla ara. İşlem Arama /transactions/{transaction_type}/search Gıda teslimat işlemlerini destekleyen hizmetleri ara. İşletme Detayları /businesses/{id} İsim, adres, telefon numarası, fotoğraflar, Yelp puanı, fiyat seviyeleri ve çalışma saatleri gibi tüm işletme verilerini edinin. İşletme Eşleşmesi /businesses/matches Tam girilen konuma uygun Yelp işletmesini bulun. - Yelp Arama API’si
Bu uç nokta, verilen arama kriterlerine göre en çok 1000 işletme döndürür. İşletme hakkında bazı temel bilgiler içerir. Fusion Search API, Sanat, Güzellik, Eğitim ve Finans ile daha pek çok kategoriyi kapsar. Yelp API kategorilerinin tam listesi için buraya bakın. API, inceleme olmadan işletme döndürmez.
Yelp API değişiklikleri
Şu anda kullanılan Yelp API sürümü v3’tür ve 2018’de Yelp API v2’yi değiştirdi.
v2 sürümü, API’ye yapılan istekleri doğrulamak için OAuth 2.0’ı kullanıyordu. Bu süreci basitleştirmek amacıyla 1 Mart 2018’den itibaren API artık yalnızca API Anahtarları’nı kullanıyor ve sorgular için OAuth 2.0 kullanmıyor.
OAuth 2.0 ile doğrulama süreci şu şekildeydi:
- İstemci Kimliğinizi Yönetim Uygulamasından Alın.
- Erişim anahtarı almak için token uç noktasına istek gönderin.
- Erişim belirtecini istek başlığı içine koyun ve API’ye yönelik istekler göndermeye başlayın.
Sadece API Anahtarları ile bu süreç şu şekildedir:
- API Anahtarınızı Yönetim Sayfası’ndan alın.
- API Anahtarını istek başlığına ekleyin.
Artık erişim belirteci elde etmek için uç noktaya istek yapmanıza gerek yok. API anahtarınızın süresi dolmaz, bu yüzden yeni anahtarlar üretmekten endişelenmenize gerek yok.
Yelp Geliştirici API Dokümantasyonu
Yelp geliştirici sitesi, çalışma prensiplerini ve pratik kullanımı açıklayan pek çok Yelp API eğitimi içerir. Bunu burada bulabilirsiniz. Orada ayrıca uygulamalarınızı oluşturabilir ve Fusion API ile Yelp GraphQL – API’ler için bir sorgu dili – ile çalışabilirsiniz. Özel ortak API’leri dikkate alan kapsamlı geliştirici belgeleri Yelp Geliştirici Portalı’nda yer alıyor. Bu Reklam API’lerine, Rezervasyon API’lerine ve diğerlerine erişim ancak bir başvuru yaparak elde edilebilir.
SSS (Sık Sorulan Sorular)
Yelp platformunda çok sayıda iş verisi ve diğer öznitelikler mevcut; ancak Yelp geliştirici API belgelerinde listelenmiyorlar. Bu verilere nasıl erişilir?
Yelp, API üzerinden paylaştığı veri alanları konusunda son derece dikkatli. Eğer ilave Yelp verilerini kullanabilecek bir uygulama geliştiriyorsanız Fusion VIP programına başvurabilir ve durumunuzu Yelp ekibiyle paylaşabilirsiniz.
Yelp verisini ülkeye göre nasıl filtrelerim?
Yelp API’si, hizmetin mevcut olduğu tüm coğrafyalardan sonuçları getirir. Belirli bir şehir için sorgu sonuçlarını filtrelemek isterseniz, arama API’sini kullanırken konum parametresini kullandığınızdan emin olun.
Neden Yelp API, Yelp’te bulunabilen bazı işletmeleri göstermiyor?
Yelp API yalnızca kullanıcılar tarafından oluşturulan içerik eklenen işletmelere ilişkin bilgileri döndürür. Özellikle en az bir müşteri yorumu olması gerekir.
Bir API sorgusunda hangi yorumları görüntülemek istediğinize karar verebilir misiniz?
Yorumların sıralanması ve düzeni, güncellik, kullanıcı oyları ve diğer inceleme kalitesi faktörleriyle belirlenir; tüketicilerin bilinçli kararlar vermesine yardımcı olur. Yelp API’si herhangi bir alternatif veya elle seçilmiş inceleme alıntısını çekmek üzere yapılandırılamaz.
Daha Fazla API Çağrısı Nasıl Elde Edebİlirim?
Gerçek web sitesi veya uygulama kullanıcı trafiğine dayanarak ek API çağrıları yapılır; genellikle bir ürün yayımlandıktan sonra. Geliştirme aşamasında API çağrılarını en aza indirmek için Yelp verilerini 24 saate kadar önbelleğe alın ve işletme kimliklerini saklayın. API istemci kimliğiniz ile api@yelp.com adresine e-posta göndererek ürününüz veya entegrasyonunuz hakkında şirkete günlük istek sayısını net olarak belirtin.
