Apa itu Yelp API?
Yelp Fusion API memungkinkan pengguna untuk mendapatkan konten lokal dan ulasan pengguna dari jutaan bisnis di sektor perhotelan dan layanan di 32 negara. Konten Yelp dapat digunakan untuk keperluan pengembangan aplikasi dan situs web.
Bagaimana cara mendapatkan Kunci API Yelp?
Mendapatkan kunci Fusion API Anda cepat dan mudah. Untuk melakukannya, ikuti panduan API Yelp yang sederhana berikut.
- Langkah 1 – Buat Akun
Pertama, masuk ke Portal Pengembang Yelp dengan akun Yelp Anda yang ada atau buat akun baru
Anda bisa terus menggunakan layanan Yelp melalui akun Facebook, Google, atau Apple. Pilihan lainnya adalah mendaftar dengan alamat email Anda. Dalam hal ini Anda akan menerima email konfirmasi – jangan lupa ikuti tautan di dalamnya untuk memverifikasi akun Anda.
- Langkah 2 – Mulai dengan Fusion API
Setelah Anda masuk ke Layanan Pengembang Yelp, gulir ke bagian bawah halaman pertama dan tekan tombol Jelajahi Yelp Fusion.
Anda akan menuju ke bagian Fusion API di portal. Tekan tombol Mulai.
- Langkah 3 – Membuat Aplikasi
Buat Aplikasi Yelp Pertama Anda untuk menerima kunci API Fusion pribadi Anda. Isi kolom yang diperlukan dalam formulir, setujui Ketentuan Penggunaan Yelp API dan Persyaratan Tampilan. Kemudian buktikan Anda manusia, dan tekan Buat Aplikasi Yelp Baru.
Setelah itu Anda akan mendapatkan App ID dan API Key Anda. Simpan keduanya untuk mulai menggunakan aplikasi Anda.
Cara menggunakan Yelp API?
Ada beberapa jenis API, pada intinya dibagi menjadi solusi untuk usaha kecil hingga perusahaan, serta untuk bisnis menengah hingga besar dan calon mitra Yelp. Yang pertama termasuk Yelp Fusion API dan tersedia untuk semua orang secara gratis. Yang kedua memerlukan akses khusus, Anda harus mengajukan permohonan dan menunggu keputusan perusahaan.
Yelp Fusion API memungkinkan penggunanya mendapatkan konten lokal dan ulasan pengguna dari jutaan bisnis di sektor perhotelan dan layanan di 32 negara.
Konten Yelp dapat digunakan untuk pengembangan aplikasi dan situs web guna membantu pengguna Anda menemukan tempat terbaik dan penyedia layanan di wilayah tertentu, serta membandingkannya berdasarkan peringkat dan ulasan pelanggan. Yelp Fusion API menggunakan autentikasi kunci pribadi untuk mengautentikasi semua endpoint.
Harga dan Batasan
Semua solusi tersedia secara bebas untuk akses standar. Namun, ada batasan Yelp API untuk panggilan dengan kuota laju tambahan yang diberikan secara kasus-per-kasus. Artinya Anda perlu mengajukan permohonan dengan menjelaskan proyek Anda secara lengkap. Setelah itu, Anda akan menunggu keputusan mereka.
Yelp API memiliki beberapa jenis batasan. Yang pertama adalah Batas Kecepatan QPS (Queries-Per-Second). Jika Anda membuat kueri terhadap Yelp API terlalu cepat, Anda mungkin menerima kesalahan HTTP 429. Jika Anda melihat kesalahan itu secara teratur, cobalah untuk memperlambat laju permintaan API Anda.
Selain QPS, ada juga batas jumlah permintaan API per hari.
| Batas Permintaan Harian | Jumlah panggilan maksimum yang dapat dilakukan pengguna per hari |
| Sisa RateLimit | Jumlah panggilan yang tersisa untuk hari ini |
| Waktu Reset RateLimit | Waktu kedaluwarsanya jendela batas laju saat ini. |
Contoh API Yelp
- API Ulasan Yelp
Jenis kueri seperti ini adalah contoh Yelp Fusion API yang memberi kesempatan untuk menampilkan hingga tiga cuplikan ulasan untuk sebuah bisnis. Ada juga solusi Private Yelp Review API yang menyediakan cara bagi mitra Yelp yang disetujui untuk mengambil ulasan yang dapat dilihat publik di platform ini.
Untuk menampilkan jumlah ulasan bisnis Anda tanpa batas di situs Anda, gunakan widget Elfsight Yelp Reviews yang tersedia gratis!
- API Bisnis Yelp
Fusion API menyediakan rangkaian penuh endpoint bisnis yang mengembalikan konten bisnis secara rinci.
Berikut adalah endpoint dasar yang digunakan:
Nama Jalur Deskripsi Pencarian Bisnis /businesses/search Cari berdasarkan kata kunci, kategori, lokasi, tingkat harga, dll. Pencarian Nomor Telepon /businesses/search/phone Cari berdasarkan nomor telepon. Pencarian Transaksi /transactions/{transaction_type}/search Cari layanan yang mendukung transaksi pengantaran makanan. Detail Bisnis /businesses/{id} Dapatkan data bisnis lengkap, seperti nama, alamat, nomor telepon, foto, peringkat Yelp, tingkat harga, dan jam operasional. Pencocokan Bisnis /businesses/matches Temukan bisnis Yelp yang cocok dengan lokasi yang Anda masukkan secara tepat. - API Pencarian Yelp
Endpoint ini mengembalikan hingga 1.000 bisnis berdasarkan kriteria pencarian yang Anda berikan. Ini menampilkan beberapa informasi dasar tentang bisnis tersebut. Fusion Search API mencakup berbagai kategori, termasuk Seni, Kecantikan, Pendidikan, Keuangan, dan masih banyak lagi. Daftar lengkap kategori Yelp API dapat ditemukan di di sini. API tidak mengembalikan bisnis tanpa ulasan.
Perubahan Yelp API
Versi Yelp API yang saat ini berjalan adalah v3, yang menggantikan Yelp API v2 pada 2018.
Versi v2 menggunakan OAuth 2.0 untuk mengotentikasi permintaan ke API. Untuk menyederhanakan proses ini, mulai 1 Maret 2018 API beralih hanya ke kunci API dan tidak lagi menggunakan OAuth 2.0 untuk kueri.
Dengan OAuth 2.0, proses autentikasinya adalah:
- Dapatkan ID Klien Anda dari Kelola Aplikasi.
- Kirim permintaan ke endpoint token untuk mendapatkan token akses.
- Masukkan token akses ke header permintaan dan mulai mengirim permintaan ke API.
Proses ini hanya dengan Kunci API adalah:
- Dapatkan API Key Anda di halaman Pengelolaan Aplikasi.
- Masukkan API Key ke header permintaan.
Sekarang tidak perlu lagi mengirim permintaan ke endpoint untuk mendapatkan token akses. Kunci API Anda tidak kedaluwarsa, jadi Anda tidak perlu khawatir tentang membuat kunci baru.
Dokumentasi API Pengembang Yelp
Situs pengembang Yelp berisi berbagai tutorial API Yelp yang menjelaskan prinsip operasinya dan penggunaan praktisnya. Anda bisa menemukannya di di sini. Di sana Anda juga bisa membuat aplikasi dan bekerja dengan Fusion API serta Yelp GraphQL – bahasa kueri untuk API. Kumpulan lengkap dokumentasi pengembang terkait API mitra khusus ditampilkan di Portal Pengembang Yelp. Akses ke API Periklanan, API Reservasi, dan lainnya hanya bisa didapatkan dengan mengajukan permohonan.
Pertanyaan Umum
Banyak data bisnis dan atribut lain ada di platform Yelp, tetapi tidak tercantum dalam dokumentasi API pengembang Yelp. Bagaimana cara mengaksesnya?
Yelp sangat berhati-hati terhadap bidang data yang diekspos melalui API. Jika Anda sedang membangun aplikasi yang bisa memanfaatkan data Yelp tambahan, Anda bisa mengajukan Program Fusion VIP dan membagikan kasus Anda kepada tim Yelp.
Bagaimana cara memfilter data Yelp berdasarkan negara?
API Ulasan Yelp mengambil hasil dari semua wilayah tempat layanan tersedia. Jika Anda ingin menyaring hasil kueri Anda ke kota tertentu, pastikan untuk menggunakan parameter lokasi saat menggunakan API Pencarian.
Mengapa Yelp API tidak menampilkan beberapa bisnis yang bisa ditemukan di Yelp?
Yelp API hanya mengembalikan informasi untuk bisnis yang memiliki konten yang dibuat pengguna Yelp. Secara spesifik, mereka harus memiliki setidaknya satu ulasan pelanggan.
Bisakah saya memilih ulasan mana yang ditampilkan dalam kueri API?
Pengurutan ulasan ditentukan berdasarkan kebaruan, voting pengguna, dan faktor kualitas ulasan lainnya untuk membantu konsumen membuat keputusan yang tepat. API Yelp tidak bisa disetel untuk mengambil kutipan ulasan alternatif atau yang dipilih secara khusus.
Bagaimana saya bisa mendapatkan lebih banyak kuota API?
Permintaan API tambahan diberikan berdasarkan lalu lintas pengguna situs web atau aplikasi yang sebenarnya, biasanya setelah produk diluncurkan. Cobalah meminimalkan permintaan API selama tahap pengembangan Anda dengan menyimpan data Yelp dalam cache hingga 24 jam dan menyimpan ID bisnis. Anda dapat mengirim email ke [email protected] dengan Yelp API Client ID Anda dan memberi tahu perusahaan tentang produk atau integrasi Anda serta jumlah permintaan harian yang Anda harapkan untuk digunakan.
