Felo API PlatformFelo API Platform
Semua endpoint DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Mengatur Tugas Ulasan Tripadvisor Business Data

Felo API Support
MIT
Server:https://openapi.felo.ai
Pustaka Klien
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operasi

Mengatur Tugas Ulasan Tripadvisor Business Data

​

Mengantrekan ulasan Tripadvisor untuk satu properti, mengembalikan id tugas. Dibungkus dalam envelope DataForSEO: data ada di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Ambil dengan get_dataforseo_business_tripadvisor_reviews_fetch; padanan Trustpilot adalah post_dataforseo_business_trustpilot_reviews_submit.

Referensi harga

  • Pengukuran: biaya respons yang dilaporkan.
  • Perkiraan referensi per permintaan: USD 0,2428.
  • Pengali referensi pelanggan: 1,0. Jangan menerapkannya lagi pada jumlah tagihan pelanggan yang telah diselesaikan.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukan kredit Felo. Biaya akhir mengikuti catatan penagihan Felo.

Isi
application/json
  • Tipe: array (object | null)[]
    • depth
      Tipe: integer | null

      kedalaman parsing
      field opsional
      jumlah ulasan di SERP;
      kami sangat menyarankan menetapkan kedalaman parsing dalam kelipatan sepuluh, karena sistem kami memproses sepuluh ulasan berturut-turut;
      nilai default: 10;
      nilai maksimum: 4490
      Akun Anda akan ditagih per setiap SERP yang berisi hingga 10 hasil;
      Menetapkan kedalaman di atas 10 dapat mengakibatkan biaya tambahan jika mesin pencari mengembalikan lebih dari 10 hasil;
      Biaya dapat dihitung di halaman Harga.

    • keyword
      Tipe: string

      kata kunci
      field wajib jika Anda tidak menentukan url_path
      kata kunci yang Anda tentukan harus menunjukkan nama bisnis atau tempat terkenal yang ada di Tripadvisor;
      Anda dapat menentukan hingga 700 karakter di field keyword;
      semua %## akan didekode (karakter ‘+’ juga akan didekode menjadi karakter spasi);
      jika Anda perlu menggunakan karakter “%” untuk keyword, tentukan sebagai “%25”

    • language_code
      Tipe: string | null

      kode bahasa mesin pencari
      field opsional
      jika Anda menggunakan field ini, akun Anda akan dikenai biaya satu permintaan tambahan
      Anda dapat memperoleh daftar bahasa yang tersedia dengan language_code dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/business_data/tripadvisor/languages
      contoh:
      en
      Anda akan dikenai biaya tambahan untuk menetapkan parameter bahasa di endpoint ini.
      Biaya dapat dihitung di halaman Harga.

    • language_name
      Tipe: string | null

      nama lengkap bahasa mesin pencari
      field opsional
      jika Anda menggunakan field ini, akun Anda akan dikenai biaya satu permintaan tambahan
      Anda dapat memperoleh daftar bahasa yang tersedia dengan language_name dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/business_data/tripadvisor/languages
      contoh:
      English
      Anda akan dikenai biaya tambahan untuk menetapkan parameter bahasa di endpoint ini.
      Biaya dapat dihitung di halaman Harga.

    • location_code
      Tipe: integer

      kode lokasi mesin pencari
      field wajib jika Anda tidak menentukan location_name atau url_path
      Anda dapat memperoleh daftar lokasi yang tersedia dengan location_code dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/business_data/tripadvisor/locations
      contoh:
      1003854

    • location_name
      Tipe: string

      nama lengkap lokasi mesin pencari
      field wajib jika Anda tidak menentukan location_code atau url_path
      Anda dapat memperoleh daftar lokasi yang tersedia dengan location_name dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/business_data/tripadvisor/locations
      contoh:
      London,England,United Kingdom

    • months
      Tipe: array string[] | null

      filter berdasarkan bulan saat pelancong melakukan kunjungan
      field opsional
      nilai yang mungkin: january, february, march, april, may, april, june, july, august, september, october, november, december
      Anda dapat menentukan beberapa nilai sekaligus

    • pingback_url
      Tipe: string | null

      URL notifikasi tugas yang selesai
      field opsional
      saat tugas selesai, kami akan memberi tahu Anda melalui permintaan GET yang dikirim ke URL yang Anda tentukan
      Anda dapat menggunakan string ‘$id’ sebagai variabel $id dan ‘$tag’ sebagai variabel $tag berenkode URL. Kami akan menyetel nilai yang diperlukan sebelum mengirim permintaan.
      contoh:
      http://your-server.com/pingscript?id=$id
      http://your-server.com/pingscript?id=$id&tag=$tag
      Catatan: karakter khusus dalam pingback_url akan dienkode URL;
      yaitu, karakter # akan dienkode menjadi %23

      pelajari lebih lanjut di Pusat Bantuan kami

    • postback_url
      Tipe: string | null

      URL untuk mengirim hasil tugas
      field opsional
      setelah tugas selesai, kami akan mengirim permintaan POST dengan hasilnya yang dikompresi dalam format gzip ke postback_url yang Anda tentukan
      Anda dapat menggunakan string ‘$id’ sebagai variabel $id dan ‘$tag’ sebagai variabel $tag berenkode URL. Kami akan menyetel nilai yang diperlukan sebelum mengirim permintaan.
      contoh:
      http://your-server.com/postbackscript?id=$id
      http://your-server.com/postbackscript?id=$id&tag=$tag
      Catatan: karakter khusus dalam postback_url akan dienkode URL;
      yaitu, karakter # akan dienkode menjadi %23

      pelajari lebih lanjut di Pusat Bantuan kami

    • priority
      Tipe: integer | null

      prioritas tugas
      field opsional
      dapat mengambil nilai berikut:
      1 – prioritas eksekusi normal (ditetapkan secara default)
      2 – prioritas eksekusi tinggi Anda akan dikenai biaya tambahan untuk tugas dengan prioritas eksekusi tinggi.
      Biaya dapat dihitung di halaman Harga.

    • ratings
      Tipe: array string[] | null

      rating pelancong Tripadvisor untuk tempat menarik
      field opsional
      rating berdasarkan ulasan tertulis oleh pelancong setelah mereka mengunjungi suatu tempat.
      nilai yang mungkin: excellent, very_good, average, poor, terrible
      Anda dapat menentukan beberapa nilai sekaligus

    • sort_by
      Tipe: string | null

      parameter pengurutan hasil
      field opsional
      Anda dapat menggunakan field ini untuk mengurutkan hasil;
      jenis pengurutan yang mungkin:
      most_recent
      detailed_reviews

    • tag
      Tipe: string | null

      pengenal tugas yang ditentukan pengguna
      field opsional
      batas karakter adalah 255
      Anda dapat menggunakan parameter ini untuk mengidentifikasi tugas dan mencocokkannya dengan hasil
      Anda akan menemukan nilai tag yang ditentukan di objek data pada respons

    • translate_reviews
      Tipe: boolean | null

      terjemahkan ulasan sesuai jalur URL
      field opsional
      jika disetel ke true, ulasan yang dikembalikan akan diterjemahkan ke bahasa yang cocok dengan url_path yang ditentukan;
      misalnya, jika url_path berisi tripadvisor.it dan translate_reviews adalah true, ulasan akan diterjemahkan ke bahasa Italia;
      nilai default: true
      Anda dapat mempelajari lebih lanjut tentang cara ulasan diterjemahkan di artikel Pusat Bantuan ini

    • url_path
      Tipe: string

      jalur URL entitas bisnis
      field wajib jika Anda tidak menentukan keyword
      jalur URL ke halaman Tripadvisor entitas bisnis;
      contoh:
      Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html
      https://www.tripadvisor.com/Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html

    • visit_type
      Tipe: array string[] | null

      filter berdasarkan jenis pelancong yang meninggalkan ulasan
      field opsional
      nilai yang mungkin: families, couples, solo, business, friends
      Anda dapat menentukan beberapa nilai sekaligus

