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

Mengatur Tugas Pertanyaan dan Jawaban Google My Business Langsung

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 Pertanyaan dan Jawaban Google My Business Langsung

​

Pertanyaan dan jawaban pada sebuah Profil Bisnis Google, ditemukan menurut keyword dan location_code. Mengembalikan keyword, se_domain, location_code, language_code, check_url, datetime, cid, feature_id, dan item_types. Dibungkus dalam envelope DataForSEO: data ada di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200.

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 hasil di SERP
      nilai default: 20
      nilai maksimum: 100
      Akun Anda akan ditagih per setiap SERP yang berisi hingga 20 hasil;
      Menetapkan kedalaman di atas 20 dapat mengakibatkan biaya tambahan jika mesin pencari mengembalikan lebih dari 20 hasil;
      Jika kedalaman yang ditentukan lebih tinggi daripada jumlah pertanyaan dalam respons, selisihnya akan dikembalikan secara otomatis ke saldo akun Anda;
      Biaya dapat dihitung di halaman Harga.

    • keyword
      Tipe: string

      kata kunci
      field wajib
      kata kunci yang Anda tentukan harus menunjukkan nama usaha lokal
      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”;

      field ini juga dapat digunakan untuk meneruskan parameter berikut:
      cid - id unik entitas bisnis yang ditentukan Google;
      place_id - pengenal entitas bisnis di Google Maps;

      contoh:
      cid:194604053573767737
      place_id:GhIJQWDl0CIeQUARxks3icF8U8A

      pelajari lebih lanjut tentang pengenal cid dan place_id di artikel Pusat Bantuan ini

      pelajari lebih lanjut tentang aturan dan batasan field keyword dan keywords di API DataForSEO di artikel Pusat Bantuan ini

    • language_code
      Tipe: string

      kode bahasa mesin pencari
      field wajib jika Anda tidak menentukan language_name
      jika Anda menggunakan field ini, Anda tidak perlu menentukan language_name
      Anda dapat memperoleh daftar bahasa yang tersedia beserta language_code dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/business_data/google/languages
      contoh:
      en

    • language_name
      Tipe: string

      nama lengkap bahasa mesin pencari
      field wajib jika Anda tidak menentukan language_code
      jika Anda menggunakan field ini, Anda tidak perlu menentukan language_code
      Anda dapat memperoleh daftar bahasa yang tersedia dengan language_name dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/business_data/google/languages
      contoh:
      English

    • location_code
      Tipe: integer

      kode lokasi mesin pencari
      field wajib jika Anda tidak menentukan location_name atau location_coordinate
      jika Anda menggunakan field ini, Anda tidak perlu menentukan location_name atau location_coordinate
      Anda dapat memperoleh daftar lokasi yang tersedia beserta location_code dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/business_data/google/locations
      contoh:
      2840

    • location_coordinate
      Tipe: string

      koordinat GPS suatu lokasi
      field wajib jika Anda tidak menentukan location_name atau location_code
      jika Anda menggunakan field ini, Anda tidak perlu menentukan location_name atau location_code
      Parameter location_coordinate harus ditentukan dalam format "latitude,longitude,radius"
      jumlah maksimum digit desimal untuk "latitude" dan "longitude": 7
      nilai minimum untuk "radius": 199.9 (mm)
      nilai maksimum untuk "radius": 199999 (mm)
      contoh:
      53.476225,-2.243572,200

    • location_name
      Tipe: string

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

    • 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