Respons
  • 200
    Tipe: object | null · Response36Afe1097B20_BusinessDataTripadvisorReviewsTaskPostResponseInfo
    • cost
      Tipe: number | null Format: double

      total biaya tugas, USD

    • status_code
      Tipe: integer | null

      kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini

    • status_message
      Tipe: string | null

      pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

    • tasks
      Tipe: array (object | null)[] | null

      array tugas

      • Tipe: object | null · Response36Afe1097B20_BusinessDataTripadvisorReviewsTaskPostTaskInfo
        • cost
          Tipe: number | null Format: double

          total biaya tugas, USD

        • data
          Tipe: object | null

          berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST

          • propertyName
            Tipe: object | null
        • id
          Tipe: string | null

          pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID

        • path
          Tipe: array (string | null)[] | null

          Jalur URL

        • result
          Tipe: object | null

          array hasil
          dalam kasus ini, nilainya akan menjadi null

        • result_count
          Tipe: integer | null Format: int64

          jumlah elemen dalam array hasil

        • status_code
          Tipe: integer | null

          kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000; Anda dapat menemukan daftar lengkap kode respons di sini

        • status_message
          Tipe: string | null

          pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

        • time
          Tipe: string | null

          waktu eksekusi, detik

    • tasks_count
      Tipe: integer | null Format: int64

      jumlah tugas dalam array tasks

    • tasks_error
      Tipe: integer | null Format: int64

      jumlah tugas dalam array tasks yang dikembalikan dengan error

    • time
      Tipe: string | null

      total waktu eksekusi, detik

    • version
      Tipe: string | null

      versi API saat ini

    application/json
  • 400

    Permintaan tidak dapat diproses. Periksa parameter permintaan.

  • 401

    Kunci API Felo yang valid diperlukan.

  • 402

    Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.

  • 403

    Akun tidak diizinkan melakukan operasi ini.

  • 429

    Batas permintaan atau batas pengeluaran telah tercapai.

  • 502

    Layanan tidak dapat menyelesaikan permintaan.

  • 503

    API atau layanan penagihan untuk sementara tidak tersedia.

  • 504

    Layanan kehabisan waktu saat memproses permintaan.

  • default

    Respons error; respons passthrough upstream dapat menggunakan format penyedia

    application/json
Request Example for post/v1/beta/dataforseo/business_data/tripadvisor/reviews/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/tripadvisor/reviews/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "url_path": "Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html",
    "location_code": 1003854,
    "pingback_url": "https://your-server.com/pingback.php?id=$id&tag=$tag",
    "tag": "some_string_123"
  }
]'

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": null
    }
  ]
}

Operasi berhasil

Setting Business Data Tripadvisor Reviews Tasks