Respons
  • 200
    Tipe: object | null · Response36Afe1097B20_BusinessDataGoogleQuestionsAndAnswersLiveResponseInfo
    • 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_BusinessDataGoogleQuestionsAndAnswersLiveTaskInfo
        • 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: array (object | null)[] | null

          array hasil

          • check_url
            Tipe: string | null

            URL langsung ke hasil mesin pencari
            Anda dapat menggunakannya untuk memastikan kami memberikan hasil yang akurat

          • cid
            Tipe: string | null

            client id yang ditentukan Google
            id unik suatu usaha lokal;
            pelajari lebih lanjut tentang pengenal di artikel pusat bantuan ini

          • datetime
            Tipe: string | null

            tanggal dan waktu saat hasil diterima
            dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
            misalnya:
            2019-11-15 12:57:46 +00:00

          • feature_id
            Tipe: string | null

            pengenal unik fitur SERP

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

            jenis item
            jenis hasil mesin pencari yang ditemui dalam array items;
            jenis item yang tersedia: google_business_question_item

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

            array item
            item dalam google_business_question_item

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

              array item
              item dalam google_business_question_item

              • answer_id
                Tipe: string | null

                ID jawaban

              • answer_text
                Tipe: string | null

                teks jawaban saat ini

              • original_answer_text
                Tipe: string | null

                teks asli jawaban

              • profile_image_url
                Tipe: string | null

                URL gambar profil pengguna

              • profile_name
                Tipe: string | null

                nama tampilan pengguna

              • profile_url
                Tipe: string | null

                URL profil pengguna

              • time_ago
                Tipe: string | null

                perkiraan waktu jawaban diposting

              • timestamp
                Tipe: string | null

                waktu persis jawaban diposting

              • type
                Tipe: string | null

                jenis elemen

            • original_question_text
              Tipe: string | null

              teks asli pertanyaan

            • profile_image_url
              Tipe: string | null

              URL gambar profil pengguna

            • profile_name
              Tipe: string | null

              nama tampilan pengguna

            • profile_url
              Tipe: string | null

              URL profil pengguna

            • question_id
              Tipe: string | null

              ID pertanyaan

            • question_text
              Tipe: string | null

              teks pertanyaan saat ini

            • rank_absolute
              Tipe: integer | null

              peringkat absolut di antara semua elemen

            • rank_group
              Tipe: integer | null

              posisi dalam grup elemen dengan nilai type yang identik
              posisi elemen dengan nilai type berbeda dihilangkan dari rank_group

            • time_ago
              Tipe: string | null

              perkiraan waktu saat pertanyaan diposting

            • timestamp
              Tipe: string | null

              waktu tepat saat pertanyaan diposting

            • type
              Tipe: string | null

              jenis elemen

            • url
              Tipe: string | null

              URL pertanyaan

          • items_count
            Tipe: integer | null Format: int64

            jumlah item dalam array items

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

            array item pertanyaan bisnis Google tanpa jawaban

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

              array item
              item dalam google_business_question_item

              • answer_id
                Tipe: string | null

                ID jawaban

              • answer_text
                Tipe: string | null

                teks jawaban saat ini

              • original_answer_text
                Tipe: string | null

                teks asli jawaban

              • profile_image_url
                Tipe: string | null

                URL gambar profil pengguna

              • profile_name
                Tipe: string | null

                nama tampilan pengguna

              • profile_url
                Tipe: string | null

                URL profil pengguna

              • time_ago
                Tipe: string | null

                perkiraan waktu jawaban diposting

              • timestamp
                Tipe: string | null

                waktu persis jawaban diposting

              • type
                Tipe: string | null

                jenis elemen

            • original_question_text
              Tipe: string | null

              teks asli pertanyaan

            • profile_image_url
              Tipe: string | null

              URL gambar profil pengguna

            • profile_name
              Tipe: string | null

              nama tampilan pengguna

            • profile_url
              Tipe: string | null

              URL profil pengguna

            • question_id
              Tipe: string | null

              ID pertanyaan

            • question_text
              Tipe: string | null

              teks pertanyaan saat ini

            • rank_absolute
              Tipe: integer | null

              peringkat absolut di antara semua elemen

            • rank_group
              Tipe: integer | null

              posisi dalam grup elemen dengan nilai type yang identik
              posisi elemen dengan nilai type berbeda dihilangkan dari rank_group

            • time_ago
              Tipe: string | null

              perkiraan waktu saat pertanyaan diposting

            • timestamp
              Tipe: string | null

              waktu tepat saat pertanyaan diposting

            • type
              Tipe: string | null

              jenis elemen

            • url
              Tipe: string | null

              URL pertanyaan

          • keyword
            Tipe: string | null

            kata kunci yang diterima dalam array POST
            kata kunci dikembalikan dengan %## yang didekode (karakter plus '+' akan didekode menjadi karakter spasi)
            field ini akan berisi parameter cid jika Anda menentukannya di field keyword saat menyetel tugas;
            contoh:
            cid:2946633002421908862
            pelajari lebih lanjut tentang parameter di artikel pusat bantuan ini

          • language_code
            Tipe: string | null

            kode bahasa dalam array POST

          • location_code
            Tipe: integer | null

            kode lokasi dalam array POST

          • se_domain
            Tipe: string | null

            domain mesin pencari seperti yang ditentukan dalam array POST

        • 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/google/questions_and_answers/live
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/questions_and_answers/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_name": "Los Angeles,California,United States",
    "keyword": "The Last Bookstore"
  }
]'

{
  "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": [
        {
          "keyword": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "cid": null,
          "feature_id": null,
          "item_types": [
            null
          ],
          "items_without_answers": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "question_id": null,
              "url": null,
              "profile_image_url": null,
              "profile_url": null,
              "profile_name": null,
              "question_text": null,
              "original_question_text": null,
              "time_ago": null,
              "timestamp": null,
              "items": [
                "[Max Depth Exceeded]"
              ]
            }
          ],
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "question_id": null,
              "url": null,
              "profile_image_url": null,
              "profile_url": null,
              "profile_name": null,
              "question_text": null,
              "original_question_text": null,
              "time_ago": null,
              "timestamp": null,
              "items": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Operasi berhasil

Setting Live Google My Business Questions and Answers Tasks